MCP Serverintegration
ChatReact implementerar Model Context Protocol (MCP), vilket låter er koppla ert ChatReact-konto till AI-assistenter som Claude Desktop, Cursor och andra MCP-kompatibla verktyg.
Vad är MCP?
Model Context Protocol är en öppen standard som möjliggör för AI-assistenter att interagera med externa tjänster och datakällor. Med ChatReacts MCP-integration kan ni:
- Hantera chatbots — skapa, konfigurera (persona, språk, widget, beteende, begränsningar), bädda in och radera chatbots
- Bygga kunskapsbasen — lägga till dokument, genomsöka webbplatser, hantera genomsökta sidor och kärninstruktioner
- Hantera FAQ — FAQ, kategorier, förslag, översättningar och FAQ-widgeten
- Granska konversationer — betygsätt samtal, tilldela förtroendekategorier, kör Improvement Agent
- Arbeta med leads och formulär — leads, leadkategorier, fångstinställningar, kontaktformulär och inskick
- Agera som livechatsagent — ställ in er tillgänglighet, ta över väntande chattar, svara och stänga sessioner
- Administrera ert företag — profil, varumärkesfärger, teammedlemmar och inbjudningar
- Använda E-postassistenten — brevlådeanslutningar, kategorier, kontakter och aktivitet
- Läsa analyser och notiser
Allt ni kan göra i instrumentpanelen finns tillgängligt via MCP (och REST API); endast åtgärder som är bundna till webbläsaren såsom betalningar, brevlåde-OAuth, passkeys, kontoradering och hantering av API-nycklar förblir i instrumentpanelen.
Komma igång
1. Generera en API-nyckel
- Navigera till er Översikt → Företag → API-flik
- Klicka Skapa API-nyckel
- Ge nyckeln ett beskrivande namn (t.ex. "Claude Desktop") och välj minst en behörighet
- Kopiera den genererade nyckeln (börjar med
cr_)
API-nycklar finns på betalda planer — se vår Pricing page.
Spara din API-nyckel på ett säkert sätt. Den kan inte hämtas igen efter skapandet.
2. Konfigurera er MCP-klient
ChatReact MCP-servern är hostad på https://www.chatreact.ai/api/mcp och kommunicerar över HTTP (JSON-RPC). Autentisera med en Authorization: Bearer-header — en X-API-Key-header med samma nyckel accepteras också.
Cursor IDE
Cursor stöder fjärr-MCP-servrar direkt. Lägg till i era Cursor MCP-inställningar:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Claude Desktops konfigurationsfil stödjer kommandobaserade servrar, så använd den standardiserade mcp-remote-bron för att koppla till den hostade endpoints:
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"
]
}
}
}
Denna uppsättning kräver att Node.js är installerat. Exemplet använder X-API-Key-headern eftersom vissa klienter inte hanterar blanksteg i argument tillförlitligt.
3. Starta om er AI-assistent
Efter att ha sparat konfigurationen, starta om Claude Desktop eller Cursor för att upprätta anslutningen.
Tillgängliga verktyg
ChatReact MCP exponerar nedanstående verktyg, grupperade per område. Kolumnen Scope visar vilken API-nyckelsbehörighet ett verktyg kräver (any = varje giltig nyckel). Verktygen körs med samma tillämpliga behörigheter, planbegränsningar och sidoeffekter som motsvarande operationer i instrumentpanelen. Webbläsarbundna betalnings-, brevlådeautentiserings-, passkey-, kontoraderings- och nyckelhanteringsflöden förblir i instrumentpanelen.
Destruktiva verktyg (radera, återställ, stäng, slå ihop) begär bekräftelse när de används via Dashboard Assistant. Via API-nyckel utförs de omedelbart.
Konto
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Hämta aktuell plan (nivå, status), användarräknare för den pågående faktureringsperioden (företag, chatbots, teammedlemmar, chattar, tokens) samt planens gränser, plus effektiva gränser och funktionsflaggor för det företag som anropet är scope:at till. | any |
user_companies | Lista alla företag som den aktuella användaren har åtkomst till, med användarens roll i respektive. | any |
user_notification_mark_read | Markera en av den aktuella användarens notiser som läst. | any |
user_notification_preferences_get | Hämta den aktuella användarens notisinställningar: globala e-post/push-växlar, digest-frekvens/tid/veckodag/tidszon, tysta timmar och kanalinställningar per typ. | any |
user_notification_preferences_update | Uppdatera den aktuella användarens globala notisinställningar (e-post/push-växlar, digest-schema, tysta timmar). | any |
user_notification_type_setting_update | Aktivera eller inaktivera e-post-/in-app-leverans för en enskild notistyp för den aktuella användaren (t.ex. | any |
user_notification_types_list | Lista alla notistyper grupperade per kategori (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Hämta antal olästa notiser för den aktuella användaren. | any |
user_notifications | Lista den aktuella användarens notiser, nyast först, med cursor-paginering. | any |
user_notifications_delete_old | Underhåll: ta bort permanent den aktuella användarens notiser som redan är lästa och äldre än 30 dagar. | any |
user_notifications_mark_all_read | Markera alla den aktuella användarens notiser som lästa. | any |
user_profile | Hämta den aktuella användarens profil (id, namn, e-post, roll, prenumerationsnivå). | any |
Företag & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Lista alla chatbots för ett specifikt företag med sammanfattande statistik. | chatbots:read |
company_get | Hämta detaljerad information om ett företag: profil, ägare, varumärkesinställningar (färger, notis-e-post) och räkneverk. | any |
company_invite_cancel | Avbryt (radera) en teaminbjudan så att länken upphör att fungera. | company:write |
company_invite_resend | Skicka om en väntande teaminbjudan: skapar en ny token, förlänger utgångstiden med 7 dagar och skickar inbjudningsmejlet igen. | company:write |
company_invites_list | Lista teaminbjudningar för ett företag (väntande som standard; sätt includeExpired för att även returnera utgångna). | company:read |
company_list | Lista alla företag som användaren har åtkomst till (API-nycklar och Dashboard Assistant ser bara sitt eget företag). | any |
company_logo_remove | Ta bort företagslogotypen (raderar den lagrade bilden och rensar logotyp-URL). | company:write |
company_member_invite | Bjud in en teammedlem via e-post med en roll (ADMIN, MANAGER, AGENT eller VIEWER). | company:write |
company_member_remove | Ta bort en teammedlem från företaget. | company:write |
company_member_update_role | Ändra en teammedlems roll (ADMIN, MANAGER, AGENT eller VIEWER). | company:write |
company_members_list | Lista medlemmarna i ett företag med deras roller (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Uppdatera företagets varumärkesinställningar: primaryColor / secondaryColor (#RRGGBB) och notificationEmail för chattgranskningar. | company:write |
company_update | Uppdatera företagsprofilen: namn (2–100 tecken), beskrivning (max 1000 tecken) eller webbplats (https:// läggs till automatiskt; skicka en tom sträng för att rensa webbplats/beskrivning). | company:write |
Chatbot-hantering
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Lägg till en ny kärninstruktion till en chatbot (1–5000 tecken). | chatbots:write |
chatbot_confirm_embed | Markera en chatbot som inbäddad på webbplatsen (gömmer uppsättningspåminnelsen i instrumentpanelen). | chatbots:write |
chatbot_create | Skapa en ny chatbot (samma som guiden i instrumentpanelen). | chatbots:write |
chatbot_delete | Radera permanent en chatbot med alla dess FAQ, dokument, chattar, leads och formulär (kan inte ångras). | chatbots:write |
chatbot_delete_instruction | Radera en kärninstruktion från en chatbot. | chatbots:write |
chatbot_get | Hämta detaljerad information om en chatbot: allmänna inställningar, personlighet (persona, ton, språk, begränsningar), widgetinställningar, live chat, inlärningsfas, inbäddningsstatus och räkneverk. | chatbots:read |
chatbot_get_embed_code | Hämta HTML-snippet för att installera en chatbot på en webbplats (skript-URL + <script>-tagg) och huruvida inbäddningen har bekräftats. | chatbots:read |
chatbot_get_instructions | Hämta alla kärninstruktioner för en chatbot. | chatbots:read |
chatbot_improve_instructions | Skriv om kärninstruktionstext med plattformens AI-improver (samma som instrumentpanelens 'Improve with AI'). | chatbots:write |
chatbot_learning_phase_get | Hämta inlärningsfasens inställningar för en chatbot: beteendepreset (CAUTIOUS, BALANCED, CONFIDENT), anpassad prompt och huruvida boten fortfarande är i inlärningsfasen. | chatbots:read |
chatbot_learning_phase_update | Sätt beteendepreset för inlärningsfasen (CAUTIOUS = hänvisa till människa vid osäkerhet, BALANCED, CONFIDENT) och/eller en anpassad inlärningsprompt. | chatbots:write |
chatbot_list | Lista alla chatbots som användaren har åtkomst till, med sammanfattande statistik. | chatbots:read |
chatbot_reorder_instructions | Sätt ordningen på en chatbots kärninstruktioner. | chatbots:write |
chatbot_templates_list | Lista chatbot-mallar (presets för persona, ton, meddelanden och widgetbeteende) som kan skickas som templateId till chatbot_create, och om företagets plan får använda dem. | chatbots:read |
chatbot_toggle_active | Aktivera eller inaktivera en chatbot. | chatbots:write |
chatbot_toggle_learning | Avsluta (false) eller återaktivera (true) en chatbots inlärningsfas. | chatbots:write |
chatbot_update | Uppdatera en chatbots allmänna inställningar: namn, beskrivning, isActive, live chat (liveChatEnabled/liveChatMode, planfunktion), showBranding (white-label-planer), chattgransknings-e-post, automatisk FAQ-generering, legacy coreInstructions-text, inlärningsfas (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Uppdatera en befintlig kärninstruktion (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Uppdatera en chatbots personlighet: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonalskjutreglage 1–5, språk (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), meddelanden (welcomeMessage, fallbackMessage, proactive greeting) och begränsningar (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Hämta en chatbots nuvarande widgetinställningar (alla utseende-, varumärkes-, beteende- och förformulärfält). | chatbots:read |
widget_settings_update | Uppdatera en chatbots chattwidget: position (inkl. | chatbots:write |
widget_translations_get | Hämta per-språk widgetöversättningar för en chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Sätt per-språkiga widgetöversättningar. | chatbots:write |
Kunskapsbas
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Avbryt ett PENDING- eller RUNNING-crawljobb; återstående sidor hoppas över. | knowledge:write |
crawler_job_get | Hämta status för ett crawljobb, framsteg (pagesCrawled/pagesFound, tokensUsed) och status för varje sida. | knowledge:read |
crawler_jobs_list | Lista en chatbots crawljobb (nyast först) med status och framsteg. | knowledge:read |
crawler_limits | Hämta planens crawlgränser för en chatbot (max sidor per crawl, tokens per sida, crawls per månad) och om en ny crawl kan startas denna månad. | knowledge:read |
crawler_preview_scan | Skanna en webbplats och lista dess genomsökningsbara sidor (url, titel, isRecommended) utan att importera något. | knowledge:write |
crawler_start | Starta ett crawljobb som importerar de valda URL:erna till chatbots kunskapsbas (bearbetas i bakgrunden; poll crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Hämta ett dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) från en offentlig http(s)-URL och lägg till det i en chatbots kunskapsbas. | knowledge:write |
knowledge_document_add_text | Lägg till ett text- eller markdown-dokument i en chatbots kunskapsbas från inline-innehåll (max 10 MB). | knowledge:write |
knowledge_document_delete | Radera ett uppladdat dokument från kunskapsbasen. | knowledge:write |
knowledge_document_get | Hämta detaljer om ett uppladdat dokument inklusive bearbetningsstatus, felmeddelande och en kortlivad nedladdnings-URL. | knowledge:read |
knowledge_documents_list | Lista uppladdade dokument (PDF, TXT, MD, CSV, JSON, DOCX) i en chatbots kunskapsbas med status och storlek. | knowledge:read |
knowledge_page_add | Crawla en enskild URL och lägg till den i chatbots kunskapsbas (misslyckas med CONFLICT när URL:en redan är indexerad, FORBIDDEN när token-gränsen är nådd). | knowledge:write |
knowledge_page_delete | Ta bort en genomsökt sida från kunskapsbasen (tar bort dess vektorlagringsfil). | knowledge:write |
knowledge_page_get | Hämta en genomsökt sida inklusive markdown-innehållet som indexerades för chatbottan (nyttigt för att verifiera vad boten vet om en sida). | knowledge:read |
knowledge_page_recrawl | Hämta en genomsökt sida igen och ersätt dess indexerade innehåll (t.ex. | knowledge:write |
knowledge_pages_delete | Radera flera genomsökta sidor för en chatbot på en gång. | knowledge:write |
knowledge_pages_list | Lista genomsökta sidor i en chatbots kunskapsbas, eventuellt filtrerat efter domän, status eller sökterm (URL/titel). | knowledge:read |
knowledge_stats | Översikt över en chatbots kunskapsbas: dokument (per status, storlek), genomsökta sidor och webbplatser (per status), crawljobb, kärninstruktioner uppdelade efter källa (manuellt vs improvement agent), FAQ, vektorstore-status/storlek och lagringsanvändning vs. | knowledge:read |
knowledge_website_delete | Radera alla genomsökta sidor för en webbplats (domän) från chatbots kunskapsbas. | knowledge:write |
knowledge_website_recrawl | Återcrawla alla sidor för en webbplats (domän) i chatbots kunskapsbas för att uppdatera dess innehåll. | knowledge:write |
knowledge_website_recrawl_cancel | Avbryt en pågående webbplats-återcrawling: köade (PENDING) sidor för domänen återställs till deras tidigare indexerade tillstånd. | knowledge:write |
knowledge_websites_list | Lista webbplatserna (domäner) vars sidor finns i en chatbots kunskapsbas, med sidantal per status och token-totalsummor. | knowledge:read |
Pris-hantering
Dessa verktyg hanterar strukturerade prisutkast och uttryckliga godkännanden. Att spara ett utkast är separat från att godkänna exakt version; behörighet beror också på status och giltighet. Befintliga API-nycklar får inte prisbehörigheter automatiskt. Endast företagsägaren kan bevilja prices:write eller prices:approve. API-nyckelsanrop körs direkt, så granska exakt input innan ni anropar en mutation. Se Prices & services för kundflödet.
| Tool | Description | Scope |
|---|---|---|
price_list | Sidor genom prisrubriker och separat godkänd versions-eligibilitet. | prices:read |
price_get | Läs komplett objekttillstånd och revisioner. | prices:read |
price_detail | Läs objektdetalj med paginerad revisionshistorik. | prices:read |
price_suggestions_list | Sidor genom pristips. | prices:read |
price_create | Skapa ett utkast med ett servergenererat item ID. | prices:write |
price_edit | Skapa ett nytt utkast från en uttryckligen förväntad item-version. | prices:write |
price_import_csv | Importera utkast med ett explicit format och stabilt import-ID för säkra retry. | prices:write |
price_suggestion_apply | Applicera det valda förslagets kandidat som ett utkast. | prices:write |
price_approve | Godkänn en uttryckligen förväntad item-version. | prices:approve |
price_approve_many | Godkänn ett explicit ID/version-val atomärt; varje föråldrad version avvisar hela valet. | prices:approve |
price_archive | Arkivera ett objekt vid dess uttryckligen förväntade version. | prices:approve |
Redigeringar av utkast bevarar föregående godkända revision. CSV-format och decimalavgränsare måste vara explicita; ändrat CSV-innehåll kräver ett nytt import-ID. Alla operationer är bundna till API-nyckelns företag och den angivna chatboten.
FAQ-hantering
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Rensa cache för FAQ-widgetdata på alla anslutna CMS-sajter (WordPress-plugin). | faqs:write |
faq_categories_list | Lista en chatbots FAQ-kategorier med deras FAQ-antal, sluggar, sortläge och översättningar. | faqs:read |
faq_categories_reorder | Ange ordningen för FAQ-kategorier i widgeten: position i categoryIds blir sortOrder. | faqs:write |
faq_category_create | Skapa en FAQ-kategori för en chatbot (slug genereras från namnet). | faqs:write |
faq_category_delete | Radera en FAQ-kategori. | faqs:write |
faq_category_translations_update | Ersätt översättningar för en FAQ-kategori, t.ex. | faqs:write |
faq_category_update | Byt namn på en FAQ-kategori eller ändra dess beskrivning, ikon eller sortläge. | faqs:write |
faq_create | Skapa en FAQ för en chatbot. | faqs:write |
faq_delete | Radera permanent en FAQ (tar även bort den från chatbottens kunskapsbas och rensar CMS-widgetcachar). | faqs:write |
faq_embed_code_get | Hämta embed-snippets för FAQ-widgeten: skript-tag, WordPress-shortcode och Shopify Liquid-snippet, plus per-kategori-varianter (använd categorySlug från faq_categories_list för att bara bädda in en kategori). | chatbots:read |
faq_get | Hämta fullständiga detaljer om en FAQ: fråga, svar, kategori, publiceringsstatus, sortordning, översättningar, SEO-fält och feedbackstatistik. | faqs:read |
faq_list | Lista FAQs för en chatbot (använd chatbot_list för att hitta chatbotId). | faqs:read |
faq_reorder | Sätt visningsordningen för FAQs i widgeten. | faqs:write |
faq_suggestion_approve | Godkänn ett PENDING FAQ-förslag: skapar en publicerad FAQ (valfritt med redigerad fråga/svar/kategori) och markerar förslaget som APPROVED. | faqs:write |
faq_suggestion_get | Hämta fullständiga detaljer om ett FAQ-förslag (komplett svar, AI-resonemang, föreslagen kategori, granskningsstatus). | faqs:read |
faq_suggestion_reject | Avvisa ett PENDING FAQ-förslag med en valfri anledning. | faqs:write |
faq_suggestions_generate | Låt AI föreslå nya FAQs från chatbottens kunskapsbas (genomsökta sidor / uppladdade dokument), valfritt för en kategori. | faqs:write |
faq_suggestions_list | Lista AI-genererade FAQ-förslag för en chatbot (från chattkonversationer eller faq_suggestions_generate). | faqs:read |
faq_translate | Översätt en FAQs fråga och svar med AI till chatbottens andra stödda språk (eller angivna targetLanguages) och spara resultatet. | faqs:write |
faq_translations_update | Spara översättningar av en FAQ per språk, t.ex. | faqs:write |
faq_update | Uppdatera en FAQs fråga, svar, kategori, publiceringsstatus eller manuella sortordning. | faqs:write |
faq_widget_settings_get | Hämta utseende- och beteendeinställningar för den inbäddningsbara FAQ-widgeten (färger, border radius, titel, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, titelöversättningar). | chatbots:read |
faq_widget_settings_update | Uppdatera FAQ-widgetinställningarna: färger (hex), borderRadius 0–32, titel (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0–2000 (0 = full bredd), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name och title-översättningar per språk. | chatbots:write |
Chatt-historik & feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Markera en chatt som granskad utan att betygsätta den (tar bort den från väntkön, ändrar inte förtroendescore). | chats:write |
chat_feedback_get | Hämta en chattgranskning (feedback) med AI-analys, allvarlighetsgrad, förtroendekategori, poängändring och länkat förbättringssession. | chats:read |
chat_feedback_list | Lista chattgranskningar (feedback-rader) för en chatbot med statusfilter och räkneverk. | chats:read |
chat_feedback_set_severity | Åsidosätt klassificeringen av allvarlighetsgrad (MINOR|MODERATE|MAJOR|CRITICAL) för en granskad negativ chatt; allvarlighet viktar förtroendepoängens minskning. | chats:write |
chat_feedback_stats | Sessionsräkningar per granskningsbucket för en chatbot (total, none, pending, positive, negative, reviewed, improved) — statistik-korten på instrumentpanelens chatt-sida. | chats:read |
chat_feedback_submit | Betygsätt en chattsession som Good (isPositive=true) eller Needs Work (isPositive=false). | chats:write |
chat_session_get | Hämta en chattsession med full transkription (per-meddelande token/model/latency/pageUrl), besöksdetaljer, startad sid-URL, förtroendekategori, feedback (severity, AI analysis, länkat förbättringssession) och taggar. | chats:read |
chat_session_search | Sök i chattsessioner för en chatbot efter meddelandeinnehåll och/eller besökarens e-post. | chats:read |
chat_session_set_category | Tilldela eller ändra förtroendekategori för en chattsession (korrigerar AI-kategoriseringen; per-kategori förtroende räknas om när chatten granskats). | chats:write |
chat_sessions_list | Lista chattsessioner för en chatbot, nyast först, med samma granskningsköfilter som instrumentpanelens chatt-sida. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Lista en chatbots förtroendekategorier med per-kategori förtroendepoäng, granskningsantal och e-postfrekvens för granskning. | chats:read |
confidence_category_create | Skapa en förtroendekategori för en chatbot. | chatbots:write |
confidence_category_delete | Radera en förtroendekategori. | chatbots:write |
confidence_category_merge | Slå ihop en förtroendekategori in i en annan i samma chatbot: alla chattar/granskningar flyttas till målet, källan raderas och poäng räknas om. | chatbots:write |
confidence_category_update | Byt namn på en förtroendekategori och/eller sätt dess review-email-frekvens (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1–24 endast för HOURLY). | chatbots:write |
confidence_status_get | Förtroendestatus för en chatbot: poäng, examenströskel, inlärningsfas-flagga, inlärningsfasbeteende (CAUTIOUS|BALANCED|CONFIDENT) och anpassad prompt, granskningsräkningar och per-kategori förtroendepoäng. | analytics:read |
improvement_proposal_approve | Godkänn ett PENDING förbättringsförslag och tillämpa ändringen på chatboten (kärninstruktion add/update, FAQ create/update eller persona update) — samma logik och planbegränsningar som i instrumentpanelen. | chatbots:write |
improvement_proposal_reject | Avvisa ett PENDING förbättringsförslag. | chatbots:write |
improvement_proposal_simulate | Simulera hur chatboten skulle svara på det problematiska meddelandet med ett föreslaget förslag tillämpat (original vs. | chatbots:write |
improvement_proposals_pending | Lista förbättringsförslag som väntar på granskning (status PENDING) över företaget eller för en specifik chatbot. | chatbots:read |
improvement_session_complete | Markera en förbättringssession som COMPLETED (chatten räknas då som Improved i granskningskön). | chatbots:write |
improvement_session_create | Öppna Improvement Agent för en chatt som bedömts Needs Work. | chatbots:write |
improvement_session_get | Hämta en förbättringssession med originalchatten (meddelanden har ett 1-baserat index användbart som targetMessageIndex), agentkonversationen, alla förslag (med deras senaste simulering) och simuleringar. | chatbots:read |
improvement_session_reset | Starta om en förbättringssession: raderar alla agentmeddelanden, simuleringar och PENDING/REJECTED-förslag (tillämpade förblir) och startar en ny konversation. | chatbots:write |
improvement_session_send_message | Skicka ett meddelande till Improvement Agent (beskriv vad som var fel med botens svar; valfritt targetMessageIndex = det 1-baserade indexet för botmeddelandet i originalChat.messages). | chatbots:write |
improvement_sessions_list | Lista förbättringssessioner (Improvement Agent-konversationer startade från negativa chattgranskningar) för en chatbot eller hela företaget, nyast först, med förslagsantal. | chatbots:read |
improvement_simulation_assess | Betygsätt ett simuleringsresultat: isApproved=true när det simulerade svaret är bra (förslaget kan då tillämpas), false när det behöver mer arbete (kommentar 'almost' = nästan rätt). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Hämta den aktuella användarens egna livechat-tillgänglighet, de agenter som för närvarande är tillgängliga för live chat (färskt heartbeat, samma signal som widgeten använder) och om företagets plan inkluderar live chat. | chats:read |
live_chat_heartbeat | Uppdatera den aktuella användarens livechat-presence heartbeat (endast medan markerad som tillgänglig via live_chat_set_availability). | chats:write |
live_chat_message_send | Skicka ett meddelande till besökaren som den tilldelade agenten. | chats:write |
live_chat_queue | Hämta livechat-kön: sessioner som väntar på agent, äldst först (FIFO). | chats:read |
live_chat_session_assign | Ta en WAITING livechat-session från kön: tilldelar den till aktuell användare (företagsägare för API-nycklar) och meddelar besökaren att agenten anslutit. | chats:write |
live_chat_session_close | Avsluta en livechat-session som agent (any non-VIEWER medlem i företaget). | chats:write |
live_chat_session_get | Hämta en livechat-session med besökarinfo, tilldelad agent, alla meddelanden och föregående botkonversation (handoff-context). | chats:read |
live_chat_sessions_list | Lista livechat-sessioner (nyast först; WAITING-sessioner äldst först) med valfria filter per chatbot, status och tilldelad agent. | chats:read |
live_chat_set_availability | Växla den aktuella användarens 'Available for Live Chat'-omkopplare för ett företag. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Tilldela ett lead till en företagsmedlem eller avskriv det (assignedToId: null). | leads:write |
lead_bulk_update_status | Sätt status för flera leads (max 100) samtidigt. | leads:write |
lead_categories_list | Lista leadkategorier för en chatbot med leadantal och teammedlemmar som notifieras per kategori. | leads:read |
lead_category_assign_user | Lägg till en företagsmedlem i en leadkategoris notifieringslista (eller uppdatera deras notifieringsflaggor). | leads:write |
lead_category_create | Skapa en leadkategori för en chatbot. | leads:write |
lead_category_delete | Radera en leadkategori. | leads:write |
lead_category_remove_user | Ta bort en företagsmedlem från en leadkategoris notifieringslista. | leads:write |
lead_category_update | Uppdatera en leadkategoris namn, beskrivning och/eller färg. | leads:write |
lead_create | Skapa ett lead manuellt (t.ex. | leads:write |
lead_delete | Radera ett lead permanent. | leads:write |
lead_field_config_get | Hämta lead capture-konfigurationen för en chatbot: fält (ids mappar till nycklar i lead.data), bekräftelsemeddelande, fält-/UI-översättningar och AI-igenkänningsinställningar. | leads:read |
lead_field_config_update | Uppdatera lead capture-konfigurationen för en chatbot. | leads:write |
lead_get | Hämta fullständiga detaljer för ett lead inklusive ansvarig, kategori och källans chatttranskript (paginerat med messageOffset/messageLimit, standard första 20 meddelanden). | leads:read |
lead_list | Lista leads för en chatbot (nyast först) med valfria filter per status, kategori, ansvarig och fritextsök (namn/e-post/företag). | leads:read |
lead_stats | Hämta leadstatistik för en chatbot: räkningar per status, leads de senaste 7 dagarna och konverteringsgrad (procent). | leads:read |
lead_update | Uppdatera ett leads status, kategori, anteckningar, fångade data och/eller ansvarig. | leads:write |
Formulär
| Tool | Description | Scope |
|---|---|---|
form_create | Skapa ett kontaktformulär för en chatbot (grundläggande, fält, design och spam-inställningar i ett anrop). | forms:write |
form_delete | Radera permanent ett kontaktformulär och ALLA dess inskick (kaskad). | forms:write |
form_get | Hämta ett kontaktformulär i sin helhet: fält, översättningar, styling, spam-inställningar, aktivt tillstånd, inskicksräknare och embed-skriptet (embedCode). | forms:read |
form_list | Lista kontaktformulär för en chatbot med fältantal, inskicksräkningar och embed-koder. | forms:read |
form_stats | Inskicksräkningar för ett kontaktformulär: totalt, pending, approved, spam och rejected. | forms:read |
form_submission_delete | Radera permanent ett inskick av ett kontaktformulär (t.ex. | forms:write |
form_submission_get | Hämta ett kontaktformulärinskick i sin helhet: inlämnad fältdatat, spam-score och AI-spamanalys, IP/user agent/referrer-metadata och granskningsinformation. | forms:read |
form_submission_update_status | Granska ett kontaktformulärinskick: sätt dess status till APPROVED, SPAM eller REJECTED med en valfri granskningsanteckning. | forms:write |
form_submissions_list | Lista inskick för ett kontaktformulär, nyast först, eventuellt filtrerat efter status (PENDING, APPROVED, SPAM, REJECTED) och skapelsedatum. | forms:read |
form_update | Uppdatera ett kontaktformulär: namn, beskrivning, aktivt tillstånd (isActive styr om embed renderas), fält (full ersättning), design (färger, knapptext, framgångsmeddelande) och spam-inställningar (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Ersätt fält- och/eller UI-översättningar för ett kontaktformulär. | forms:write |
E-postassistent
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Lista aktivitetsloggen för bearbetade e-postmeddelanden för en brevlådeanslutning (nyast först): avsändare, ämne, tilldelad kategori, utfall (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) och outcomeDetail. | email:read |
email_categories_list | Lista e-postkategorier för en brevlådeanslutning (sorterade efter sortOrder). | email:read |
email_category_create | Skapa en e-postkategori för en brevlådeanslutning (max 20 per anslutning). | email:write |
email_category_delete | Radera en e-postkategori. | email:write |
email_category_update | Uppdatera en e-postkategori (partiell: endast angivna fält ändras). | email:write |
email_connection_disconnect | Koppla bort en brevlåda permanent. | email:write |
email_connection_get | Hämta en brevlådeanslutning inkl. | email:read |
email_connection_update | Uppdatera en brevlådeanslutning: pausa/återuppta synkroniseringen (paused true/false; växlar endast ACTIVE<->DISABLED, skriver aldrig över TOKEN_EXPIRED/ERROR), växla svarsdraftrutiner (draftingEnabled) och kategorisering/organisering (organizingEnabled), peka om drivande chatbot (chatbotId i samma företag) eller sätta HTML-svars-signatur (signatureHtml, max 20000 tecken; tom sträng rensar den). | email:write |
email_connections_list | Lista företagets Email Assistant-brevlådeanslutningar (adress, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, sista synk, sista fel, drafting/organizing-växlar, drivande chatbot, draftReadyCategoryCount = kategorier som kan ge utkast, baseRuleCount = chatbot-omfattande 'Chat + Email'-regler som tillämpas på varje utkast) tillsammans med planbegränsningar (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Radera en inlärd e-postkontakt (glöm avsändarprofilen, t.ex. | email:write |
email_contact_get | Hämta en inlärd e-postkontakt med alla inlärda fakta, interna anteckningar, relation, formal/informal address-inställning och e-poststatistik. | email:read |
email_contact_update | Uppdatera en inlärd e-postkontakt. | email:write |
email_contacts_list | Lista företagets inlärda e-postkontakter (senaste e-post först) med relation, formal/informal address (formalAddress: true = formell 'Sie', false = informell 'Du', null = automatisk), faktantal och en anteckningsförhandsvisning. | email:read |
email_folder_create | Skapa en mailmapp under inkorgen (returnerar den befintliga om namnet är taget) att använda som mål för kategoriförflyttning. | email:write |
email_folders_list | Lista mappar som en e-postkategori kan flytta mejl till, live från brevlådan: inkorgens undermappar, anpassade top-level-mappar, arkiv, skräppost och papperskorgen (id 'deleteditems'). | email:read |
email_general_rules_list | Lista chatbot-omfattande regler som gäller för varje svarsdraft i en brevlåda: aktiva kärninstruktioner med channel BOTH ("Chat + Email"), plus legacy e-post-enda regler som ännu inte migrerats in i en kategori. | email:read |
Analys
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Chattvolym (sessioner startade) över tid för diagram och trender: period week/month/quarter/year, granularitet hour/day/week/month, valfritt för en chatbot. | analytics:read |
analytics_chatbot_stats | Per-chatbot prestanda för ett företag i ett anrop (instrumentpanelens chatbotperformance-tabell): id, namn, slug, isActive, sessions, messages, FAQs och leads per chatbot, sorterat efter sessions. | analytics:read |
analytics_forms | Kontaktformulärsinskick-statistik för ett företag eller en chatbot (instrumentpannels widget): inskick per status (pending/approved/rejected/spam), antal formulär, totalt, spam-rate i procent och inskick-per-dag-serien för de senaste 7 dagarna. | analytics:read |
analytics_leads | Lead-funnel för ett företag eller en chatbot (instrumentpanelens widget): leads per status (new/contacted/qualified/converted/lost), totalt, konverteringsgrad i procent och leads-per-dag-serien för de senaste 7 dagarna. | analytics:read |
analytics_overview | Analysöversikt för ett företag eller en chatbot: chattar, meddelanden, tillfredsställelsegrad och toppfrågor för en rullande period (day/week/month/year), plus instrumentpanelens översiktswidget (totala chatbots/publicerade FAQs/leads, sessioner idag/denna vecka/denna månad, leads idag/denna vecka, formulärinskick totalt/idag/pending). | analytics:read |
dashboard_activity | Vad som för närvarande behöver uppmärksamhet (instrumentpanelens startsida): per företag, de chatbots som har nya leads idag, väntande FAQ-förslag, väntande formulärinskick, väntande/aktiva livechattar eller en pågående inlärningsfas. | any |
Exempelarbetsflöden
Lägga till en kärninstruktion
Be er AI-assistent:
"Lägg till en kärninstruktion i min 'Support Bot' chatbot: vi erbjuder fri frakt på beställningar över €50"
Assistenten kommer att använda chatbot_add_instruction med lämpliga parametrar.
Granska förbättringsförslag
"Visa alla väntande förbättringsförslag för min chatbot och förklara vilka ändringar de föreslår"
Assistenten kommer att:
- Använda
improvement_proposals_pendingför att hämta förslag - Analysera och sammanfatta varje förslag
- Godkänna eller avvisa dem å era vägnar med
improvement_proposal_approveellerimprovement_proposal_reject
Analysera chattprestanda
"Ge mig en veckorapport över chattvolym och kundtillfredsställelse för min chatbot"
Assistenten kommer att använda analytics_overview och analytics_chat_volume för att sammanställa en omfattande rapport.
Importera en webbplats
"Skanna https://example.com, importera produktsidorna och pris-sidor till min 'Support Bot' och meddela mig när crawl är klar"
Assistenten kommer att anropa crawler_preview_scan, välja relevanta sidor, starta importen med crawler_start och poll:a crawler_job_get tills jobbet är klart.
Granska leads och formulärinskick
"Visa mig nya leads från den här veckan, tilldela de kvalificerade till Anna och godkänn de väntande kontaktformulärsinskicken"
Assistenten kombinerar lead_list, lead_assign, form_submissions_list och form_submission_update_status.
Ta över en livechatt
"Sätt mig som tillgänglig för live chat och ta det äldsta väntande samtalet"
Assistenten använder live_chat_set_availability, live_chat_queue och live_chat_session_assign; svar går via live_chat_message_send.
Säkerhet
- API-nycklar är scope:ade till ert företag och till de behörigheter ni väljer när ni skapar dem (se kolumnen Scope ovan)
- Nycklar körs med företagsägarens behörigheter; planbegränsningar och funktionsgrindar gäller exakt som i instrumentpanelen
- Nycklar kan återkallas när som helst från instrumentpanelen
- API-åtkomst finns på betalda planer — se vår Pricing page
Felsökning
Anslutningen misslyckades
- Verifiera att er API-nyckel är korrekt
- Kontrollera att nyckeln inte har återkallats
- Säkerställ att er plan inkluderar API-åtkomst
- Starta om er MCP-klient
Verktyg hittades inte
Starta om er MCP-klient efter att ha ändrat konfigurationen så att den laddar om tillgängliga verktyg. Verktygsnamn är gemener med understreck (t.ex. faq_list).
Behöver ni hjälp? Kontakta vårt supportteam →