HomeDocumentatie

MCP Serverintegratie

ChatReact implementeert het Model Context Protocol (MCP), waarmee u uw ChatReact-account kunt koppelen aan AI-assistenten zoals Claude Desktop, Cursor en andere MCP-compatibele tools.

Wat is MCP?

Het Model Context Protocol is een open standaard die AI-assistenten in staat stelt te communiceren met externe services en gegevensbronnen. Met de MCP-integratie van ChatReact kunt u:

  • Chatbots beheren — chatbots aanmaken, configureren (persona, talen, widget, gedrag, beperkingen), embedden en verwijderen
  • De kennisbank opbouwen — documenten toevoegen, websites crawlen, gecrawlde pagina's beheren en kerninstructies
  • FAQ's beheren — FAQ's, categorieën, suggesties, vertalingen en de FAQ-widget
  • Chats beoordelen — gesprekken beoordelen, confidence-categorieën toewijzen, de Improvement Agent uitvoeren
  • Werken met leads en formulieren — leads, leadcategorieën, capture-instellingen, contactformulieren en inzendingen
  • Optreden als livechat-agent — uw beschikbaarheid instellen, wachtende chats overnemen, antwoorden en sessies sluiten
  • Uw bedrijf beheren — profiel, merk-kleuren, teamleden en uitnodigingen
  • De Email Assistant gebruiken — mailbox-verbindingen, categorieën, contacten en activiteiten
  • Analytics en meldingen lezen

Alles wat u in het dashboard kunt doen is beschikbaar via MCP (en de REST API); alleen browsergebonden acties zoals betalingen, mailbox OAuth, passkeys, accountverwijdering en API-sleutelbeheer blijven in het dashboard.

Aan de slag

1. Maak een API-sleutel aan

  1. Navigeer naar uw Dashboard → Bedrijf → API tab
  2. Klik op API-sleutel aanmaken
  3. Geef uw sleutel een beschrijvende naam (bijv. "Claude Desktop") en selecteer minimaal één machtiging
  4. Kopieer de gegenereerde sleutel (begint met cr_)

API-sleutels zijn beschikbaar op betaalde plannen — zie onze Pricing page.

Bewaar uw API-sleutel veilig. Deze kan niet worden opgehaald nadat deze is aangemaakt.

2. Configureer uw MCP-client

De ChatReact MCP-server wordt gehost op https://www.chatreact.ai/api/mcp en communiceert via HTTP (JSON-RPC). Authenticeer met een Authorization: Bearer header — een X-API-Key header met dezelfde sleutel wordt ook geaccepteerd.

Cursor IDE

Cursor ondersteunt remote MCP-servers direct. Voeg toe aan uw Cursor MCP-instellingen:

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

Claude Desktop

Het configuratiebestand van Claude Desktop ondersteunt command-based servers, dus gebruik de standaard mcp-remote bridge om verbinding te maken met het gehoste eindpunt:

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"
      ]
    }
  }
}

Deze setup vereist dat Node.js geïnstalleerd is. Het voorbeeld gebruikt de X-API-Key header omdat sommige clients niet betrouwbaar omgaan met spaties in argumenten.

3. Start uw AI-assistent opnieuw

Na het opslaan van de configuratie, start Claude Desktop of Cursor opnieuw om de verbinding tot stand te brengen.

Beschikbare tools

ChatReact MCP biedt onderstaande tools aan, gegroepeerd per gebied. De Scope-kolom toont welke API-sleutelmachtiging een tool vereist (any = elke geldige sleutel). Tools draaien met dezelfde toepasselijke machtigingen, planlimieten en bijwerkingen als de ondersteunde dashboard-acties. Browsergebonden workflows voor betalingen, mailbox-autorisatie, passkeys, accountverwijdering en sleutelbeheer blijven in het dashboard.

Destructieve tools (verwijderen, resetten, sluiten, samenvoegen) vragen om bevestiging wanneer ze via de Dashboard Assistant worden gebruikt. Via een API-sleutel voeren ze direct uit.

Account

