MCP Server Integration
ChatReact implementuje Model Context Protocol (MCP), co pozwala połączyć konto 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 zewnętrznymi usługami i źródłami danych. Dzięki integracji MCP w ChatReact można:
- Zarządzać chatbotami — tworzyć, konfigurować (persona, języki, widget, zachowanie, ograniczenia), osadzać i usuwać chatboty
- Budować bazę wiedzy — dodawać dokumenty, indeksować witryny, zarządzać zaindeksowanymi stronami i głównymi instrukcjami
- Zarządzać FAQ — FAQ, kategorie, sugestie, tłumaczenia i widget FAQ
- Przeglądać rozmowy — oceniać konwersacje, przypisywać kategorie zaufania, uruchamiać Improvement Agent
- Pracować z leadami i formularzami — leady, kategorie leadów, ustawienia capture, formularze kontaktowe i zgłoszenia
- Działać jako agent czatu na żywo — ustawiać dostępność, przejmować oczekujące czaty, odpowiadać i zamykać sesje
- Administrować firmą — profil, kolory marki, członkowie zespołu i zaproszenia
- Korzystać z Email Assistant — połączenia skrzynek, kategorie, kontakty i aktywność
- Odczytywać analitykę i powiadomienia
Wszystko, co jest możliwe w panelu, jest dostępne przez MCP (i REST API); jedynie akcje wymagające przeglądarki, takie jak płatności, OAuth skrzynek, passkeys, usuwanie konta oraz zarządzanie kluczami API pozostają w panelu.
Rozpoczęcie
1. Wygeneruj klucz API
- Przejdź do swojego Panel → Firma → API zakładki
- Kliknij Utwórz klucz API
- 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ą stronę Pricing.
Przechowuj klucz API w bezpiecznym miejscu. Nie można go odzyskać po utworzeniu.
2. Skonfiguruj klienta MCP
Serwer MCP ChatReact jest hostowany pod https://www.chatreact.ai/api/mcp i komunikuje się przez HTTP (JSON-RPC). Uwierzytelniaj się nagłówkiem 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 Cursorze:
{
"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, dlatego użyj standardowego mostka mcp-remote, aby połączyć się z hostowanym endpointem:
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 nie obsługują spacji w argumentach w sposób niezawodny.
3. Uruchom ponownie asystenta AI
Po zapisaniu konfiguracji zrestartuj Claude Desktop lub Cursor, aby nawiązać połączenie.
Dostępne narzędzia
ChatReact MCP udostępnia poniższe narzędzia pogrupowane według obszaru. Kolumna Scope pokazuje, które uprawnienie klucza API jest wymagane przez dane narzędzie (any = każdy ważny klucz). Narzędzia działają z tymi samymi właściwymi uprawnieniami, limitami planu i efektami ubocznymi, jakie występują w operacjach panelu. Workflowy związane z płatnościami, autoryzacją skrzynek, passkeys, usuwaniem konta i zarządzaniem kluczami pozostają w panelu.
Narzędzia destrukcyjne (usuń, zresetuj, zamknij, scal) wymagają potwierdzenia w Dashboard Assistant. Przy wywołaniach z klucza API wykonują się natychmiast.
Konto
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Pobierz aktualny plan (tier, status), liczniki użycia za bieżący okres rozliczeniowy (companies, chatbots, team members, chats, tokens) oraz limity planu, a także efektywne limity i flagi funkcji firmy, do której odnosi się wywołanie. | any |
user_companies | Wypisz wszystkie firmy, do których obecny użytkownik ma dostęp, wraz z rolą użytkownika w każdej z nich. | any |
user_notification_mark_read | Oznacz jedno z powiadomień obecnego użytkownika jako przeczytane. | any |
user_notification_preferences_get | Pobierz preferencje powiadomień obecnego użytkownika: globalne przełączniki email/push, częstotliwość/pora/dzień tygodnia/strefa czasowa digestu, "quiet hours" oraz ustawienia kanałów per typ. | any |
user_notification_preferences_update | Zaktualizuj globalne preferencje powiadomień obecnego użytkownika (przełączniki email/push, harmonogram digestu, quiet hours). | any |
user_notification_type_setting_update | Włącz lub wyłącz dostarczanie email / in-app dla pojedynczego typu powiadomień obecnego użytkownika (np. | any |
user_notification_types_list | Wypisz wszystkie typy powiadomień pogrupowane według kategorii (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Pobierz liczbę nieprzeczytanych powiadomień obecnego użytkownika. | any |
user_notifications | Wypisz powiadomienia obecnego użytkownika, najnowsze pierwsze, z paginacją kursora. | any |
user_notifications_delete_old | Porządkowanie: trwale usuń powiadomienia obecnego użytkownika, które są już przeczytane i starsze niż 30 dni. | any |
user_notifications_mark_all_read | Oznacz wszystkie powiadomienia obecnego użytkownika jako przeczytane. | any |
user_profile | Pobierz profil obecnego użytkownika (id, name, email, role, subscription tier). | any |
Firma i zespół
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Wypisz wszystkie chatboty dla określonej firmy z podsumowującymi statystykami. | chatbots:read |
company_get | Pobierz szczegółowe informacje o firmie: profil, owner, ustawienia marki (kolory, email powiadomień) i liczniki. | any |
company_invite_cancel | Anuluj (usuń) zaproszenie do zespołu, aby link przestał działać. | company:write |
company_invite_resend | Ponownie wyślij oczekujące zaproszenie do zespołu: wydaje nowy token, przedłuża wygasanie o 7 dni i wysyła email ponownie. | company:write |
company_invites_list | Wypisz zaproszenia do zespołu w firmie (domyślnie pending; ustaw includeExpired, aby również zwrócić wygasłe). | company:read |
company_list | Wypisz wszystkie firmy, do których użytkownik ma dostęp (klucze API i Dashboard Assistant widzą tylko swoją firmę). | any |
company_logo_remove | Usuń logo firmy (usuwa przechowywany obraz i czyści URL logo). | company:write |
company_member_invite | Zaproś członka zespołu przez email z rolą (ADMIN, MANAGER, AGENT lub VIEWER). | company:write |
company_member_remove | Usuń członka zespołu z firmy. | company:write |
company_member_update_role | Zmień rolę członka zespołu (ADMIN, MANAGER, AGENT lub VIEWER). | company:write |
company_members_list | Wypisz członków firmy z ich rolami (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Zaktualizuj ustawienia marki firmy: primaryColor / secondaryColor (#RRGGBB) oraz notificationEmail dla przeglądu rozmów. | company:write |
company_update | Zaktualizuj profil firmy: name (2-100 znaków), description (max 1000 znaków) lub website (https:// jest dodawane automatycznie; przekaż pusty łańcuch, aby wyczyścić website/description). | company:write |
Zarządzanie chatbotem
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Dodaj nową główną instrukcję do chatbota (1-5000 znaków). | chatbots:write |
chatbot_confirm_embed | Oznacz chatbota jako osadzonego na stronie (ukrywa przypomnienie o konfiguracji w panelu). | chatbots:write |
chatbot_create | Utwórz nowego chatbota (tak jak kreator w panelu). | chatbots:write |
chatbot_delete | Trwale usuń chatbota wraz ze wszystkimi FAQ, dokumentami, rozmowami, leadami i formularzami (nieodwracalne). | chatbots:write |
chatbot_delete_instruction | Usuń główną instrukcję z chatbota. | chatbots:write |
chatbot_get | Pobierz szczegółowe informacje o chatbocie: ustawienia ogólne, osobowość (persona, tonality, languages, restrictions), ustawienia widgetu, live chat, learning phase, status embed i liczniki. | chatbots:read |
chatbot_get_embed_code | Pobierz fragment HTML do instalacji chatbota na stronie (URL skryptu + <script> tag) oraz informację, czy osadzenie zostało potwierdzone. | chatbots:read |
chatbot_get_instructions | Pobierz wszystkie główne instrukcje dla chatbota. | chatbots:read |
chatbot_improve_instructions | Przepisz tekst głównej instrukcji za pomocą AI platformy (tak jak opcja 'Improve with AI' w panelu). | chatbots:write |
chatbot_learning_phase_get | Pobierz ustawienia fazy uczenia chatbota: preset zachowania (CAUTIOUS, BALANCED, CONFIDENT), niestandardowy prompt i czy bot nadal jest w fazie uczenia. | chatbots:read |
chatbot_learning_phase_update | Ustaw preset zachowania fazy uczenia (CAUTIOUS = odwołuj do człowieka, gdy niepewny; BALANCED, CONFIDENT) i/lub niestandardowy prompt fazy uczenia. | chatbots:write |
chatbot_list | Wypisz wszystkie chatboty, do których użytkownik ma dostęp, z podsumowującymi statystykami. | chatbots:read |
chatbot_reorder_instructions | Ustaw kolejność głównych instrukcji chatbota. | chatbots:write |
chatbot_templates_list | Wypisz szablony chatbotów (presety dla persona, tonality, messages i zachowania widgetu), które można przekazać jako templateId do chatbot_create, oraz informację, czy plan firmy może ich użyć. | chatbots:read |
chatbot_toggle_active | Aktywuj lub dezaktywuj chatbota. | chatbots:write |
chatbot_toggle_learning | Zakończ (false) lub ponownie włącz (true) fazę uczenia chatbota. | chatbots:write |
chatbot_update | Zaktualizuj ustawienia ogólne chatbota: name, description, isActive, live chat (liveChatEnabled/liveChatMode, funkcja planu), showBranding (plany white-label), emaile do przeglądu rozmów, automatyczne generowanie FAQ, legacy coreInstructions text, faza uczenia (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Zaktualizuj istniejącą główną instrukcję (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Zaktualizuj osobowość chatbota: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), suwaki tonality 1-5, języki (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), wiadomości (welcomeMessage, fallbackMessage, proactive greeting) oraz ograniczenia (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Pobierz aktualne ustawienia widgetu dla chatbota (wszystkie wygląd, branding, zachowanie i pola formularza przedczatowego). | chatbots:read |
widget_settings_update | Zaktualizuj widget czatu chatbota: pozycja (w tym | chatbots:write |
widget_translations_get | Pobierz tłumaczenia widgetu per język dla chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Ustaw tłumaczenia widgetu per język. | chatbots:write |
Baza wiedzy
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Anuluj zlecenie crawla o statusie PENDING lub RUNNING; pozostałe strony zostaną pominięte. | knowledge:write |
crawler_job_get | Pobierz status zadania crawla, postęp (pagesCrawled/pagesFound, tokensUsed) oraz status każdej strony. | knowledge:read |
crawler_jobs_list | Wypisz zadania crawla chatbota (najnowsze pierwsze) z statusem i postępem. | knowledge:read |
crawler_limits | Pobierz limity crawla dla planu chatbota (max stron na crawl, tokeny na stronę, crawle na miesiąc) i czy można uruchomić nowy crawl w tym miesiącu. | knowledge:read |
crawler_preview_scan | Skanuj witrynę i wypisz jej strony możliwe do crawlowania (url, title, isRecommended) bez importowania czegokolwiek. | knowledge:write |
crawler_start | Rozpocznij zadanie crawla, które importuje wybrane URL-e do bazy wiedzy chatbota (przetwarzane w tle; sondować crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Pobierz dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) z publicznego URL http(s) i dodaj go do bazy wiedzy chatbota. | knowledge:write |
knowledge_document_add_text | Dodaj dokument tekstowy lub markdown do bazy wiedzy chatbota z zawartości inline (max 10 MB). | knowledge:write |
knowledge_document_delete | Usuń przesłany dokument z bazy wiedzy. | knowledge:write |
knowledge_document_get | Pobierz szczegóły przesłanego dokumentu, w tym status przetwarzania, komunikat o błędzie oraz krótkotrwały URL do pobrania. | knowledge:read |
knowledge_documents_list | Wypisz przesłane dokumenty (PDF, TXT, MD, CSV, JSON, DOCX) w bazie wiedzy chatbota z ich statusem i rozmiarem. | knowledge:read |
knowledge_page_add | Przeskanuj pojedynczy URL i dodaj go do bazy wiedzy chatbota (zwraca CONFLICT gdy URL jest już zindeksowany, FORBIDDEN gdy osiągnięto limit tokenów). | knowledge:write |
knowledge_page_delete | Usuń zaindeksowaną stronę z bazy wiedzy (usuwa jej plik vector-store). | knowledge:write |
knowledge_page_get | Pobierz zaindeksowaną stronę wraz z zawartością markdown, która została zindeksowana dla chatbota (przydatne do weryfikacji, co bot wie o stronie). | knowledge:read |
knowledge_page_recrawl | Ponownie pobierz zaindeksowaną stronę i zastąp jej zindeksowaną zawartość (np. | knowledge:write |
knowledge_pages_delete | Usuń kilka zaindeksowanych stron chatbota naraz. | knowledge:write |
knowledge_pages_list | Wypisz zaindeksowane strony w bazie wiedzy chatbota, opcjonalnie filtrowane po domenie, statusie lub wyszukiwanym terminie (URL/title). | knowledge:read |
knowledge_stats | Przegląd bazy wiedzy chatbota: dokumenty (wg statusu, rozmiaru), zaindeksowane strony i witryny (wg statusu), zadania crawla, główne instrukcje rozdzielone wg źródła (manual vs improvement agent), FAQ, status/rozmiar vector store i zużycie przestrzeni vs. | knowledge:read |
knowledge_website_delete | Usuń wszystkie zaindeksowane strony danej witryny (domeny) z bazy wiedzy chatbota. | knowledge:write |
knowledge_website_recrawl | Ponownie przeskanuj wszystkie strony witryny (domeny) w bazie wiedzy chatbota, aby odświeżyć jej zawartość. | knowledge:write |
knowledge_website_recrawl_cancel | Anuluj trwający re-crawl witryny: strony w kolejce (PENDING) dla domeny zostaną przywrócone do poprzedniego zindeksowanego stanu. | knowledge:write |
knowledge_websites_list | Wypisz witryny (domeny), których strony znajdują się w bazie wiedzy chatbota, z liczbą stron wg statusu i sumami tokenów. | knowledge:read |
Zarządzanie cenami
Te narzędzia zarządzają ustrukturyzowanymi szkicami cen i jawnych zatwierdzeń. Zapisanie szkicu jest oddzielne od zatwierdzenia konkretnej wersji; uprawnienia zależą także od statusu i ważności. Istniejące klucze API nie otrzymują automatycznie uprawnień do cen. Tylko owner firmy może nadawać prices:write lub prices:approve. Wywołania z klucza API wykonują się natychmiast, więc przed wywołaniem mutacji sprawdź dokładnie przekazywane dane. Zobacz Prices & services dla workflow klienta.
| Tool | Description | Scope |
|---|---|---|
price_list | Stronicowanie nagłówków cen i oddzielna weryfikacja uprawnień zatwierdzonej wersji. | prices:read |
price_get | Odczyt pełnego stanu pozycji i rewizji. | prices:read |
price_detail | Odczyt szczegółów pozycji z paginowaną historią rewizji. | prices:read |
price_suggestions_list | Stronicowanie sugestii cen. | prices:read |
price_create | Utwórz szkic z serwerowo wygenerowanym ID pozycji. | prices:write |
price_edit | Utwórz nowy szkic z wyraźnie oczekiwaną wersją pozycji. | prices:write |
price_import_csv | Importuj szkice z określonym formatem i stabilnym import ID dla bezpiecznych ponowień. | prices:write |
price_suggestion_apply | Zastosuj wybranego kandydata sugestii jako szkic. | prices:write |
price_approve | Zatwierdź jedną wyraźnie oczekiwaną wersję pozycji. | prices:approve |
price_approve_many | Atomowe zatwierdzenie wyboru ID/wersji; każda przeterminowana wersja odrzuca cały wybór. | prices:approve |
price_archive | Zarchiwizuj pozycję w jej wyraźnie oczekiwanej wersji. | prices:approve |
Edycje szkiców zachowują poprzednią zatwierdzoną rewizję. Format CSV i separator dziesiętny muszą być jawne; zmieniona zawartość CSV wymaga nowego import ID. Wszystkie operacje są powiązane z firmą klucza API i wskazanym chatbotem.
Zarządzanie FAQ
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Wyczyść pamięć podręczną danych widgetu FAQ na wszystkich powiązanych witrynach CMS (wtyczka WordPress). | faqs:write |
faq_categories_list | Wypisz kategorie FAQ chatbota z liczbą FAQ, slugami, trybem sortowania i tłumaczeniami. | faqs:read |
faq_categories_reorder | Ustaw kolejność kategorii FAQ w widgetcie: pozycja w categoryIds staje się sortOrder. | faqs:write |
faq_category_create | Utwórz kategorię FAQ dla chatbota (slug generowany z nazwy). | faqs:write |
faq_category_delete | Usuń kategorię FAQ. | faqs:write |
faq_category_translations_update | Zastąp tłumaczenia kategorii FAQ, np. | faqs:write |
faq_category_update | Zmień nazwę kategorii FAQ lub opisu, ikony albo trybu sortowania. | faqs:write |
faq_create | Utwórz FAQ dla chatbota. | faqs:write |
faq_delete | Trwale usuń FAQ (również usuwa je z bazy wiedzy chatbota i czyści pamięć podręczną widgetu CMS). | faqs:write |
faq_embed_code_get | Pobierz fragmenty do osadzenia widgetu FAQ: tag skryptu, shortcode WordPress i snippet Shopify Liquid, oraz warianty per kategoria (użyj categorySlug z faq_categories_list, aby osadzić tylko jedną kategorię). | chatbots:read |
faq_get | Pobierz pełne szczegóły FAQ: pytanie, odpowiedź, kategoria, status publikacji, sort order, tłumaczenia, pola SEO i statystyki feedbacku. | faqs:read |
faq_list | Wypisz FAQ chatbota (użyj chatbot_list, aby znaleźć chatbotId). | faqs:read |
faq_reorder | Ustaw kolejność wyświetlania FAQ w widgetcie. | faqs:write |
faq_suggestion_approve | Zatwierdź SUGGESTED FAQ o statusie PENDING: tworzy opublikowane FAQ (opcjonalnie z edytowanym pytaniem/odpowiedzią/kategorią) i oznacza sugestię jako APPROVED. | faqs:write |
faq_suggestion_get | Pobierz pełne szczegóły sugestii FAQ (pełna odpowiedź, AI reasoning, sugerowana kategoria, stan przeglądu). | faqs:read |
faq_suggestion_reject | Odrzuć sugestię FAQ o statusie PENDING z opcjonalnym powodem. | faqs:write |
faq_suggestions_generate | Pozwól AI zaproponować nowe FAQ z bazy wiedzy chatbota (zaindeksowane strony / przesłane dokumenty), opcjonalnie dla jednej kategorii. | faqs:write |
faq_suggestions_list | Wypisz sugestie FAQ wygenerowane przez AI dla chatbota (z rozmów lub faq_suggestions_generate). | faqs:read |
faq_translate | Przetłumacz pytanie i odpowiedź FAQ za pomocą AI na inne wspierane języki chatbota (lub na podane targetLanguages) i zapisz wynik. | faqs:write |
faq_translations_update | Zapisz tłumaczenia FAQ per język, np. | faqs:write |
faq_update | Zaktualizuj pytanie, odpowiedź, kategorię, status publikacji lub ręczny sort order FAQ. | faqs:write |
faq_widget_settings_get | Pobierz ustawienia wyglądu i zachowania osadzanego widgetu FAQ (kolory, border radius, tytuł, odstępy, max width, allowMultipleOpen, autoOpenFirst, sort mode, tłumaczenia tytułu). | chatbots:read |
faq_widget_settings_update | Zaktualizuj ustawienia widgetu FAQ: kolory (hex), borderRadius 0-32, tytuł (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = pełna szerokość), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name oraz tłumaczenia tytułu per język. | chatbots:write |
Historia czatów i feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Oznacz rozmowę jako przejrzaną bez oceniania jej (usuwa z kolejki pending, nie zmienia confidence score). | chats:write |
chat_feedback_get | Pobierz jedno review czatu (feedback) z analizą AI, severity, kategorią zaufania, zmianą score i powiązaną sesją improvement. | chats:read |
chat_feedback_list | Wypisz recenzje czatów (wiersze feedbacku) chatbota z filtrem statusu i licznikami. | chats:read |
chat_feedback_set_severity | Nadpisz klasyfikację severity (MINOR|MODERATE|MAJOR|CRITICAL) przejrzanej negatywnej rozmowy; severity wpływa na wagę spadku confidence-score. | chats:write |
chat_feedback_stats | Liczniki sesji per bucket recenzji dla chatbota (total, none, pending, positive, negative, reviewed, improved) — karty statystyk strony chats w panelu. | chats:read |
chat_feedback_submit | Oceń sesję czatu jako Good (isPositive=true) lub Needs Work (isPositive=false). | chats:write |
chat_session_get | Pobierz sesję czatu z pełnym transkryptem (per-message token/model/latency/pageUrl), danymi odwiedzającego, URL-em strony startowej, kategorią zaufania, feedbackiem (severity, analiza AI, powiązana sesja improvement) i tagami. | chats:read |
chat_session_search | Przeszukaj sesje czatu chatbota po treści wiadomości i/lub emailu odwiedzającego. | chats:read |
chat_session_set_category | Przypisz lub zmień kategorię zaufania sesji czatu (koryguje klasyfikację AI; per-kategoria confidence jest przeliczane, gdy rozmowa była review'owana). | chats:write |
chat_sessions_list | Wypisz sesje czatu chatbota, najnowsze pierwsze, z tymi samymi filtrami kolejki przeglądu co strona chats w panelu. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Wypisz kategorie zaufania chatbota z per-kategorią confidence score, liczbą recenzji i częstotliwością emaili przeglądowych. | chats:read |
confidence_category_create | Utwórz kategorię zaufania dla chatbota. | chatbots:write |
confidence_category_delete | Usuń kategorię zaufania. | chatbots:write |
confidence_category_merge | Scal jedną kategorię zaufania do innej w tym samym chatbocie: wszystkie rozmowy/recenzje przenoszą się do celu, źródło jest usuwane, a wyniki są przeliczane. | chatbots:write |
confidence_category_update | Zmień nazwę kategorii zaufania i/lub ustaw częstotliwość emaili przeglądowych (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 tylko dla HOURLY). | chatbots:write |
confidence_status_get | Status zaufania chatbota: score, próg graduacji, flaga fazy uczenia, zachowanie fazy uczenia (CAUTIOUS|BALANCED|CONFIDENT) i niestandardowy prompt, liczniki recenzji i per-kategorię confidence scores. | analytics:read |
improvement_proposal_approve | Zatwierdź sugestię improvement o statusie PENDING i zastosuj zmianę w chatbotcie (dodanie/aktualizacja core instruction, utworzenie/aktualizacja FAQ lub aktualizacja persony) — ta sama logika i limity planu co w panelu. | chatbots:write |
improvement_proposal_reject | Odrzuć sugestię improvement o statusie PENDING. | chatbots:write |
improvement_proposal_simulate | Zasimuluj, jak chatbot odpowiedziałby na problematyczną wiadomość po zastosowaniu propozycji (oryginalnie vs. | chatbots:write |
improvement_proposals_pending | Wypisz propozycje improvement oczekujące na przegląd (status PENDING) w całej firmie lub dla jednego chatbota. | chatbots:read |
improvement_session_complete | Oznacz sesję improvement jako COMPLETED (rozmowa wtedy liczy się jako Improved w kolejce przeglądu). | chatbots:write |
improvement_session_create | Otwórz Improvement Agent dla rozmowy ocenionej jako Needs Work. | chatbots:write |
improvement_session_get | Pobierz sesję improvement z oryginalną rozmową (wiadomości mają indeks 1-based użyteczny jako targetMessageIndex), konwersacją agenta, wszystkimi propozycjami (z ich najnowszą symulacją) i symulacjami. | chatbots:read |
improvement_session_reset | Restartuj sesję improvement: usuwa wszystkie wiadomości agenta, symulacje i propozycje o statusie PENDING/REJECTED (zastosowane propozycje pozostają) i rozpoczyna nową konwersację. | chatbots:write |
improvement_session_send_message | Wyślij wiadomość do Improvement Agent (opisz, co było nie tak z odpowiedzią bota; opcjonalnie targetMessageIndex = indeks 1-based wiadomości bota w originalChat.messages). | chatbots:write |
improvement_sessions_list | Wypisz sesje improvement (konwersacje Improvement Agent rozpoczęte z negatywnych recenzji czatów) dla chatbota lub całej firmy, najnowsze pierwsze, z liczbą propozycji. | chatbots:read |
improvement_simulation_assess | Oceń wynik symulacji: isApproved=true gdy symulowana odpowiedź jest dobra (propozycję można wtedy zastosować), false gdy wymaga dalszej pracy (komentarz 'almost' = prawie dobrze). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Pobierz własną dostępność do live chat użytkownika, agentów aktualnie dostępnych do live chat (świeży heartbeat, ten sam sygnał, którego używa widget) oraz informację, czy plan firmy obejmuje live chat. | chats:read |
live_chat_heartbeat | Odśwież heartbeat obecnego użytkownika dla obecności live chat (tylko gdy oznaczony jako dostępny poprzez live_chat_set_availability). | chats:write |
live_chat_message_send | Wyślij wiadomość do odwiedzającego jako przypisany agent. | chats:write |
live_chat_queue | Pobierz kolejkę live chat: sesje czekające na agenta, najstarsze pierwsze (FIFO). | chats:read |
live_chat_session_assign | Przejmij sesję live chat o statusie WAITING z kolejki: przypisuje ją do obecnego użytkownika (owner firmy dla kluczy API) i powiadamia odwiedzającego, że agent dołączył. | chats:write |
live_chat_session_close | Zakończ sesję live chat jako agent (każdy członek firmy nie będący VIEWEREM). | chats:write |
live_chat_session_get | Pobierz sesję live chat z informacjami odwiedzającego, przypisanym agentem, wszystkimi wiadomościami i wcześniejszą rozmową bota (handoff context). | chats:read |
live_chat_sessions_list | Wypisz sesje live chat (najnowsze pierwsze; sesje WAITING najstarsze pierwsze) z opcjonalnymi filtrami po chatbocie, statusie i przypisanym agencie. | chats:read |
live_chat_set_availability | Przełącz własny przełącznik 'Available for Live Chat' obecnego użytkownika dla firmy. | chats:write |
Leady
| Tool | Description | Scope |
|---|---|---|
lead_assign | Przypisz lead do członka firmy lub usuń przypisanie (assignedToId: null). | leads:write |
lead_bulk_update_status | Ustaw status kilku leadów jednocześnie (max 100). | leads:write |
lead_categories_list | Wypisz kategorie leadów chatbota z liczbami leadów i członkami zespołu powiadamianymi per kategoria. | leads:read |
lead_category_assign_user | Dodaj członka firmy do listy powiadomień kategorii leadów (lub zaktualizuj jego flagi powiadomień). | leads:write |
lead_category_create | Utwórz kategorię leadów dla chatbota. | leads:write |
lead_category_delete | Usuń kategorię leadów. | leads:write |
lead_category_remove_user | Usuń członka firmy z listy powiadomień kategorii leadów. | leads:write |
lead_category_update | Zaktualizuj nazwę, opis i/lub kolor kategorii leadów. | leads:write |
lead_create | Utwórz lead ręcznie (np. | leads:write |
lead_delete | Trwale usuń lead. | leads:write |
lead_field_config_get | Pobierz konfigurację capture leadów dla chatbota: pola (ids mapują się do kluczy w lead.data), komunikat potwierdzający, tłumaczenia pól/UI i ustawienia rozpoznawania AI. | leads:read |
lead_field_config_update | Zaktualizuj konfigurację capture leadów chatbota. | leads:write |
lead_get | Pobierz pełne szczegóły leada, w tym przypisanego, kategorię i źródłowy transkrypt rozmowy (paginowany z messageOffset/messageLimit, domyślnie pierwsze 20 wiadomości). | leads:read |
lead_list | Wypisz leady chatbota (najnowsze pierwsze) z opcjonalnymi filtrami po statusie, kategorii, przypisanym i wyszukiwaniu tekstowym (name/email/company). | leads:read |
lead_stats | Pobierz statystyki leadów dla chatbota: liczby wg statusu, leady z ostatnich 7 dni i wskaźnik konwersji (procent). | leads:read |
lead_update | Zaktualizuj status, kategorię, notatki, przechwycone dane i/lub przypisanego leada. | leads:write |
Formularze
| Tool | Description | Scope |
|---|---|---|
form_create | Utwórz formularz kontaktowy dla chatbota (podstawy, pola, wygląd i ustawienia antyspamowe w jednym wywołaniu). | forms:write |
form_delete | Trwale usuń formularz kontaktowy i WSZYSTKIE jego zgłoszenia (kaskadowo). | forms:write |
form_get | Pobierz formularz kontaktowy w całości: pola, tłumaczenia, styl, ustawienia antyspamowe, stan aktywny, liczba zgłoszeń oraz embed script tag (embedCode). | forms:read |
form_list | Wypisz formularze kontaktowe chatbota z liczbą pól, liczbą zgłoszeń i embed code'ami. | forms:read |
form_stats | Liczniki zgłoszeń formularza kontaktowego: total, pending, approved, spam i rejected. | forms:read |
form_submission_delete | Trwale usuń zgłoszenie formularza kontaktowego (np. | forms:write |
form_submission_get | Pobierz zgłoszenie formularza kontaktowego w całości: przesłane dane pól, spam score i analiza antyspam AI, metadata IP/user agent/referrer oraz informacje o przeglądzie. | forms:read |
form_submission_update_status | Przejrzyj zgłoszenie formularza kontaktowego: ustaw jego status na APPROVED, SPAM lub REJECTED z opcjonalną notatką recenzji. | forms:write |
form_submissions_list | Wypisz zgłoszenia formularza kontaktowego, najnowsze pierwsze, opcjonalnie filtrowane po statusie (PENDING, APPROVED, SPAM, REJECTED) i dacie utworzenia. | forms:read |
form_update | Zaktualizuj formularz kontaktowy: name, description, stan aktywny (isActive kontroluje, czy embed się renderuje), pola (pełna zamiana), wygląd (kolory, tekst przycisku, komunikat sukcesu) i ustawienia antyspamowe (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Zastąp tłumaczenia pól i/lub UI formularza kontaktowego. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Wypisz dziennik aktywności przetwarzanych emaili połączenia skrzynki (najnowsze pierwsze): nadawca, temat, przypisana kategoria, wynik (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) oraz outcomeDetail. | email:read |
email_categories_list | Wypisz kategorie emaili połączenia skrzynki (posortowane wg sortOrder). | email:read |
email_category_create | Utwórz kategorię email dla połączenia skrzynki (max 20 na połączenie). | email:write |
email_category_delete | Usuń kategorię email. | email:write |
email_category_update | Zaktualizuj kategorię email (częściowo: zmieniają się tylko podane pola). | email:write |
email_connection_disconnect | Trwale rozłącz skrzynkę. | email:write |
email_connection_get | Pobierz połączenie skrzynki incl. | email:read |
email_connection_update | Zaktualizuj połączenie skrzynki: wstrzymaj/wznów synchronizację (paused true/false; tylko przełącza ACTIVE<->DISABLED, nigdy nie nadpisuje TOKEN_EXPIRED/ERROR), przełącz draftowanie odpowiedzi (draftingEnabled) i kategoryzowanie/organizowanie (organizingEnabled), zmień napędzającego chatbota (chatbotId z tej samej firmy) lub ustaw HTML sygnatury odpowiedzi (signatureHtml, max 20000 znaków; pusty łańcuch czyści ją). | email:write |
email_connections_list | Wypisz połączenia skrzynek Email Assistant firmy (address, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, last sync, last error, przełączniki drafting/organizing, powering chatbot, draftReadyCategoryCount = kategorie mogące wygenerować szkice, baseRuleCount = reguły "Chat + Email" stosowane do każdego szkicu) wraz z limitami planu (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Usuń zapamiętany kontakt email (zapomnij profil nadawcy, np. | email:write |
email_contact_get | Pobierz zapamiętany kontakt email ze wszystkimi zapamiętanymi faktami, notatkami wewnętrznymi, relacją, ustawieniem formy zwracania się formal/informal i statystykami email. | email:read |
email_contact_update | Zaktualizuj zapamiętany kontakt email. | email:write |
email_contacts_list | Wypisz zapamiętane kontakty email firmy (najnowsze emaile pierwsze) z relacją, formal/informal address (formalAddress: true = formalne 'Sie', false = nieformalne 'Du', null = automatyczne), liczbą faktów i podglądem notatek. | email:read |
email_folder_create | Utwórz folder pocztowy pod inboxem (zwraca istniejący, jeśli nazwa jest zajęta) do użycia jako cel przenoszenia kategorii. | email:write |
email_folders_list | Wypisz foldery, do których może przenosić kategoria email (na żywo z skrzynki): podfoldery inbox, niestandardowe foldery najwyższego poziomu, archive, junk i trash (id 'deleteditems'). | email:read |
email_general_rules_list | Wypisz reguły obowiązujące dla każdego szkicu odpowiedzi skrzynki: aktywne core instructions z kanałem BOTH ("Chat + Email"), plus legacy email-only jeszcze nie zmigrowane do kategorii. | email:read |
Analityka
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Wolumen czatów (uruchomione sesje) w czasie do wykresów i trendów: okres week/month/quarter/year, granularność hour/day/week/month, opcjonalnie dla jednego chatbota. | analytics:read |
analytics_chatbot_stats | Wydajność per chatbot firmy w jednym wywołaniu (tabela wydajności chatbotów w panelu): id, name, slug, isActive, sessions, messages, FAQs i leads per chatbot, posortowane wg sessions. | analytics:read |
analytics_forms | Statystyki zgłoszeń formularzy kontaktowych dla firmy lub jednego chatbota (widget analityczny panelu): zgłoszenia wg statusu (pending/approved/rejected/spam), liczba formularzy, total, spam rate w procentach i seria submissions-per-day z ostatnich 7 dni. | analytics:read |
analytics_leads | Lejek leadów dla firmy lub jednego chatbota (widget analityczny panelu): leady wg statusu (new/contacted/qualified/converted/lost), total, wskaźnik konwersji w procentach i seria leads-per-day z ostatnich 7 dni. | analytics:read |
analytics_overview | Przegląd analityki dla firmy lub jednego chatbota: rozmowy, wiadomości, wskaźnik satysfakcji i top pytania dla okresu ruchomego (day/week/month/year), plus widget przeglądu panelu (total chatbots/published FAQs/leads, sessions today/this week/this month, leads today/this week, form submissions total/today/pending). | analytics:read |
dashboard_activity | Co wymaga obecnie uwagi (widok główny panelu): per firma, chatboty z nowymi leadami dzisiaj, pending FAQ suggestions, pending form submissions, oczekujące/aktywne live chats lub trwająca faza uczenia. | any |
Przykładowe workflowy
Dodawanie głównej instrukcji
Poproś asystenta AI:
"Add a core instruction to my 'Support Bot' chatbot: we offer free shipping on orders over €50"
Asystent użyje chatbot_add_instruction z odpowiednimi parametrami.
Przeglądanie sugestii improvement
"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"
Asystent:
- Użyje
improvement_proposals_pending, aby pobrać propozycje - Przeanalizuje i podsumuje każdą sugestię
- Zatwierdzi lub odrzuci je w Państwa imieniu przy pomocy
improvement_proposal_approvelubimprovement_proposal_reject
Analiza wydajności czatu
"Give me a weekly report of chat volume and customer satisfaction for my chatbot"
Asystent użyje analytics_overview i analytics_chat_volume, aby przygotować kompleksowy raport.
Importowanie witryny
"Scan https://example.com, import the product and pricing pages into my 'Support Bot' and tell me when the crawl is done"
Asystent wywoła crawler_preview_scan, wybierze odpowiednie strony, rozpocznie import za pomocą crawler_start i będzie sondować crawler_job_get aż zadanie się zakończy.
Przegląd leadów i zgłoszeń formularzy
"Show me the new leads from this week, assign the qualified ones to Anna and approve the pending contact form submissions"
Asystent łączy lead_list, lead_assign, form_submissions_list i form_submission_update_status.
Przejęcie live chatu
"Set me available for live chat and take the oldest waiting conversation"
Asystent użyje live_chat_set_availability, live_chat_queue i live_chat_session_assign; odpowiedzi przechodzą przez live_chat_message_send.
Bezpieczeństwo
- Klucze API są ograniczone do Państwa firmy oraz zakresów uprawnień, które wybierzecie podczas ich tworzenia (zobacz kolumnę Scope powyżej)
- Klucze wykonują się z uprawnieniami ownera firmy; limity planu i bramki funkcji obowiązują dokładnie tak samo jak w panelu
- Klucze można unieważnić w dowolnym momencie z poziomu panelu
- Dostęp API jest dostępny w planach płatnych — zobacz naszą stronę Pricing
Rozwiązywanie problemów
Połączenie nie powiodło się
- Sprawdź, czy Twój klucz API jest poprawny
- Upewnij się, że klucz nie został unieważniony
- Sprawdź, czy Państwa plan obejmuje dostęp do API
- Zrestartuj klienta MCP
Narzędzie nie znalezione
Zrestartuj klienta MCP po zmianie konfiguracji, aby przeładował dostępne narzędzia. Nazwy narzędzi są pisane małymi literami z podkreśleniami (np., faq_list).
Potrzebujecie pomocy? Skontaktuj się z naszym zespołem wsparcia →