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
- Przejdź do swojego Dashboard → Company → zakładka API
- Kliknij Create API Key
- Nadaj kluczowi opisową nazwę (np. "Claude Desktop") i wybierz przynajmniej jedno uprawnienie
- 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
| Tool | Description |
|---|---|
user_profile | Pobierz informacje o swoim profilu |
user_companies | Wyświetl firmę, do której przypisany jest Twój klucz API |
user_notifications | Pobierz swoje ostatnie powiadomienia |
Zarządzanie firmą i zespołem
| Tool | Description |
|---|---|
company_list | Wyświetl firmę, do której przypisany jest Twój klucz API |
company_get | Pobierz szczegóły konkretnej firmy |
company_members_list | Wyświetl członków firmy wraz z ich rolami |
company_chatbots_list | Wyświetl wszystkie chatboty dla firmy |
company_update | Zaktualizuj nazwę firmy, opis lub ustawienia |
Zarządzanie chatbotem
| Tool | Description |
|---|---|
chatbot_list | Wyświetl listę wszystkich chatbotów z podsumowaniem statystyk |
chatbot_get | Pobierz szczegóły i konfigurację chatbota |
chatbot_get_instructions | Pobierz główne instrukcje dla chatbota |
chatbot_add_instruction | Dodaj nową główną instrukcję |
chatbot_update_instruction | Zaktualizuj istniejącą główną instrukcję |
chatbot_delete_instruction | Usuń główną instrukcję |
chatbot_update_personality | Zaktualizuj ton, język i wiadomości |
chatbot_toggle_active | Aktywuj lub dezaktywuj chatbota |
chatbot_toggle_learning | Włącz lub wyłącz fazę uczenia się |
widget_settings_get | Pobierz bieżące ustawienia widgetu |
widget_settings_update | Zaktualizuj wygląd widgetu (kolory, rozmiar, pozycja) |
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_suggestions_list | Wyświetl oczekujące sugestie FAQ wygenerowane z rozmów czatowych |
Baza wiedzy
| Tool | Description |
|---|---|
knowledge_documents_list | Wyświetl dokumenty w bazie wiedzy chatbota |
knowledge_document_get | Pobierz szczegóły konkretnego dokumentu |
knowledge_document_delete | Usuń dokument z bazy wiedzy |
knowledge_stats | Pobierz statystyki bazy wiedzy |
Crawling stron internetowych jest zarządzany z poziomu dashboardu — zobacz Knowledge Base.
Zarządzanie leadami
| Tool | Description |
|---|---|
lead_list | Wyświetl leady z opcjonalnym filtrowaniem po statusie lub kategorii |
lead_get | Pobierz pełne szczegóły leada, w tym źródłową sesję czatu |
lead_update | Zaktualizuj status, kategorię lub notatki leada |
lead_delete | Trwale usuń leada |
lead_categories_list | Wyświetl kategorie leadów |
lead_stats | Pobierz statystyki leadów, w tym liczniki według statusu |
lead_field_config_get | Pobierz konfigurację pól przechwytywania leadów |
Historia czatu
| Tool | Description |
|---|---|
chat_sessions_list | Wyświetl sesje czatu z opcjonalnymi filtrami |
chat_session_get | Pobierz sesję czatu ze wszystkimi wiadomościami |
chat_session_search | Wyszukaj sesje czatu według treści wiadomości lub informacji o odwiedzającym |
Analityka
| Tool | Description |
|---|---|
analytics_overview | Pobierz liczby czatów, liczby wiadomości i wskaźniki satysfakcji |
analytics_chat_volume | Pobierz wolumen czatów w czasie do wykresów i analiz trendów |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Wyświetl sesje poprawy |
improvement_session_get | Pobierz szczegóły sesji, w tym propozycje |
improvement_proposals_pending | Wyświetl oczekujące propozycje oczekujące na przegląd |
improvement_proposal_approve | Zatwierdź propozycję i zastosuj zmianę |
improvement_proposal_reject | Odrzuć propozycję |
Czat na żywo
| Tool | Description |
|---|---|
live_chat_sessions_list | Wyświetl sesje czatu na żywo |
live_chat_session_get | Pobierz sesję czatu na żywo ze wszystkimi wiadomościami |
live_chat_queue | Pobierz 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:
- Użyje
improvement_proposals_pending, aby pobrać propozycje - Przeanalizuje i podsumuje każdą sugestię
- Zatwierdzi lub odrzuci je w Państwa imieniu za pomocą
improvement_proposal_approvelubimprovement_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ę
- Zweryfikuj, czy Twój klucz API jest poprawny
- Sprawdź, czy klucz nie został unieważniony
- Upewnij się, że Państwa plan obejmuje dostęp do API
- 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 →