MCP Server Integration
A ChatReact megvalósítja a Model Context Protocol (MCP) protokollt, amely lehetővé teszi, hogy a ChatReact fiókját olyan AI asszisztensekhez csatlakoztassa, mint a Claude Desktop, Cursor és egyéb MCP-kompatibilis eszközök.
Mi az MCP?
A Model Context Protocol egy nyílt szabvány, amely lehetővé teszi az AI asszisztensek számára, hogy külső szolgáltatásokkal és adatforrásokkal kommunikáljanak. A ChatReact MCP integrációjával Ön képes:
- Csevegőbotok kezelése — csevegőbotok létrehozása, konfigurálása (persona, nyelvek, widget, viselkedés, korlátozások), beágyazása és törlése
- Tudásbázis építése — dokumentumok hozzáadása, weboldalak feltérképezése, feltérképezett oldalak és core-instructionök kezelése
- GYIK-kezelés — GYIK-ek, kategóriák, javaslatok, fordítások és a GYIK widget
- Csevegések felülvizsgálata — beszélgetések értékelése, bizalmi kategóriák hozzárendelése, Improvement Agent futtatása
- Leadekkel és űrlapokkal való munka — leadek, lead kategóriák, capture beállítások, kapcsolatfelvételi űrlapok és beküldések
- Élő chat ügynökként való működés — elérhetőségének beállítása, várakozó csevegések átvétele, válaszadás és munkamenetek lezárása
- A cég adminisztrálása — profil, márkaszínek, csapattagok és meghívók
- Email Assistant használata — postafiók kapcsolatok, kategóriák, névjegyek és aktivitás
- Analitikák és értesítések olvasása
Minden, amit a dashboardon megtehet, elérhető az MCP-n keresztül (és a REST API); csak a böngészőhöz kötött műveletek, mint a fizetések, postafiók OAuth, passkey-ek, fiók törlése és API kulcs kezelése marad a dashboardon.
Első lépések
1. API kulcs generálása
- Navigáljon a Irányítópult → Cég → API fülre
- Kattintson a API-kulcs létrehozása gombra
- Adjon a kulcsnak egy leíró nevet (pl. "Claude Desktop") és válasszon legalább egy jogosultságot
- Másolja ki a generált kulcsot (
cr_-szel kezdődik)
Az API kulcsok fizetős csomagokon érhetők el — lásd a Pricing page oldalunkat.
Tárolja az API kulcsot biztonságosan. Létrehozás után nem kérhető vissza.
2. MCP kliens konfigurálása
A ChatReact MCP szerver a https://www.chatreact.ai/api/mcp címen van hosztolva és HTTP-n (JSON-RPC) kommunikál. Hitelesítés Authorization: Bearer fejléc használatával — X-API-Key fejléc ugyanazzal a kulccsal szintén elfogadott.
Cursor IDE
A Cursor natívan támogat távoli MCP szervereket. Adja hozzá a Cursor MCP beállításaihoz:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
A Claude Desktop konfigurációs fájl parancs-alapú szervereket támogat, ezért használja a szabványos mcp-remote hidat a hosztolt végpont csatlakoztatásához:
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"
]
}
}
}
Ehhez a beállításhoz Node.js telepítése szükséges. A példa a X-API-Key fejlécet használja, mert néhány kliens nem kezeli megbízhatóan a szóközöket az argumentumokban.
3. AI asszisztens újraindítása
A konfiguráció mentése után indítsa újra a Claude Desktopot vagy a Cursort a kapcsolat létrehozásához.
Elérhető eszközök
A ChatReact MCP az alábbi eszközöket tárja fel, területenként csoportosítva. A Scope oszlop azt a API kulcs jogosultságot mutatja, amelyet egy eszköz igényel (any = minden érvényes kulcs). Az eszközök ugyanazokkal az alkalmazható jogosultságokkal, csomagkorlátokkal és mellékhatásokkal futnak, mint a dashboard műveletei. A böngészőhöz kötött fizetési, postafiók-engedélyezési, passkey, fióktörlési és kulcs-kezelési munkafolyamatok a dashboardon maradnak.
Destruktív eszközök (törlés, visszaállítás, lezárás, egyesítés) megerősítést kérnek, amikor a Dashboard Assistanton keresztül használják őket. API kulccsal azonnal végrehajtódnak.
Account
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Lekéri a jelenlegi csomagot (szint, státusz), az aktuális számlázási időszak használati számlálóit (vállalatok, csevegőbotok, csapattagok, csevegések, tokenek) és a csomag korlátait, továbbá a hívásnak alávetett cég hatályos korlátait és funkciózászlóit. | any |
user_companies | Felsorolja az összes vállalatot, amelyhez a jelenlegi felhasználó hozzáfér, és a felhasználó szerepét mindegyikben. | any |
user_notification_mark_read | Megjelöl egyike a jelenlegi felhasználó értesítéseinek olvasottként. | any |
user_notification_preferences_get | Lekéri a jelenlegi felhasználó értesítési beállításait: globális email/push kapcsolók, összegző gyakoriság/ido/napidőzóna, csendes időszak és típusonkénti csatorna beállítások. | any |
user_notification_preferences_update | Frissíti a jelenlegi felhasználó globális értesítési beállításait (email/push kapcsolók, összegző ütemezés, csendes órák). | any |
user_notification_type_setting_update | Engedélyezi vagy letiltja az email / in-app kézbesítést egyetlen értesítéstípusra a jelenlegi felhasználónál (pl. | any |
user_notification_types_list | Felsorolja az összes értesítéstípust kategóriánként csoportosítva (chatbot, leadek, élő chat, tudás, csapat, számlázás). | any |
user_notification_unread_count | Lekéri a jelenlegi felhasználó olvasatlan értesítéseinek számát. | any |
user_notifications | Felsorolja a jelenlegi felhasználó értesítéseit, legújabb elöl, kurzoros lapozással. | any |
user_notifications_delete_old | Karbantartás: véglegesen törli a jelenlegi felhasználó már elolvasott, 30 napnál régebbi értesítéseit. | any |
user_notifications_mark_all_read | Megjelöli az összes értesítést olvasottként a jelenlegi felhasználónál. | any |
user_profile | Lekéri a jelenlegi felhasználó profilját (id, név, email, szerep, előfizetési szint). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Felsorolja egy adott vállalat összes chatbotját összefoglaló statisztikákkal. | chatbots:read |
company_get | Részletes információt ad a vállalatról: profil, tulajdonos, márka beállítások (színek, értesítési email) és darabszámok. | any |
company_invite_cancel | Törli (visszavonja) egy csapatmeghívót, hogy a link ne működjön tovább. | company:write |
company_invite_resend | Újraküld egy függő csapatmeghívót: új tokent ad ki, 7 nappal meghosszabbítja a lejáratot, és újraküldi az emailt. | company:write |
company_invites_list | Felsorolja egy vállalat csapatmeghívóit (alapértelmezésben függő; includeExpired beállítással lejártat is visszaad). | company:read |
company_list | Felsorolja az összes vállalatot, amelyhez a felhasználó hozzáfér (API kulcsok és a Dashboard Assistant csak a saját vállalatukat látják). | any |
company_logo_remove | Eltávolítja a vállalati logót (törli a tárolt képet és kitörli a logo URL-t). | company:write |
company_member_invite | Meghív egy csapattagot emailben szereppel (ADMIN, MANAGER, AGENT vagy VIEWER). | company:write |
company_member_remove | Eltávolít egy csapattagot a vállalattól. | company:write |
company_member_update_role | Megváltoztat egy csapattag szerepét (ADMIN, MANAGER, AGENT vagy VIEWER). | company:write |
company_members_list | Felsorolja a vállalat tagjait szerepük szerint (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Frissíti a vállalat márka beállításait: primaryColor / secondaryColor (#RRGGBB) és az értesítésiEmailt a csevegés-áttekintésekhez. | company:write |
company_update | Frissíti a vállalat profilját: név (2-100 karakter), leírás (max 1000 karakter) vagy weboldal (https:// automatikusan hozzáadódik; üres stringgel törölhető weboldal/leírás). | company:write |
Chatbot Management
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Új core instruction hozzáadása egy chatbothoz (1-5000 karakter). | chatbots:write |
chatbot_confirm_embed | Megjelöli, hogy a chatbot be van ágyazva a weboldalon (elrejti a dashboard beállítás emlékeztetőt). | chatbots:write |
chatbot_create | Létrehoz egy új chatbotot (ugyanaz, mint a dashboard varázsló). | chatbots:write |
chatbot_delete | Véglegesen töröl egy chatbotot minden GYIK-jával, dokumentumával, csevegésével, leadjével és űrlapjaival együtt (visszafordíthatatlan). | chatbots:write |
chatbot_delete_instruction | Töröl egy core instructiont egy chatbotból. | chatbots:write |
chatbot_get | Részletes információt ad egy chatbotról: általános beállítások, személyiség (persona, tónus, nyelvek, korlátozások), widget beállítások, élő chat, tanulási fázis, beágyazottság és darabszámok. | chatbots:read |
chatbot_get_embed_code | Lekéri a HTML snippetet egy chatbot telepítéséhez weboldalon (script URL + <script> tag) és hogy a beágyazás megerősítve van-e. | chatbots:read |
chatbot_get_instructions | Lekéri az összes core instructiont egy chatbothoz. | chatbots:read |
chatbot_improve_instructions | Átírja a core-instruction szövegét a platform AI javítójával (ugyanaz, mint a dashboard "Improve with AI"). | chatbots:write |
chatbot_learning_phase_get | Lekéri egy chatbot tanulási fázis beállításait: viselkedés preset (CAUTIOUS, BALANCED, CONFIDENT), egyedi prompt és hogy a bot még mindig a tanulási fázisban van-e. | chatbots:read |
chatbot_learning_phase_update | Beállítja a tanulási fázis viselkedés presetjét (CAUTIOUS = bizonytalanság esetén emberhez irányít, BALANCED, CONFIDENT) és/vagy egy egyedi learning-phase promptot. | chatbots:write |
chatbot_list | Felsorolja az összes chatbotot, amelyhez a felhasználónak hozzáférése van, összefoglaló statisztikákkal. | chatbots:read |
chatbot_reorder_instructions | Beállítja egy chatbot core instructionjeinek sorrendjét. | chatbots:write |
chatbot_templates_list | Felsorolja a chatbot sablonokat (persona, tónus, üzenetek és widget viselkedés előbeállításai), amelyeket templateId-ként lehet átadni a chatbot_create-nek, és hogy a cég csomagja használhatja-e őket. | chatbots:read |
chatbot_toggle_active | Aktivál vagy deaktivál egy chatbotot. | chatbots:write |
chatbot_toggle_learning | Végezteti (false) vagy újra engedélyezteti (true) egy chatbot tanulási fázisát. | chatbots:write |
chatbot_update | Frissíti egy chatbot általános beállításait: név, leírás, isActive, élő chat (liveChatEnabled/liveChatMode, csomag funkció), showBranding (white-label csomagok), chat-review email-ek, FAQ automatikus generálás, legacy coreInstructions szöveg, tanulási fázis (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Frissít egy meglévő core instructiont (tartalom, isActive, csatorna, sortOrder). | chatbots:write |
chatbot_update_personality | Frissíti egy chatbot személyiségét: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tónus csúszkák 1-5, nyelvek (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), üzenetek (welcomeMessage, fallbackMessage, proactive greeting) és korlátozások (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Lekéri egy chatbot aktuális widget beállításait (minden megjelenési, márka-, viselkedési és pre-chat űrlap mező). | chatbots:read |
widget_settings_update | Frissíti egy chatbot chat widgetjét: pozíció (beleértve. | chatbots:write |
widget_translations_get | Lekéri egy chatbot nyelvenkénti widget fordításait: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Beállítja a nyelvenkénti widget fordításokat. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Megszakít egy PENDING vagy RUNNING crawl feladatot; a fennmaradó oldalakat kihagyja. | knowledge:write |
crawler_job_get | Lekéri egy crawl feladat státuszát, előrehaladását (pagesCrawled/pagesFound, tokensUsed) és az egyes oldalak státuszát. | knowledge:read |
crawler_jobs_list | Felsorolja egy chatbot crawl feladatait (legújabb elöl) státusszal és előrehaladással. | knowledge:read |
crawler_limits | Lekéri a csomag crawl korlátait egy chatbothoz (max oldalak per crawl, tokenek oldalanként, crawls havonta) és hogy indítható-e új crawl ebben a hónapban. | knowledge:read |
crawler_preview_scan | Feltérképez egy weboldalt és listázza a feltérképezhető oldalakat (url, cím, isRecommended) importálás nélkül. | knowledge:write |
crawler_start | Elindít egy crawl munkát, amely importálja a kiválasztott URL-eket a chatbot tudásbázisába (háttérben feldolgozva; poll crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Letölt egy dokumentumot (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) egy nyilvános http(s) URL-ről és hozzáadja a chatbot tudásbázisához. | knowledge:write |
knowledge_document_add_text | Hozzáad egy szöveg vagy markdown dokumentumot egy chatbot tudásbázisához inline tartalomból (max 10 MB). | knowledge:write |
knowledge_document_delete | Töröl egy feltöltött dokumentumot a tudásbázisból. | knowledge:write |
knowledge_document_get | Lekéri egy feltöltött dokumentum részleteit, beleértve a feldolgozási státuszt, hibajelzést és egy rövid élettartamú letöltési URL-t. | knowledge:read |
knowledge_documents_list | Felsorolja a feltöltött dokumentumokat (PDF, TXT, MD, CSV, JSON, DOCX) egy chatbot tudásbázisában státusszal és mérettel. | knowledge:read |
knowledge_page_add | Feltérképez egyetlen URL-t és hozzáadja a chatbot tudásbázisához (CONFLICT hibát ad, ha az URL már indexelve van, FORBIDDEN-t, ha elérte a token limitet). | knowledge:write |
knowledge_page_delete | Töröl egy feltérképezett oldalt a tudásbázisból (eltávolítja a vektor-tároló fájlját). | knowledge:write |
knowledge_page_get | Lekéri egy feltérképezett oldalt, beleértve az indexelt markdown tartalmat a chatbot számára (hasznos annak ellenőrzéséhez, mit tud a bot egy oldalról). | knowledge:read |
knowledge_page_recrawl | Újra lekéri egy feltérképezett oldalt és kicseréli az indexelt tartalmát (pl. | knowledge:write |
knowledge_pages_delete | Több feltérképezett oldalt töröl egyszerre egy chatbotból. | knowledge:write |
knowledge_pages_list | Felsorolja a feltérképezett oldalakat egy chatbot tudásbázisában, opcionálisan domain, státusz vagy keresőkifejezés (URL/cím) szerint szűrve. | knowledge:read |
knowledge_stats | Áttekintés egy chatbot tudásbázisáról: dokumentumok (státusz, méret szerint), feltérképezett oldalak és weboldalak (státusz szerint), crawl feladatok, core instructionök forrás szerint bontva (kézi vs improvement agent), GYIK-ek, vektor tároló státusz/méret és tárhelyhasználat vs. | knowledge:read |
knowledge_website_delete | Töröl minden feltérképezett oldalt egy weboldalról (domain) a chatbot tudásbázisából. | knowledge:write |
knowledge_website_recrawl | Újrafeltérképez egy weboldal (domain) minden oldalát a chatbot tudásbázisában a tartalom frissítéséhez. | knowledge:write |
knowledge_website_recrawl_cancel | Megszakít egy folyamatban lévő weboldal újrafeltérképezést: a domainhez sorolt sorban álló (PENDING) oldalak visszaállnak korábbi indexelt állapotukra. | knowledge:write |
knowledge_websites_list | Felsorolja azokat a weboldalakat (domaineket), amelyek oldalai egy chatbot tudásbázisában vannak, oldalankénti darabszámokkal státusz szerint és token összesítőkkel. | knowledge:read |
Price Management
Ezek az eszközök strukturált árajánlat vázlatokat és explicit jóváhagyásokat kezelnek. Vázlat mentése külön van az adott verzió jóváhagyásától; jogosultság függ a státusztól és érvényességtől is. A meglévő API kulcsok nem kapnak automatikusan árkezelési jogosultságokat. Csak a vállalat tulajdonosa tud prices:write vagy prices:approve jogosultságot adni. API-kulcs hívások közvetlenül végrehajtódnak, ezért hívás előtt ellenőrizze a pontos bemenetet. Lásd a Prices & services oldalt az ügyfél munkafolyamatért.
| Tool | Description | Scope |
|---|---|---|
price_list | Lapozza az árfejléceket és külön kezeli az elfogadott verzió jogosultságát. | prices:read |
price_get | Teljes tétel állapot és revíziók olvasása. | prices:read |
price_detail | Tétel részleteinek olvasása lapozott revíziós előzményekkel. | prices:read |
price_suggestions_list | Lapozás árjavaslatokon. | prices:read |
price_create | Vázlat létrehozása szerver-generált tétel ID-vel. | prices:write |
price_edit | Új vázlat létrehozása explicit várt tétel verzióból. | prices:write |
price_import_csv | Vázlatok importálása explicit formátummal és stabil import ID-vel biztonságos újrapróbáláshoz. | prices:write |
price_suggestion_apply | A kiválasztott javaslat jelölt alkalmazása vázlatként. | prices:write |
price_approve | Egy explicit várt tétel verziójának jóváhagyása. | prices:approve |
price_approve_many | Explicit ID/verzió kiválasztás atomikus jóváhagyása; bármely elavult verzió elutasítja az egész kiválasztást. | prices:approve |
price_archive | Egy tétel archiválása az explicit várt verzión. | prices:approve |
A vázlat szerkesztések megőrzik az előző jóváhagyott revíziót. A CSV formátumot és a tizedeselválasztót explicit módon kell megadni; megváltozott CSV-tartalom új import ID-t igényel. Minden művelet az API kulcs vállalatához és a megadott chatbothoz kötődik.
FAQ Management
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Törli a gyorsítótárazott GYIK widget adatokat az összes csatlakoztatott CMS oldalon (WordPress bővítmény). | faqs:write |
faq_categories_list | Felsorolja egy chatbot GYIK kategóriáit azok GYIK számaival, slugjaival, rendezési módjával és fordításaival. | faqs:read |
faq_categories_reorder | Beállítja a GYIK kategóriák sorrendjét a widgetben: a categoryIds pozíciója lesz a sortOrder. | faqs:write |
faq_category_create | Létrehoz egy GYIK kategóriát egy chatbothoz (a slug a névből generálódik). | faqs:write |
faq_category_delete | Töröl egy GYIK kategóriát. | faqs:write |
faq_category_translations_update | Kicseréli egy GYIK kategória fordításait, pl. | faqs:write |
faq_category_update | Átnevezi egy GYIK kategóriát vagy megváltoztatja leírását, ikonját vagy rendezési módját. | faqs:write |
faq_create | Létrehoz egy GYIK-et egy chatbot számára. | faqs:write |
faq_delete | Véglegesen töröl egy GYIK-et (egyben eltávolítja a chatbot tudásbázisából és kipucolja a CMS widget gyorsítótárakat). | faqs:write |
faq_embed_code_get | Lekéri a GYIK widget beágyazáshoz szükséges snippetjeit: script tag, WordPress shortcode és Shopify Liquid snippet, valamint kategória szerinti variánsok (használja a categorySlug-ot a faq_categories_list-ből, ha csak egy kategóriát akar beágyazni). | chatbots:read |
faq_get | Lekéri egy GYIK teljes részleteit: kérdés, válasz, kategória, publikálási állapot, rendezési sorrend, fordítások, SEO mezők és visszajelzési statisztikák. | faqs:read |
faq_list | Felsorolja egy chatbot GYIK-jeit (használja a chatbot_list-et a chatbotId megtalálásához). | faqs:read |
faq_reorder | Beállítja a GYIK-ek megjelenési sorrendjét a widgetben. | faqs:write |
faq_suggestion_approve | Jóváhagy egy PENDING GYIK javaslatot: létrehoz egy publikált GYIK-et (opcionálisan szerkesztett kérdéssel/válasszal/kategóriával) és megjelöli a javaslatot APPROVED-ként. | faqs:write |
faq_suggestion_get | Lekéri egy GYIK javaslat teljes részleteit (teljes válasz, AI érvelés, javasolt kategória, felülvizsgálati állapot). | faqs:read |
faq_suggestion_reject | Elutasít egy PENDING GYIK javaslatot opcionális indoklással. | faqs:write |
faq_suggestions_generate | Hadd generáljon az AI új GYIK-eket a chatbot tudásbázisából (feltérképezett oldalak / feltöltött dokumentumok), opcionálisan egy kategóriára korlátozva. | faqs:write |
faq_suggestions_list | Felsorolja az AI által generált GYIK javaslatokat egy chatbothoz (chat beszélgetésekből vagy faq_suggestions_generate-ből). | faqs:read |
faq_translate | AI segítségével lefordít egy GYIK kérdését és válaszát a chatbot által támogatott további nyelvekre (vagy a megadott targetLanguages-re) és elmenti az eredményt. | faqs:write |
faq_translations_update | Ment GYIK fordításokat nyelvenként, pl. | faqs:write |
faq_update | Frissít egy GYIK kérdését, válaszát, kategóriáját, publikálási állapotát vagy kézi rendezési sorrendjét. | faqs:write |
faq_widget_settings_get | Lekéri az beágyazható GYIK widget megjelenési és viselkedési beállításait (színek, border radius, cím, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, cím fordítások). | chatbots:read |
faq_widget_settings_update | Frissíti a GYIK widget beállításait: színek (hex), borderRadius 0-32, cím (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = teljes szélesség), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name és cím fordítások nyelvenként. | chatbots:write |
Chat History & Feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Megjelöl egy csevegést felülvizsgáltként anélkül, hogy értékelné (eltávolítja a függő sorból, nem változtatja a bizalmi pontszámot). | chats:write |
chat_feedback_get | Lekéri egy csevegés felülvizsgálatát (visszajelzés) AI elemzéssel, súlyossággal, bizalmi kategóriával, pontszámváltozással és a kapcsolódó improvement sessionnel. | chats:read |
chat_feedback_list | Felsorolja egy chatbot csevegés felülvizsgálatait (visszajelzési sorok) státusz szűrővel és darabszámokkal. | chats:read |
chat_feedback_set_severity | Felülírod a súlyosság besorolást (MINOR|MODERATE|MAJOR|CRITICAL) egy negatív felülvizsgált csevegésnél; a súlyosság befolyásolja a bizalmi pontszám csökkenését. | chats:write |
chat_feedback_stats | Munkamenet számlálók felülvizsgálati vödrönként egy chatbothoz (összesen, nincs, függő, pozitív, negatív, felülvizsgált, javított) — a dashboard chats oldal stat kártyái. | chats:read |
chat_feedback_submit | Értékel egy csevegési munkamenetet Jó (isPositive=true) vagy Javítandó (isPositive=false) minősítéssel. | chats:write |
chat_session_get | Lekéri egy csevegési munkamenetet a teljes átirattal (üzenetenként token/model/latencia/pageUrl), látogató adatokkal, indító oldal URL-jével, bizalmi kategóriával, visszajelzéssel (súlyosság, AI elemzés, kapcsolódó improvement session) és címkékkel. | chats:read |
chat_session_search | Üzenettartalom és/vagy látogató email szerint keres csevegési munkamenetekben egy chatbotnál. | chats:read |
chat_session_set_category | Hozzárendeli vagy megváltoztatja egy csevegés munkamenet bizalmi kategóriáját (korrigálja az AI besorolást; per-kategória bizalom újraszámolódik, amikor a csevegést felülvizsgálták). | chats:write |
chat_sessions_list | Felsorolja egy chatbot csevegési munkameneteit, legújabb elöl, ugyanazokkal a felülvizsgálati sor szűrőkkel, mint a dashboard chats oldala. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Felsorolja egy chatbot bizalmi kategóriáit per-kategória bizalmi pontszámmal, felülvizsgálati számmal és felülvizsgálati email gyakorisággal. | chats:read |
confidence_category_create | Létrehoz egy bizalmi kategóriát egy chatbothoz. | chatbots:write |
confidence_category_delete | Töröl egy bizalmi kategóriát. | chatbots:write |
confidence_category_merge | Egy bizalmi kategória egy másikba történő egyesítése ugyanannál a chatbotnál: minden csevegés/felülvizsgálat átkerül a célba, a forrás törlésre kerül és a pontszámok újraszámolódnak. | chatbots:write |
confidence_category_update | Átnevezi egy bizalmi kategóriát és/vagy beállítja a felülvizsgálati email gyakoriságát (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 csak HOURLY esetén). | chatbots:write |
confidence_status_get | Egy chatbot bizalmi állapota: pontszám, graduációs küszöb, learning phase flag, learning-phase viselkedés (CAUTIOUS|BALANCED|CONFIDENT) és egyedi prompt, felülvizsgálati számlálók és per-kategória bizalmi pontszámok. | analytics:read |
improvement_proposal_approve | Jóváhagy egy PENDING improvement javaslatot és alkalmazza a változást a chatboton (core instruction hozzáadás/frissítés, FAQ létrehozás/frissítés vagy persona frissítése) — ugyanaz a logika és csomagkorlátok, mint a dashboardon. | chatbots:write |
improvement_proposal_reject | Elutasít egy PENDING improvement javaslatot. | chatbots:write |
improvement_proposal_simulate | Szimulálja, hogyan válaszolna a chatbot a problémás üzenetre a javaslat alkalmazásával (eredeti vs. | chatbots:write |
improvement_proposals_pending | Felsorolja a felülvizsgálatra váró improvement javaslatokat (PENDING státusz) a vállalaton belül vagy egy chatbotra vonatkozóan. | chatbots:read |
improvement_session_complete | Megjelöli egy improvement sessiont COMPLETED-ként (a csevegés ezután Improved-ként számít a felülvizsgálati sorban). | chatbots:write |
improvement_session_create | Megnyitja az Improvement Agent-et egy Needs Work-ként értékelt csevegéshez. | chatbots:write |
improvement_session_get | Lekéri egy improvement session részleteit az eredeti csevegéssel (az üzenetek 1-alapú indexet kapnak, amely használható targetMessageIndex-ként), az agent beszélgetéssel, az összes javaslattal (az utolsó szimulációval) és szimulációkkal. | chatbots:read |
improvement_session_reset | Újraindít egy improvement sessiont: törli az összes agent üzenetet, szimulációt és a PENDING/REJECTED javaslatokat (alkalmazott javaslatok megmaradnak) és új beszélgetést indít. | chatbots:write |
improvement_session_send_message | Üzenetet küld az Improvement Agent-nek (írja le, mi volt a probléma a bot válaszával; opcionálisan targetMessageIndex = az eredetiChat.messages-beli bot üzenet 1-alapú indexe). | chatbots:write |
improvement_sessions_list | Felsorolja az improvement sessionöket (Improvement Agent beszélgetések, amelyeket negatív csevegés felülvizsgálatok indítottak) egy chatbotra vagy az egész vállalatra, legújabb elöl, javaslat számlálókkal. | chatbots:read |
improvement_simulation_assess | Értékeli egy szimuláció eredményét: isApproved=true, ha a szimulált válasz jó (a javaslat ezután alkalmazható), false, ha további munkát igényel (komment 'almost' = majdnem jó). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Lekéri a jelenlegi felhasználó saját élő chat elérhetőségét, az aktuálisan elérhető ügynököket élő chathez (friss heartbeat, ugyanaz a jelzés, amelyet a widget használ) és hogy a cég csomagja tartalmazza-e az élő chat-et. | chats:read |
live_chat_heartbeat | Frissíti a jelenlegi felhasználó élő chat jelenlét heartbeat-jét (csak amíg elérhetőként van megjelölve live_chat_set_availability-vel). | chats:write |
live_chat_message_send | Üzenetet küld a látogatónak a hozzárendelt ügynökként. | chats:write |
live_chat_queue | Lekéri az élő chat sort: munkamenetek, amelyek ügynököt várnak, legrégebbi elöl (FIFO). | chats:read |
live_chat_session_assign | Átvesz egy WAITING élő chat munkamenetet a sorból: hozzárendeli a jelenlegi felhasználóhoz (API kulcsok esetén a vállalat tulajdonosa) és értesíti a látogatót, hogy az ügynök csatlakozott. | chats:write |
live_chat_session_close | Befejez egy élő chat munkamenetet ügynökként (bármely nem-VIEWER vállalati tag). | chats:write |
live_chat_session_get | Lekéri egy élő chat munkamenet adatait látogató információval, hozzárendelt ügynökkel, minden üzenettel és az előző bot beszélgetéssel (handoff kontextus). | chats:read |
live_chat_sessions_list | Felsorolja az élő chat munkameneteket (legújabb elöl; WAITING munkamenetek legrégebbitől) opcionális szűrőkkel chatbot, státusz és hozzárendelt ügynök szerint. | chats:read |
live_chat_set_availability | Ki-/bekapcsolja a jelenlegi felhasználó "Available for Live Chat" kapcsolóját egy vállalatra. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Hozzárendel vagy eltávolít egy leadet egy vállalati tagnak (assignedToId: null). | leads:write |
lead_bulk_update_status | Több lead státuszát egyszerre állítja be (max 100). | leads:write |
lead_categories_list | Felsorolja egy chatbot lead kategóriáit lead számlálásokkal és kategóriánként a csapattagokat, akiket értesítenek. | leads:read |
lead_category_assign_user | Hozzáad egy vállalati tagot egy lead kategória értesítési listájához (vagy frissíti értesítési jelzőit). | leads:write |
lead_category_create | Létrehoz egy lead kategóriát egy chatbothoz. | leads:write |
lead_category_delete | Töröl egy lead kategóriát. | leads:write |
lead_category_remove_user | Eltávolít egy vállalati tagot egy lead kategória értesítési listájáról. | leads:write |
lead_category_update | Frissíti egy lead kategória nevét, leírását és/vagy színét. | leads:write |
lead_create | Lead létrehozása kézzel (pl. | leads:write |
lead_delete | Véglegesen töröl egy leadet. | leads:write |
lead_field_config_get | Lekéri egy chatbot lead capture konfigurációját: mezők (id-k megfelelnek a lead.data kulcsainak), megerősítő üzenet, mező/UI fordítások és AI felismerés beállítások. | leads:read |
lead_field_config_update | Frissíti egy chatbot lead capture konfigurációját. | leads:write |
lead_get | Lekéri egy lead teljes részleteit, beleértve a hozzárendeltet, kategóriát és az eredeti chat átiratot (lapozott messageOffset/messageLimit, alapértelmezésben az első 20 üzenet). | leads:read |
lead_list | Felsorolja egy chatbot leadjeit (legújabb elöl) opcionális szűrőkkel státusz, kategória, hozzárendelt és szabad szöveges keresés (név/email/cég) szerint. | leads:read |
lead_stats | Lekéri egy chatbot lead statisztikáit: számlálások státusz szerint, az elmúlt 7 nap leadjei és a konverziós arány (százalék). | leads:read |
lead_update | Frissíti egy lead státuszát, kategóriáját, jegyzeteit, rögzített adatait és/vagy hozzárendeltjét. | leads:write |
Forms
| Tool | Description | Scope |
|---|---|---|
form_create | Létrehoz egy kapcsolatfelvételi űrlapot egy chatbothoz (alapok, mezők, dizájn és spam beállítások egy hívásban). | forms:write |
form_delete | Véglegesen töröl egy kapcsolatfelvételi űrlapot és MINDEN beküldését (kaszkád). | forms:write |
form_get | Lekéri egy kapcsolatfelvételi űrlapot teljes egészében: mezők, fordítások, stílus, spam beállítások, aktív állapot, beküldési darabszám és a beágyazó script tag (embedCode). | forms:read |
form_list | Felsorolja egy chatbot kapcsolatfelvételi űrlapjait mezőszámokkal, beküldési darabszámokkal és beágyazó kódokkal. | forms:read |
form_stats | Egy kapcsolatfelvételi űrlap beküldési számai: összesen, függő, jóváhagyott, spam és elutasított. | forms:read |
form_submission_delete | Véglegesen töröl egy kapcsolatfelvételi űrlap beküldést (pl. | forms:write |
form_submission_get | Lekéri egy kapcsolatfelvételi űrlap beküldését teljes egészében: beküldött mezőadatok, spam pontszám és AI spam elemzés, IP/user agent/referrer metaadatok és felülvizsgálati információk. | forms:read |
form_submission_update_status | Felülvizsgál egy beküldést: státuszát APPROVED, SPAM vagy REJECTED értékre állítja opcionális felülvizsgálati megjegyzéssel. | forms:write |
form_submissions_list | Felsorolja egy kapcsolatfelvételi űrlap beküldéseit, legújabb elöl, opcionálisan státusz (PENDING, APPROVED, SPAM, REJECTED) és létrehozás dátuma szerint szűrve. | forms:read |
form_update | Frissít egy kapcsolatfelvételi űrlapot: név, leírás, aktív állapot (isActive szabályozza, hogy a beágyazás megjelenik-e), mezők (teljes csere), dizájn (színek, gomb szöveg, sikerüzenet) és spam beállítások (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Kicseréli egy űrlap mező és/vagy UI fordításait. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Felsorolja egy postafiók kapcsolat feldolgozott-email aktivitási naplóját (legújabb elöl): feladó, tárgy, hozzárendelt kategória, eredmény (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) és outcomeDetail. | email:read |
email_categories_list | Felsorolja egy postafiók kapcsolat email kategóriáit (sortOrder szerint rendezve). | email:read |
email_category_create | Létrehoz egy email kategóriát egy postafiók kapcsolathoz (max 20 per connection). | email:write |
email_category_delete | Töröl egy email kategóriát. | email:write |
email_category_update | Frissít egy email kategóriát (részleges: csak a megadott mezők változnak). | email:write |
email_connection_disconnect | Véglegesen lekapcsol egy postafiókot. | email:write |
email_connection_get | Lekéri egy postafiók kapcsolódását beleértve. | email:read |
email_connection_update | Frissít egy postafiók kapcsolatot: szinkronizálás szüneteltetése/folytatása (paused true/false; csak ACTIVE<->DISABLED váltást végzi, soha nem írja felül TOKEN_EXPIRED/ERROR állapotot), választervezet készítésének kapcsolója (draftingEnabled) és kategorizálás/szervezés kapcsolója (organizingEnabled), a tápláló chatbot átirányítása (ugyanazon vállalat chatbotId-ja) vagy a HTML válasz aláírás beállítása (signatureHtml, max 20000 karakter; üres string törli). | email:write |
email_connections_list | Felsorolja a vállalat Email Assistant postafiók kapcsolatait (cím, státusz ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, utolsó szinkron, utolsó hiba, drafting/organizing kapcsolók, powering chatbot, draftReadyCategoryCount = kategóriák, amelyekből vázlatok készülhetnek, baseRuleCount = chatbot-szintű 'Chat + Email' szabályok minden vázlathoz) a csomag korlátokkal együtt (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Töröl egy tanult email kapcsolattartót (elfelejti a feladó profilját, pl. | email:write |
email_contact_get | Lekéri egy tanult email kapcsolattartó minden tanult tényét, belső jegyzeteit, kapcsolatot, formális/informális megszólítás beállítást és email statisztikákat. | email:read |
email_contact_update | Frissít egy tanult email kapcsolattartót. | email:write |
email_contacts_list | Felsorolja a vállalat tanult email kapcsolatait (legutóbbi email alapján rendezve) kapcsolat, formális/informális megszólítás (formalAddress: true = formális 'Ön', false = informális 'te', null = automatikus), tény számláló és jegyzet előnézet megjelenítésével. | email:read |
email_folder_create | Létrehoz egy mappát a beérkező alá (visszaadja a meglévőt, ha a név foglalt), hogy célként használható legyen kategória áthelyezéshez. | email:write |
email_folders_list | Felsorolja azokat a mappákat, amelyekbe egy email kategória levelet áthelyezhet élőben a postafiókból: beérkező almappái, egyéni felső szintű mappák, archivum, spam és kuka (id 'deleteditems'). | email:read |
email_general_rules_list | Felsorolja a chatbot-szintű szabályokat, amelyek minden postafiók vázlatra alkalmazandók: aktív core instructionok BOTH csatornával ("Chat + Email"), plusz legacy email-only szabályok, amelyek még nincsenek kategóriába migrálva. | email:read |
Analytics
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Csevegés volumen (indult munkamenetek) időbeli bontásban diagramokhoz és trendekhez: period week/month/quarter/year, granularitás hour/day/week/month, opcionálisan egy chatbothoz. | analytics:read |
analytics_chatbot_stats | Egy hívásban a vállalat per-chatbot teljesítménye (a dashboard chatbot teljesítmény táblázata): id, név, slug, isActive, sessions, messages, FAQs és leads chatbotonként, sessions szerint rendezve. | analytics:read |
analytics_forms | Kapcsolatfelvételi űrlap beküldési statisztikák egy vállalatra vagy egy chatbotra (dashboard analytics widget): beküldések státusz szerint (pending/approved/rejected/spam), űrlapok száma, összesen, spam arány százalékban és az utolsó 7 nap beküldés-napi sorozata. | analytics:read |
analytics_leads | Lead tölcsér egy vállalatra vagy egy chatbotra (dashboard analytics widget): leadek státusz szerint (new/contacted/qualified/converted/lost), összesen, konverziós arány százalékban és az utolsó 7 nap lead-napi sorozata. | analytics:read |
analytics_overview | Analitika áttekintés egy vállalatra vagy egy chatbotra: csevegések, üzenetek, elégedettségi arány és top kérdések egy gördülő periódusra (day/week/month/year), plusz a dashboard áttekintő widgetje (összes chatbot/publikált GYIK/lead, sessions ma/ez a hét/ez a hónap, leadek ma/ez a hét, űrlap beküldések összesen/ma/pending). | analytics:read |
dashboard_activity | Mi igényel jelenleg figyelmet (a dashboard kezdő nézet): per vállalat, a chatbotok, amelyeknek új leadjei vannak ma, függő GYIK javaslatok, függő űrlap beküldések, várakozó/aktív élő chatek vagy egy folyamatban lévő tanulási fázis. | any |
Példa munkafolyamatok
Core Instruction hozzáadása
Kérje meg AI asszisztensét:
"Add a core instruction to my 'Support Bot' chatbot: we offer free shipping on orders over €50"
Az asszisztens a megfelelő paraméterekkel a chatbot_add_instruction hívást fogja használni.
Improvement javaslatok felülvizsgálata
"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"
Az asszisztens a következőket teszi:
- Használja a
improvement_proposals_pending-et a javaslatok lekéréséhez - Elemezi és összefoglalja az egyes javaslatokat
- Jóváhagyja vagy elutasítja őket az Ön nevében a
improvement_proposal_approvevagyimprovement_proposal_rejectsegítségével
Csevegés teljesítményének elemzése
"Give me a weekly report of chat volume and customer satisfaction for my chatbot"
Az asszisztens a analytics_overview-et és a analytics_chat_volume-et használja egy átfogó jelentés összeállításához.
Weboldal importálása
"Scan https://example.com, import the product and pricing pages into my 'Support Bot' and tell me when the crawl is done"
Az asszisztens meghívja a crawler_preview_scan-et, kiválasztja a releváns oldalakat, elindítja az importot a crawler_start segítségével és lekérdezi a crawler_job_get-et, amíg a munka be nem fejeződik.
Leadek és űrlap beküldések felülvizsgálata
"Show me the new leads from this week, assign the qualified ones to Anna and approve the pending contact form submissions"
Az asszisztens kombinálja a lead_list-et, lead_assign-et, form_submissions_list-t és form_submission_update_status-t.
Élő chat átvétele
"Set me available for live chat and take the oldest waiting conversation"
Az asszisztens a live_chat_set_availability-et, live_chat_queue-öt és live_chat_session_assign-ot használja; a válaszok a live_chat_message_send-en keresztül mennek.
Biztonság
- Az API kulcsok a vállalatához és azok jogosultsági scope-jához kötöttek, amelyeket létrehozáskor választ (lásd a Scope oszlopot fent)
- A kulcsok a vállalat tulajdonosának jogosultságaival hajtódnak végre; a csomagkorlátok és funkciózárak pontosan úgy érvényesek, mint a dashboardon
- A kulcsok bármikor visszavonhatók a dashboardról
- Az API hozzáférés fizetős csomagokon érhető el — lásd a Pricing page
Hibaelhárítás
Csatlakozás sikertelen
- Ellenőrizze, hogy az API kulcs helyes-e
- Győződjön meg róla, hogy a kulcsot nem vonták vissza
- Ellenőrizze, hogy a csomagja tartalmazza-e az API hozzáférést
- Indítsa újra az MCP kliensét
Eszköz nem található
Indítsa újra az MCP kliensét a konfiguráció megváltoztatása után, hogy újratöltse az elérhető eszközöket. Az eszközök nevei kisbetűsek alulvonásokkal (pl. faq_list).
Szüksége van segítségre? Lépjen kapcsolatba a támogatási csapatunkkal →