Integracja serwera MCP

ChatReact implementuje Model Context Protocol (MCP), umożliwiając połączenie konta ChatReact z asystentami AI takimi jak Claude Desktop, Cursor oraz innymi narzędziami zgodnymi z MCP.

Czym jest MCP?

Model Context Protocol to otwarty standard pozwalający asystentom AI na interakcję z zewnętrznymi usługami i źródłami danych. Dzięki integracji MCP w ChatReact może Pan/Pani:

zarządzać chatbotami bezpośrednio z poziomu asystenta AI
tworzyć i aktualizować FAQ przy użyciu języka naturalnego
przeglądać analizy i historię czatów
kontrolować Improvement Agent w celu optymalizacji chatbotów
obsługiwać sesje czatu na żywo bez wychodzenia z narzędzia AI

Rozpoczęcie pracy

1. Wygeneruj klucz API

Proszę przejść do Dashboard → Settings → API Keys
Kliknij Create API Key
Nadaj kluczowi opisową nazwę (np. "Claude Desktop")
Skopiuj wygenerowany klucz (zaczyna się od cr_)

Przechowaj klucz API w bezpiecznym miejscu. Nie można go odzyskać po utworzeniu.

2. Skonfiguruj klienta MCP

Claude Desktop

Dodaj następujące do pliku konfiguracyjnego Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Cursor IDE

Dodaj do ustawień Cursor MCP:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Lokalny rozwój (stdio)

Do lokalnego rozwoju może Pan/Pani użyć naszego pakietu npm:

npm install -g @chatreact/mcp

Skonfiguruj w Państwa kliencie MCP:

{
  "mcpServers": {
    "chatreact": {
      "command": "chatreact-mcp",
      "args": ["--api-key", "cr_your_api_key_here"]
    }
  }
}

3. Zrestartuj swojego asystenta AI

Po zapisaniu konfiguracji proszę zrestartować Claude Desktop lub Cursor, aby nawiązać połączenie.

Dostępne narzędzia

ChatReact MCP udostępnia ponad 30 narzędzi zorganizowanych w kategorie:

Zarządzanie firmą i zespołem

Tool	Description
`company_list`	Wyświetl listę wszystkich firm, do których masz dostęp
`company_get`	Pobierz szczegóły konkretnej firmy
`company_team_list`	Wyświetl członków zespołu danej firmy

Zarządzanie chatbotem

Tool	Description
`chatbot_list`	Wyświetl listę wszystkich chatbotów w firmie
`chatbot_get`	Pobierz szczegóły i konfigurację chatbota
`chatbot_create`	Utwórz nowego chatbota
`chatbot_update`	Zaktualizuj ustawienia chatbota
`chatbot_get_instructions`	Pobierz podstawowe instrukcje dla chatbota
`chatbot_add_instruction`	Dodaj nową podstawową instrukcję

Zarządzanie FAQ

Tool	Description
`faq_list`	Wyświetl wszystkie FAQ dla chatbota
`faq_get`	Pobierz szczegóły FAQ
`faq_create`	Utwórz nowe FAQ
`faq_update`	Zaktualizuj istniejące FAQ
`faq_delete`	Usuń FAQ
`faq_categories_list`	Wyświetl kategorie FAQ
`faq_suggest`	Wygeneruj propozycje FAQ sugerowane przez AI

Baza wiedzy

Tool	Description
`knowledge_list_documents`	Wyświetl przesłane dokumenty
`knowledge_list_websites`	Wyświetl przeszukane witryny
`knowledge_crawl_website`	Rozpocznij crawl witryny
`knowledge_get_crawl_status`	Sprawdź postęp crawlowania

Analityka

Tool	Description
`analytics_overview`	Pobierz ogólne metryki wydajności
`analytics_chat_volume`	Pobierz wolumen czatów w czasie
`analytics_feedback`	Pobierz opinie i oceny
`analytics_chat_history`	Przeglądaj sesje czatowe
`analytics_get_session`	Pobierz szczegółowe dane sesji

Improvement Agent

Tool	Description
`improvement_list_sessions`	Wyświetl sesje poprawy
`improvement_start_session`	Rozpocznij nową sesję analizy
`improvement_list_proposals`	Wyświetl propozycje usprawnień
`improvement_get_proposal`	Pobierz szczegóły propozycji
`improvement_create_proposal`	Utwórz niestandardową propozycję
`improvement_simulate_proposal`	Podejrzyj efekty propozycji
`improvement_apply_proposal`	Zastosuj propozycję
`improvement_reject_proposal`	Odrzuć propozycję

Live Chat

Tool	Description
`livechat_get_queue`	Pobierz oczekujące sesje czatowe
`livechat_get_active_sessions`	Wyświetl aktywne sesje obsługiwane przez agentów
`livechat_get_session`	Pobierz szczegóły sesji
`livechat_assign_session`	Przypisz sesję do siebie
`livechat_send_message`	Wyślij wiadomość jako agent
`livechat_close_session`	Zamknij sesję czatu
`livechat_check_availability`	Sprawdź dostępność agentów

Przykładowe scenariusze

Tworzenie nowego chatbota

Poproś swojego asystenta AI:

"Create a new chatbot called 'Support Bot' for my company 'acme-corp' with a friendly, professional tone"

Asystent użyje chatbot_create z odpowiednimi parametrami.

Przeglądanie sugestii ulepszeń

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

Asystent wykona następujące kroki:

Użyje improvement_list_proposals, aby pobrać propozycje
Przeanalizuje i podsumuje każdą sugestię
Pomoże Państwu zdecydować, które zastosować

Analiza wydajności czatów

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

Asystent użyje analytics_overview i analytics_feedback, aby sporządzić kompleksowy raport.

Bezpieczeństwo

Klucze API są przypisane do konta użytkownika i dostępu do firmy
Wszystkie żądania są rejestrowane w ścieżce audytu
Klucze można w każdej chwili unieważnić z poziomu dashboardu
Obowiązują limity: 60 żądań/minutę

Rozwiązywanie problemów

Połączenie nieudane

Zweryfikuj, czy Twój klucz API jest poprawny
Sprawdź, czy klucz nie został unieważniony
Upewnij się, że masz aktywne połączenie z internetem
Zrestartuj klienta MCP

Narzędzie nie znalezione

Niektóre narzędzia wymagają określonych uprawnień. Upewnij się, że masz odpowiednią rolę w firmie (Owner, Admin lub Manager).

Ograniczenie liczby żądań (Rate Limited)

Jeśli pojawią się błędy związane z limitem, odczekaj minutę przed ponowną próbą. Rozważ grupowanie operacji, gdy to możliwe.

Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia →