Strona głównaDokumentacja

Integracja z serwerem 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 umożliwiający asystentom AI interakcję z usługami zewnętrznymi i źródłami danych. Dzięki integracji MCP w ChatReact możesz:

  • Zarządzać chatbotami — aktualizować instrukcje, osobowość i ustawienia widgetu
  • Tworzyć i aktualizować FAQ używając języka naturalnego
  • Przeglądać analitykę, historię czatów i leady
  • Przeglądać propozycje Improvement Agent oraz zatwierdzać lub odrzucać je
  • Monitorować sesje czatu na żywo oraz kolejkę oczekujących

Rozpoczęcie

1. Wygeneruj klucz API

  1. Przejdź do swojego DashboardCompany → zakładka API
  2. Kliknij Create API Key
  3. Nadaj kluczowi opisową nazwę (np. "Claude Desktop") i wybierz przynajmniej jedno uprawnienie
  4. Skopiuj wygenerowany klucz (zaczyna się od cr_)

Klucze API są dostępne w planach płatnych — zobacz naszą Pricing page.

Przechowuj swój klucz API w bezpiecznym miejscu. Nie można go odzyskać po utworzeniu.

2. Skonfiguruj klienta MCP

Serwer MCP ChatReact jest hostowany pod adresem https://www.chatreact.ai/api/mcp i komunikuje się przez HTTP (JSON-RPC). Uwierzytelniaj się za pomocą nagłówka Authorization: Bearer — akceptowany jest także nagłówek X-API-Key z tym samym kluczem.

Cursor IDE

Cursor obsługuje zdalne serwery MCP bezpośrednio. Dodaj do ustawień MCP w Cursor:

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

Claude Desktop

Plik konfiguracyjny Claude Desktop obsługuje serwery oparte na poleceniach, więc użyj standardowego mostka mcp-remote, aby połączyć się z hostowanym punktem końcowym:

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

{
  "mcpServers": {
    "chatreact": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.chatreact.ai/api/mcp",
        "--header",
        "X-API-Key:cr_your_api_key_here"
      ]
    }
  }
}

Ta konfiguracja wymaga zainstalowanego Node.js. Przykład używa nagłówka X-API-Key, ponieważ niektóre klienty mają problemy z obsługą spacji w argumentach.

3. Zrestartuj asystenta AI

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

Dostępne narzędzia

ChatReact MCP udostępnia kompleksowy zestaw narzędzi zorganizowanych w kategorie:

Twoje konto

ToolDescription
user_profilePobierz informacje o swoim profilu
user_companiesWyświetl firmę, do której przypisany jest Twój klucz API
user_notificationsPobierz swoje ostatnie powiadomienia

Zarządzanie firmą i zespołem

ToolDescription
company_listWyświetl firmę, do której przypisany jest Twój klucz API
company_getPobierz szczegóły konkretnej firmy
company_members_listWyświetl członków firmy wraz z ich rolami
company_chatbots_listWyświetl wszystkie chatboty dla firmy
company_updateZaktualizuj nazwę firmy, opis lub ustawienia

Zarządzanie chatbotem

ToolDescription
chatbot_listWyświetl listę wszystkich chatbotów z podsumowaniem statystyk
chatbot_getPobierz szczegóły i konfigurację chatbota
chatbot_get_instructionsPobierz główne instrukcje dla chatbota
chatbot_add_instructionDodaj nową główną instrukcję
chatbot_update_instructionZaktualizuj istniejącą główną instrukcję
chatbot_delete_instructionUsuń główną instrukcję
chatbot_update_personalityZaktualizuj ton, język i wiadomości
chatbot_toggle_activeAktywuj lub dezaktywuj chatbota
chatbot_toggle_learningWłącz lub wyłącz fazę uczenia się
widget_settings_getPobierz bieżące ustawienia widgetu
widget_settings_updateZaktualizuj wygląd widgetu (kolory, rozmiar, pozycja)

Zarządzanie FAQ

ToolDescription
faq_listWyświetl wszystkie FAQ dla chatbota
faq_getPobierz szczegóły FAQ
faq_createUtwórz nowe FAQ
faq_updateZaktualizuj istniejące FAQ
faq_deleteUsuń FAQ
faq_categories_listWyświetl kategorie FAQ
faq_suggestions_listWyświetl oczekujące sugestie FAQ wygenerowane z rozmów czatowych

Baza wiedzy

ToolDescription
knowledge_documents_listWyświetl dokumenty w bazie wiedzy chatbota
knowledge_document_getPobierz szczegóły konkretnego dokumentu
knowledge_document_deleteUsuń dokument z bazy wiedzy
knowledge_statsPobierz statystyki bazy wiedzy

Crawling stron internetowych jest zarządzany z poziomu dashboardu — zobacz Knowledge Base.

Zarządzanie leadami

ToolDescription
lead_listWyświetl leady z opcjonalnym filtrowaniem po statusie lub kategorii
lead_getPobierz pełne szczegóły leada, w tym źródłową sesję czatu
lead_updateZaktualizuj status, kategorię lub notatki leada
lead_deleteTrwale usuń leada
lead_categories_listWyświetl kategorie leadów
lead_statsPobierz statystyki leadów, w tym liczniki według statusu
lead_field_config_getPobierz konfigurację pól przechwytywania leadów

Historia czatu

ToolDescription
chat_sessions_listWyświetl sesje czatu z opcjonalnymi filtrami
chat_session_getPobierz sesję czatu ze wszystkimi wiadomościami
chat_session_searchWyszukaj sesje czatu według treści wiadomości lub informacji o odwiedzającym

Analityka

ToolDescription
analytics_overviewPobierz liczby czatów, liczby wiadomości i wskaźniki satysfakcji
analytics_chat_volumePobierz wolumen czatów w czasie do wykresów i analiz trendów

Improvement Agent

ToolDescription
improvement_sessions_listWyświetl sesje poprawy
improvement_session_getPobierz szczegóły sesji, w tym propozycje
improvement_proposals_pendingWyświetl oczekujące propozycje oczekujące na przegląd
improvement_proposal_approveZatwierdź propozycję i zastosuj zmianę
improvement_proposal_rejectOdrzuć propozycję

Czat na żywo

ToolDescription
live_chat_sessions_listWyświetl sesje czatu na żywo
live_chat_session_getPobierz sesję czatu na żywo ze wszystkimi wiadomościami
live_chat_queuePobierz sesje oczekujące na agenta

Narzędzia czatu na żywo są tylko do odczytu. Aby rozmawiać bezpośrednio z odwiedzającymi, użyj dashboardu Live Chat.

Przykładowe scenariusze

Dodawanie głównej instrukcji

Poproś swojego asystenta AI:

"Dodaj główną instrukcję do mojego chatbota 'Support Bot': oferujemy darmową wysyłkę przy zamówieniach powyżej €50"

Asystent użyje chatbot_add_instruction z odpowiednimi parametrami.

Przeglądanie sugestii ulepszeń

"Pokaż mi wszystkie oczekujące propozycje ulepszeń dla mojego chatbota i wyjaśnij, jakie zmiany sugerują"

Asystent wykona:

  1. Użyje improvement_proposals_pending, aby pobrać propozycje
  2. Przeanalizuje i podsumuje każdą sugestię
  3. Zatwierdzi lub odrzuci je w Państwa imieniu za pomocą improvement_proposal_approve lub improvement_proposal_reject

Analiza wydajności czatu

"Daj mi tygodniowy raport dotyczący wolumenu czatów i satysfakcji klientów dla mojego chatbota"

Asystent użyje analytics_overview oraz analytics_chat_volume, aby przygotować kompleksowy raport.

Bezpieczeństwo

  • Klucze API są przypisane do Państwa firmy
  • Klucze można unieważnić w dowolnym momencie z poziomu dashboardu
  • Dostęp API jest dostępny w planach płatnych — zobacz naszą Pricing page

Rozwiązywanie problemów

Połączenie nie powiodło się

  1. Zweryfikuj, czy Twój klucz API jest poprawny
  2. Sprawdź, czy klucz nie został unieważniony
  3. Upewnij się, że Państwa plan obejmuje dostęp do API
  4. Zrestartuj klienta MCP

Narzędzie nie znalezione

Zrestartuj klienta MCP po zmianie konfiguracji, aby ponownie załadował dostępne narzędzia. Nazwy narzędzi są pisane małymi literami z podkreśleniami (np. faq_list).


Potrzebują Państwo pomocy? Skontaktuj się z naszym zespołem wsparcia →