ToolDescriptionScope
account_usage_getHaal het huidige plan op (tier, status), de gebruikstellers van de huidige factureringsperiode (companies, chatbots, team members, chats, tokens) en de planlimieten, plus de effectieve limieten en featureflags van het bedrijf waar het verzoek op is gescopeerd.any
user_companiesGeef een lijst van alle companies waar de huidige gebruiker toegang toe heeft, met de rol van de gebruiker in elk.any
user_notification_mark_readMarkeer een van de meldingen van de huidige gebruiker als gelezen.any
user_notification_preferences_getHaal de meldingsvoorkeuren van de huidige gebruiker op: globale e-mail/push schakelaars, digest frequentie/tijd/weekdag/tijdszone, quiet hours en per-type kanaalinstellingen.any
user_notification_preferences_updateWerk de globale meldingsvoorkeuren van de huidige gebruiker bij (e-mail/push schakelaars, digest schema, quiet hours).any
user_notification_type_setting_updateSchakel e-mail / in-app bezorging in of uit voor één notificatietype van de huidige gebruiker (bijv.any
user_notification_types_listGeef alle notificatietypes gegroepeerd per categorie (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countHaal het aantal ongelezen meldingen van de huidige gebruiker op.any
user_notificationsGeef de meldingen van de huidige gebruiker, nieuwste eerst, met cursor-paginatie.any
user_notifications_delete_oldHousekeeping: verwijder permanent de meldingen van de huidige gebruiker die al gelezen en ouder zijn dan 30 dagen.any
user_notifications_mark_all_readMarkeer alle meldingen van de huidige gebruiker als gelezen.any
user_profileHaal het profiel van de huidige gebruiker op (id, naam, e-mail, rol, abonnementsniveau).any

Company & Team

ToolDescriptionScope
company_chatbots_listGeef een lijst van alle chatbots voor een specifiek bedrijf met samenvattende statistieken.chatbots:read
company_getHaal gedetailleerde informatie over een bedrijf op: profiel, eigenaar, merk-instellingen (kleuren, notificatie-e-mail) en aantallen.any
company_invite_cancelAnnuleer (verwijder) een teamuitnodiging zodat de link niet meer werkt.company:write
company_invite_resendVerstuur een openstaande teamuitnodiging opnieuw: maakt een nieuw token, verlengt de vervaltijd met 7 dagen en stuurt de uitnodigingsmail opnieuw.company:write
company_invites_listGeef de teamuitnodigingen van een bedrijf weer (standaard pending; zet includeExpired om ook verlopen uit te geven).company:read
company_listGeef alle companies weer waar de gebruiker toegang toe heeft (API-sleutels en de Dashboard Assistant zien alleen hun eigen bedrijf).any
company_logo_removeVerwijder het bedrijfslogo (verwijdert de opgeslagen afbeelding en wist de logo-URL).company:write
company_member_inviteNodig een teamlid uit per e-mail met een rol (ADMIN, MANAGER, AGENT of VIEWER).company:write
company_member_removeVerwijder een teamlid uit het bedrijf.company:write
company_member_update_roleWijzig de rol van een teamlid (ADMIN, MANAGER, AGENT of VIEWER).company:write
company_members_listGeef de leden van een bedrijf met hun rollen weer (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateWerk de merk-instellingen van het bedrijf bij: primaryColor / secondaryColor (#RRGGBB) en de notificationEmail voor chatreviews.company:write
company_updateWerk het bedrijfsprofiel bij: naam (2-100 tekens), beschrijving (max 1000 tekens) of website (https:// wordt automatisch toegevoegd; geef een lege string om website/beschrijving te wissen).company:write

Chatbotbeheer

ToolDescriptionScope
chatbot_add_instructionVoeg een nieuwe core-instructie toe aan een chatbot (1-5000 tekens).chatbots:write
chatbot_confirm_embedMarkeer een chatbot als embedded op de website (verbergt de setup-herinnering in het dashboard).chatbots:write
chatbot_createMaak een nieuwe chatbot aan (zelfde als de dashboard-wizard).chatbots:write
chatbot_deleteVerwijder een chatbot permanent met al zijn FAQ's, documenten, chats, leads en formulieren (onherroepelijk).chatbots:write
chatbot_delete_instructionVerwijder een core-instructie uit een chatbot.chatbots:write
chatbot_getHaal gedetailleerde informatie over een chatbot op: algemene instellingen, persoonlijkheid (persona, tonality, talen, beperkingen), widget-instellingen, live chat, leerfase, embed-status en aantallen.chatbots:read
chatbot_get_embed_codeHaal de HTML-snippet op om een chatbot op een website te installeren (script-URL + <script> tag) en of de embed bevestigd is.chatbots:read
chatbot_get_instructionsHaal alle core-instructies voor een chatbot op.chatbots:read
chatbot_improve_instructionsHerschrijf core-instructietekst met de AI-verbeteraar van het platform (zelfde als 'Improve with AI' in het dashboard).chatbots:write
chatbot_learning_phase_getHaal de instellingen van de leerfase van een chatbot op: behaviour preset (CAUTIOUS, BALANCED, CONFIDENT), custom prompt en of de bot nog in de leerfase is.chatbots:read
chatbot_learning_phase_updateStel de behaviour preset van de leerfase in (CAUTIOUS = verwijs naar een mens wanneer onzeker, BALANCED, CONFIDENT) en/of een custom learning-phase prompt.chatbots:write
chatbot_listGeef een lijst van alle chatbots waar de gebruiker toegang toe heeft, met samenvattende statistieken.chatbots:read
chatbot_reorder_instructionsStel de volgorde van de core-instructies van een chatbot in.chatbots:write
chatbot_templates_listGeef de chatbot-templates (presets voor persona, tonality, berichten en widget-gedrag) die als templateId naar chatbot_create kunnen worden gestuurd, en of het bedrijf deze volgens het plan mag gebruiken.chatbots:read
chatbot_toggle_activeActiveer of deactiveer een chatbot.chatbots:write
chatbot_toggle_learningBeëindig (false) of heractiveer (true) de leerfase van een chatbot.chatbots:write
chatbot_updateWerk de algemene instellingen van een chatbot bij: naam, beschrijving, isActive, live chat (liveChatEnabled/liveChatMode, plan-feature), showBranding (white-label plannen), chat-review e-mails, FAQ-auto-generation, legacy coreInstructions tekst, leerfase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionWerk een bestaande core-instructie bij (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityWerk de persoonlijkheid van een chatbot bij: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality sliders 1-5, talen (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), berichten (welcomeMessage, fallbackMessage, proactive greeting) en beperkingen (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getHaal de huidige widget-instellingen van een chatbot op (alle appearance, branding, behaviour en pre-chat form velden).chatbots:read
widget_settings_updateWerk de chat-widget van een chatbot bij: positie (incl.chatbots:write
widget_translations_getHaal de per-taal widget-vertalingen van een chatbot op: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateStel per-taal widget-vertalingen in.chatbots:write

Kennisbank

ToolDescriptionScope
crawler_job_cancelAnnuleer een PENDING of RUNNING crawl-job; resterende pagina's worden overgeslagen.knowledge:write
crawler_job_getHaal de status van een crawl-job op, voortgang (pagesCrawled/pagesFound, tokensUsed) en de status van elke pagina.knowledge:read
crawler_jobs_listGeef de crawl-jobs van een chatbot weer (nieuwste eerst) met status en voortgang.knowledge:read
crawler_limitsHaal de crawl-limieten van het plan voor een chatbot op (max pagina's per crawl, tokens per pagina, crawls per maand) en of er deze maand een nieuwe crawl gestart kan worden.knowledge:read
crawler_preview_scanScan een website en geef de crawlbare pagina's weer (url, titel, isRecommended) zonder iets te importeren.knowledge:write
crawler_startStart een crawl-job die de geselecteerde URL's importeert in de kennisbank van de chatbot (verwerkt op de achtergrond; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlDownload een document (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) vanaf een publieke http(s)-URL en voeg het toe aan de kennisbank van een chatbot.knowledge:write
knowledge_document_add_textVoeg een tekst- of markdown-document toe aan de kennisbank van een chatbot vanuit inline content (max 10 MB).knowledge:write
knowledge_document_deleteVerwijder een geüpload document uit de kennisbank.knowledge:write
knowledge_document_getHaal details op van een geüpload document inclusief verwerkingsstatus, foutmelding en een kortstondige download-URL.knowledge:read
knowledge_documents_listGeef de geüploade documenten (PDF, TXT, MD, CSV, JSON, DOCX) in de kennisbank van een chatbot weer met status en grootte.knowledge:read
knowledge_page_addCrawlt een enkele URL en voeg deze toe aan de kennisbank van de chatbot (faalt met CONFLICT wanneer de URL al geïndexeerd is, FORBIDDEN wanneer de tokenlimiet is bereikt).knowledge:write
knowledge_page_deleteVerwijder een gecrawlde pagina uit de kennisbank (verwijdert het vector-store bestand).knowledge:write
knowledge_page_getHaal een gecrawlde pagina op inclusief de markdown-inhoud die voor de chatbot is geïndexeerd (handig om te verifiëren wat de bot over een pagina weet).knowledge:read
knowledge_page_recrawlHaal een gecrawlde pagina opnieuw op en vervang de geïndexeerde inhoud (bijv.knowledge:write
knowledge_pages_deleteVerwijder meerdere gecrawlde pagina's van een chatbot in één keer.knowledge:write
knowledge_pages_listGeef gecrawlde pagina's in de kennisbank van een chatbot weer, eventueel gefilterd op domein, status of een zoekterm (URL/titel).knowledge:read
knowledge_statsOverzicht van de kennisbank van een chatbot: documenten (per status, grootte), gecrawlde pagina's en websites (per status), crawl-jobs, core-instructies uitgesplitst op bron (handmatig vs improvement agent), FAQ's, vector store status/grootte en opslaggebruik vs.knowledge:read
knowledge_website_deleteVerwijder alle gecrawlde pagina's van een website (domein) uit de kennisbank van de chatbot.knowledge:write
knowledge_website_recrawlHer-crawl elke pagina van een website (domein) in de kennisbank van de chatbot om de inhoud te verversen.knowledge:write
knowledge_website_recrawl_cancelAnnuleer een lopende website re-crawl: in de wachtrij staande (PENDING) pagina's van het domein worden teruggezet naar hun vorige geïndexeerde staat.knowledge:write
knowledge_websites_listGeef de websites (domeinen) weer waarvan pagina's in de kennisbank van een chatbot staan, met paginatellingen per status en tokentotalen.knowledge:read

Prijsbeheer

Deze tools beheren gestructureerde prijsconcepten en expliciete goedkeuringen. Het opslaan van een concept is los van het goedkeuren van de exacte versie; geschiktheid hangt ook af van status en geldigheid. Bestaande API-sleutels krijgen niet automatisch prijs-machtigingen. Alleen de bedrijfs-eigenaar kan prices:write of prices:approve toekennen. API-sleutel-aanroepen voeren direct uit, controleer daarom de exacte invoer voordat u een mutatie aanroept. Zie Prices & services voor de klantworkflow.

ToolDescriptionScope
price_listPaginering door price heads en afzonderlijke geschiktheid voor goedgekeurde versies.prices:read
price_getLees volledige itemstatus en revisies.prices:read
price_detailLees itemdetail met gepagineerde revisiegeschiedenis.prices:read
price_suggestions_listPaginering door prijsvoorstellen.prices:read
price_createMaak een concept aan met een server-gegenereerde item-ID.prices:write
price_editMaak een nieuw concept vanaf een expliciet verwachte itemversie.prices:write
price_import_csvImporteer concepten met een expliciet formaat en stabiele import-ID voor veilige retries.prices:write
price_suggestion_applyPas de geselecteerde suggestie-kandidaat toe als concept.prices:write
price_approveKeur één expliciet verwachte itemversie goed.prices:approve
price_approve_manyKeur een expliciete ID/versie-selectie atomair goed; elke verouderde versie verwerpt de hele selectie.prices:approve
price_archiveArchiveer een item op zijn expliciet verwachte versie.prices:approve

Bewerking van concepten behoudt de eerder goedgekeurde revisie. CSV-formaat en decimaalscheider moeten expliciet zijn; gewijzigde CSV-inhoud vereist een nieuwe import-ID. Alle bewerkingen zijn gebonden aan het bedrijf van de API-sleutel en de opgegeven chatbot.

FAQ-beheer

ToolDescriptionScope
faq_cache_purgeMaak de gecachte FAQ-widget data op alle gekoppelde CMS-sites leeg (WordPress-plugin).faqs:write
faq_categories_listGeef de FAQ-categorieën van een chatbot weer met hun FAQ-aantallen, slugs, sorteermodus en vertalingen.faqs:read
faq_categories_reorderStel de volgorde van FAQ-categorieën in de widget in: positie in categoryIds wordt sortOrder.faqs:write
faq_category_createMaak een FAQ-categorie voor een chatbot aan (slug wordt gegenereerd uit de naam).faqs:write
faq_category_deleteVerwijder een FAQ-categorie.faqs:write
faq_category_translations_updateVervang de vertalingen van een FAQ-categorie, bijv.faqs:write
faq_category_updateHernoem een FAQ-categorie of wijzig de beschrijving, icoon of sorteermodus.faqs:write
faq_createMaak een FAQ voor een chatbot aan.faqs:write
faq_deleteVerwijder een FAQ permanent (verwijdert deze ook uit de kennisbank van de chatbot en purgeert CMS-widget-caches).faqs:write
faq_embed_code_getHaal de embed-snippets op voor de FAQ-widget: script-tag, WordPress-shortcode en Shopify Liquid-snippet, plus per-categorie varianten (gebruik categorySlug van faq_categories_list om slechts één categorie te embedden).chatbots:read
faq_getHaal de volledige details van een FAQ op: vraag, antwoord, categorie, publicatiestatus, sorteerorde, vertalingen, SEO-velden en feedbackstatistieken.faqs:read
faq_listGeef de FAQ's van een chatbot weer (gebruik chatbot_list om de chatbotId te vinden).faqs:read
faq_reorderStel de weergavevolgorde van FAQ's in de widget in.faqs:write
faq_suggestion_approveKeur een PENDING FAQ-suggestie goed: maakt een gepubliceerde FAQ (optioneel met bewerkte vraag/antwoord/categorie) en markeert de suggestie als APPROVED.faqs:write
faq_suggestion_getHaal de volledige details van een FAQ-suggestie op (compleet antwoord, AI-redenering, voorgestelde categorie, review-state).faqs:read
faq_suggestion_rejectWeiger een PENDING FAQ-suggestie met een optionele reden.faqs:write
faq_suggestions_generateLaat de AI nieuwe FAQ's voorstellen uit de kennisbank van de chatbot (gecrawlde pagina's / geüploade documenten), optioneel voor één categorie.faqs:write
faq_suggestions_listGeef AI-gegenereerde FAQ-suggesties van een chatbot weer (uit chatgesprekken of faq_suggestions_generate).faqs:read
faq_translateVertaal de vraag en het antwoord van een FAQ met AI naar de andere ondersteunde talen van de chatbot (of de opgegeven targetLanguages) en sla het resultaat op.faqs:write
faq_translations_updateSla vertalingen van een FAQ per taal op, bijv.faqs:write
faq_updateWerk de vraag, het antwoord, de categorie, publicatiestatus of handmatige sorteerorde van een FAQ bij.faqs:write
faq_widget_settings_getHaal de weergave- en gedragsinstellingen van de embeddable FAQ-widget op (kleuren, border radius, titel, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, titelvertalingen).chatbots:read
faq_widget_settings_updateWerk de FAQ-widget instellingen bij: kleuren (hex), borderRadius 0-32, titel (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = volledige breedte), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name en titelvertalingen per taal.chatbots:write

Chatgeschiedenis & feedback

ToolDescriptionScope
chat_feedback_dismissMarkeer een chat als beoordeeld zonder het te beoordelen (haalt het uit de pending-queue, verandert de confidence-score niet).chats:write
chat_feedback_getHaal één chatreview (feedback) op met AI-analyse, severity, confidence-categorie, scorewijziging en de gekoppelde improvement-session.chats:read
chat_feedback_listGeef chatreviews (feedback-rijen) van een chatbot weer met statusfilter en aantallen.chats:read
chat_feedback_set_severityOverschrijf de severity-classificatie (MINOR|MODERATE|MAJOR|CRITICAL) van een beoordeelde negatieve chat; severity beïnvloedt de drop in confidence-score.chats:write
chat_feedback_statsSessietellingen per review-bucket voor een chatbot (totaal, none, pending, positive, negative, reviewed, improved) — de statkaarten van de dashboard chats-pagina.chats:read
chat_feedback_submitBeoordeel een chatsessie als Good (isPositive=true) of Needs Work (isPositive=false).chats:write
chat_session_getHaal een chatsessie op met de volledige transcriptie (per-bericht token/model/latency/pageUrl), bezoekergegevens, gestartde pagina-URL, confidence-categorie, feedback (severity, AI-analyse, gekoppelde improvement-session) en tags.chats:read
chat_session_searchDoorzoek chatsessies van een chatbot op berichtinhoud en/of bezoeker-e-mail.chats:read
chat_session_set_categoryWijs de confidence-categorie van een chatsessie toe of wijzig deze (corrigeert de AI-categorisatie; per-categorie confidence wordt opnieuw berekend wanneer de chat is beoordeeld).chats:write
chat_sessions_listGeef chatsessies van een chatbot weer, nieuwste eerst, met dezelfde review-queue filters als de dashboard chats-pagina.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listGeef de confidence-categorieën van een chatbot weer met per-categorie confidence-score, aantal reviews en review-e-mail frequentie.chats:read
confidence_category_createMaak een confidence-categorie voor een chatbot aan.chatbots:write
confidence_category_deleteVerwijder een confidence-categorie.chatbots:write
confidence_category_mergeMergeer één confidence-categorie in een andere van dezelfde chatbot: alle chats/reviews verplaatsen naar het doel, de bron wordt verwijderd en scores worden opnieuw berekend.chatbots:write
confidence_category_updateHernoem een confidence-categorie en/of stel de review-e-mail frequentie in (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 alleen voor HOURLY).chatbots:write
confidence_status_getConfidence-status van een chatbot: score, graduation threshold, learning-phase vlag, learning-phase behaviour (CAUTIOUS|BALANCED|CONFIDENT) en custom prompt, review-aantallen en per-categorie confidence-scores.analytics:read
improvement_proposal_approveKeur een PENDING improvement-voorstel goed en pas de wijziging toe op de chatbot (core-instructie toevoegen/bijwerken, FAQ aanmaken/bijwerken of persona bijwerken) — dezelfde logica en planlimieten als het dashboard.chatbots:write
improvement_proposal_rejectWeiger een PENDING improvement-voorstel.chatbots:write
improvement_proposal_simulateSimuleer hoe de chatbot zou antwoorden op het problematische bericht met een voorstel toegepast (origineel vs.chatbots:write
improvement_proposals_pendingGeef voorgestelde verbeteringen die wachten op beoordeling (status PENDING) weer, bedrijfbreed of voor één chatbot.chatbots:read
improvement_session_completeMarkeer een improvement-session als COMPLETED (de chat telt dan als Improved in de review-queue).chatbots:write
improvement_session_createOpen de Improvement Agent voor een chat die als Needs Work is beoordeeld.chatbots:write
improvement_session_getHaal een improvement-session op met de originele chat (berichten hebben een 1-gebaseerde index die bruikbaar is als targetMessageIndex), het agent-gesprek, alle voorstellen (met hun laatste simulatie) en simulaties.chatbots:read
improvement_session_resetHerstart een improvement-session: verwijdert alle agent-berichten, simulaties en PENDING/REJECTED voorstellen (toegepaste blijven behouden) en start een nieuwe conversatie.chatbots:write
improvement_session_send_messageStuur een bericht naar de Improvement Agent (beschrijf wat er mis was met het antwoord van de bot; optioneel targetMessageIndex = de 1-gebaseerde index van het botbericht in originalChat.messages).chatbots:write
improvement_sessions_listGeef improvement-sessies (Improvement Agent-gesprekken gestart vanuit negatieve chatreviews) weer voor een chatbot of het gehele bedrijf, nieuwste eerst, met aantal voorstellen.chatbots:read
improvement_simulation_assessBeoordeel een simulatie-resultaat: isApproved=true wanneer het gesimuleerde antwoord goed is (het voorstel kan dan worden toegepast), false wanneer het meer werk nodig heeft (comment 'almost' = bijna goed).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableHaal de livechat-beschikbaarheid van de huidige gebruiker op, de agenten die momenteel beschikbaar zijn voor live chat (fresh heartbeat, hetzelfde signaal dat de widget gebruikt) en of het plan van het bedrijf live chat bevat.chats:read
live_chat_heartbeatVernieuw de heartbeat voor de livechat-presence van de huidige gebruiker (alleen terwijl gemarkeerd als beschikbaar via live_chat_set_availability).chats:write
live_chat_message_sendStuur een bericht naar de bezoeker als de toegewezen agent.chats:write
live_chat_queueHaal de livechat-queue op: sessies die wachten op een agent, oudste eerst (FIFO).chats:read
live_chat_session_assignNeem een WAITING livechat-sessie uit de wachtrij: wijst deze toe aan de huidige gebruiker (bedrijfseigenaar voor API-sleutels) en meldt de bezoeker dat de agent is toegetreden.chats:write
live_chat_session_closeBeëindig een livechat-sessie als agent (elk niet-VIEWER lid van het bedrijf).chats:write
live_chat_session_getHaal een livechat-sessie op met bezoekerinfo, toegewezen agent, alle berichten en het voorgaande botgesprek (handoff-context).chats:read
live_chat_sessions_listGeef livechat-sessies weer (nieuwste eerst; WAITING-sessies oudste eerst) met optionele filters op chatbot, status en toegewezen agent.chats:read
live_chat_set_availabilitySchakel de 'Available for Live Chat' schakelaar van de huidige gebruiker voor een bedrijf.chats:write

Leads

ToolDescriptionScope
lead_assignWijs een lead toe aan een bedrijfslid of maak deze ongedaan (assignedToId: null).leads:write
lead_bulk_update_statusStel de status van meerdere leads tegelijk in (max 100).leads:write
lead_categories_listGeef de leadcategorieën van een chatbot weer met leadaantallen en de teamleden die per categorie worden geïnformeerd.leads:read
lead_category_assign_userVoeg een bedrijfslid toe aan de notificatielijst van een leadcategorie (of werk hun notificatievlaggen bij).leads:write
lead_category_createMaak een leadcategorie voor een chatbot aan.leads:write
lead_category_deleteVerwijder een leadcategorie.leads:write
lead_category_remove_userVerwijder een bedrijfslid uit de notificatielijst van een leadcategorie.leads:write
lead_category_updateWerk de naam, beschrijving en/of kleur van een leadcategorie bij.leads:write
lead_createMaak handmatig een lead aan (bijv.leads:write
lead_deleteVerwijder een lead permanent.leads:write
lead_field_config_getHaal de lead-capture configuratie van een chatbot op: velden (ids map naar keys in lead.data), bevestigingsbericht, veld/UI-vertalingen en AI-herkenningsinstellingen.leads:read
lead_field_config_updateWerk de lead-capture configuratie van een chatbot bij.leads:write
lead_getHaal volledige details van een lead op inclusief toegewezen persoon, categorie en de bron chattranscriptie (gepaged met messageOffset/messageLimit, standaard de eerste 20 berichten).leads:read
lead_listGeef leads van een chatbot weer (nieuwste eerst) met optionele filters op status, categorie, toegewezen persoon en vrije-tekst zoekopdracht (naam/e-mail/bedrijf).leads:read
lead_statsHaal lead-statistieken op voor een chatbot: aantallen per status, leads van de laatste 7 dagen en het conversiepercentage (procent).leads:read
lead_updateWerk de status, categorie, notities, vastgelegde data en/of toegewezen persoon van een lead bij.leads:write

Formulieren

ToolDescriptionScope
form_createMaak een contactformulier voor een chatbot aan (basis, velden, ontwerp en spam-instellingen in één call).forms:write
form_deleteVerwijder een contactformulier permanent en ALLE inzendingen (cascade).forms:write
form_getHaal een contactformulier volledig op: velden, vertalingen, styling, spam-instellingen, actieve status, aantal inzendingen en de embed script-tag (embedCode).forms:read
form_listGeef de contactformulieren van een chatbot weer met veldaantallen, inzendingsaantallen en embed-codes.forms:read
form_statsInzendingsaantallen van een contactformulier: totaal, pending, approved, spam en rejected.forms:read
form_submission_deleteVerwijder permanent een contactformulierinzending (bijv.forms:write
form_submission_getHaal een contactformulierinzending volledig op: ingediende velddata, spam-score en AI-spam-analyse, IP/user agent/referrer-metadata en reviewinformatie.forms:read
form_submission_update_statusBeoordeel een contactformulierinzending: zet de status op APPROVED, SPAM of REJECTED met een optionele review-opmerking.forms:write
form_submissions_listGeef inzendingen van een contactformulier weer, nieuwste eerst, eventueel gefilterd op status (PENDING, APPROVED, SPAM, REJECTED) en creatiedatum.forms:read
form_updateWerk een contactformulier bij: naam, beschrijving, actieve status (isActive bepaalt of de embed rendert), velden (volledige vervanging), ontwerp (kleuren, knoptekst, succesbericht) en spam-instellingen (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsVervang de veld- en/of UI-vertalingen van een contactformulier.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listGeef het verwerkte-e-mail activiteitlogboek van een mailbox-verbinding weer (nieuwste eerst): afzender, onderwerp, toegewezen categorie, resultaat (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) en outcomeDetail.email:read
email_categories_listGeef de e-mailcategorieën van een mailbox-verbinding weer (gesorteerd op sortOrder).email:read
email_category_createMaak een e-mailcategorie voor een mailbox-verbinding aan (max 20 per verbinding).email:write
email_category_deleteVerwijder een e-mailcategorie.email:write
email_category_updateWerk een e-mailcategorie bij (gedeeltelijk: alleen de opgegeven velden wijzigen).email:write
email_connection_disconnectVerbreek een mailbox permanent.email:write
email_connection_getHaal een mailbox-verbinding op incl.email:read
email_connection_updateWerk een mailbox-verbinding bij: pauzeer/herstelt de sync (paused true/false; schakelt alleen ACTIVE<->DISABLED, overschrijft nooit TOKEN_EXPIRED/ERROR), schakel reply drafting (draftingEnabled) en categorizing/organizing (organizingEnabled) in/uit, verander de powering chatbot (chatbotId van hetzelfde bedrijf) of stel de HTML-reply-handtekening in (signatureHtml, max 20000 tekens; lege string wist deze).email:write
email_connections_listGeef de mailbox-verbindingen van het bedrijf voor de Email Assistant weer (adres, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, laatste sync, laatste fout, drafting/organizing schakelaars, powering chatbot, draftReadyCategoryCount = categorieën die drafts kunnen opleveren, baseRuleCount = chatbot-brede 'Chat + Email' regels toegepast op elke draft) samen met de planlimieten (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteVerwijder een geleerd e-mailcontact (vergeet het profiel van de afzender, bijv.email:write
email_contact_getHaal een geleerd e-mailcontact op met alle geleerde feiten, interne notities, relatie, formeel/informeel adres-instelling en e-mailstatistieken.email:read
email_contact_updateWerk een geleerd e-mailcontact bij.email:write
email_contacts_listGeef de geleerde e-mailcontacten van het bedrijf weer (meest recente e-mail eerst) met relatie, formeel/informeel adres (formalAddress: true = formeel 'Sie', false = informeel 'Du', null = automatisch), aantal feiten en een notitie-preview.email:read
email_folder_createMaak een mailmap onder de inbox aan (geeft de bestaande terug als de naam reeds bestaat) om te gebruiken als verplaatsdoel voor categorieën.email:write
email_folders_listGeef de mappen weer waarin een e-mailcategorie mail naartoe kan verplaatsen, live vanaf de mailbox: inbox-subfolders, custom top-level folders, archive, junk en trash (id 'deleteditems').email:read
email_general_rules_listGeef de chatbot-brede regels weer die van toepassing zijn op elke reply-draft van een mailbox: actieve core-instructies met channel BOTH ("Chat + Email"), plus legacy e-mail-only regels die nog niet in een categorie zijn gemigreerd.email:read

Analytics

ToolDescriptionScope
analytics_chat_volumeChatvolume (gestarte sessies) over tijd voor grafieken en trends: period week/month/quarter/year, granulariteit hour/day/week/month, optioneel voor één chatbot.analytics:read
analytics_chatbot_statsPer-chatbot prestaties van een bedrijf in één call (de chatbot performance-tabel van het dashboard): id, naam, slug, isActive, sessies, berichten, FAQ's en leads per chatbot, gesorteerd op sessies.analytics:read
analytics_formsStatistieken voor contactformulierinzendingen voor een bedrijf of één chatbot (dashboard analytics-widget): inzendingen per status (pending/approved/rejected/spam), aantal formulieren, totaal, spampercentage en de inzendingen-per-dag reeks van de laatste 7 dagen.analytics:read
analytics_leadsLead-funnel voor een bedrijf of één chatbot (dashboard analytics-widget): leads per status (new/contacted/qualified/converted/lost), totaal, conversiepercentage en de leads-per-dag reeks van de laatste 7 dagen.analytics:read
analytics_overviewAnalytics-overzicht voor een bedrijf of één chatbot: chats, berichten, satisfaction rate en topvragen voor een rollende periode (day/week/month/year), plus de dashboard-overview widget (totaal chatbots/published FAQ's/leads, sessies vandaag/deze week/deze maand, leads vandaag/deze week, formulierinzendingen totaal/vandaag/pending).analytics:read
dashboard_activityWat momenteel aandacht nodig heeft (de dashboard-home view): per bedrijf de chatbots met nieuwe leads vandaag, pending FAQ-suggesties, pending formulierinzendingen, wachtende/actieve live chats of een lopende leerfase.any

Voorbeeldworkflows

Een core-instructie toevoegen

Vraag uw AI-assistent:

"Voeg een core-instructie toe aan mijn 'Support Bot' chatbot: we bieden gratis verzending voor bestellingen boven €50"

De assistent zal chatbot_add_instruction gebruiken met de juiste parameters.

Improvement-suggesties beoordelen

"Toon alle pending improvement-voorstellen voor mijn chatbot en leg uit welke wijzigingen ze voorstellen"

De assistent zal:

  1. improvement_proposals_pending gebruiken om voorstellen op te halen
  2. Elke suggestie analyseren en samenvatten
  3. Ze namens u goed- of afkeuren met improvement_proposal_approve of improvement_proposal_reject

Chatprestaties analyseren

"Geef mij een wekelijk rapport van chatvolume en klanttevredenheid voor mijn chatbot"

De assistent zal analytics_overview en analytics_chat_volume gebruiken om een uitgebreid rapport samen te stellen.

Een website importeren

"Scan https://example.com, importeer de product- en prijspagina's in mijn 'Support Bot' en vertel me wanneer de crawl klaar is"

De assistent zal crawler_preview_scan aanroepen, de relevante pagina's selecteren, de import starten met crawler_start en crawler_job_get pollen totdat de job is voltooid.

Leads en formulierinzendingen beoordelen

"Toon mij de nieuwe leads van deze week, wijs de gekwalificeerde toe aan Anna en keur de pending contactformulierinzendingen goed"

De assistent combineert lead_list, lead_assign, form_submissions_list en form_submission_update_status.

Een live chat overnemen

"Zet mij beschikbaar voor live chat en neem het oudste wachtende gesprek over"

De assistent gebruikt live_chat_set_availability, live_chat_queue en live_chat_session_assign; antwoorden verlopen via live_chat_message_send.

Beveiliging

  • API-sleutels zijn gescopeerd naar uw bedrijf en naar de permissie-scopes die u selecteert bij het aanmaken (zie de Scope-kolom hierboven)
  • Sleutels voeren uit met de machtigingen van de bedrijfseigenaar; planlimieten en feature-gates gelden precies zoals in het dashboard
  • Sleutels kunnen te allen tijde worden ingetrokken vanuit het dashboard
  • API-toegang is beschikbaar op betaalde plannen — zie onze Pricing page

Problemen oplossen

Verbinding mislukt

  1. Controleer of uw API-sleutel correct is
  2. Controleer of de sleutel niet is ingetrokken
  3. Zorg dat uw plan API-toegang bevat
  4. Start uw MCP-client opnieuw

Tool niet gevonden

Start uw MCP-client opnieuw nadat u de configuratie hebt gewijzigd, zodat deze de beschikbare tools opnieuw laadt. Tool-namen zijn lowercase met underscores (bijv. faq_list).


Hulp nodig? Neem contact op met ons supportteam →