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
- Navigeer naar uw Dashboard → Bedrijf → API tab
- Klik op API-sleutel aanmaken
- Geef uw sleutel een beschrijvende naam (bijv. "Claude Desktop") en selecteer minimaal één machtiging
- 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
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Haal 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_companies | Geef een lijst van alle companies waar de huidige gebruiker toegang toe heeft, met de rol van de gebruiker in elk. | any |
user_notification_mark_read | Markeer een van de meldingen van de huidige gebruiker als gelezen. | any |
user_notification_preferences_get | Haal 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_update | Werk de globale meldingsvoorkeuren van de huidige gebruiker bij (e-mail/push schakelaars, digest schema, quiet hours). | any |
user_notification_type_setting_update | Schakel e-mail / in-app bezorging in of uit voor één notificatietype van de huidige gebruiker (bijv. | any |
user_notification_types_list | Geef alle notificatietypes gegroepeerd per categorie (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Haal het aantal ongelezen meldingen van de huidige gebruiker op. | any |
user_notifications | Geef de meldingen van de huidige gebruiker, nieuwste eerst, met cursor-paginatie. | any |
user_notifications_delete_old | Housekeeping: verwijder permanent de meldingen van de huidige gebruiker die al gelezen en ouder zijn dan 30 dagen. | any |
user_notifications_mark_all_read | Markeer alle meldingen van de huidige gebruiker als gelezen. | any |
user_profile | Haal het profiel van de huidige gebruiker op (id, naam, e-mail, rol, abonnementsniveau). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Geef een lijst van alle chatbots voor een specifiek bedrijf met samenvattende statistieken. | chatbots:read |
company_get | Haal gedetailleerde informatie over een bedrijf op: profiel, eigenaar, merk-instellingen (kleuren, notificatie-e-mail) en aantallen. | any |
company_invite_cancel | Annuleer (verwijder) een teamuitnodiging zodat de link niet meer werkt. | company:write |
company_invite_resend | Verstuur een openstaande teamuitnodiging opnieuw: maakt een nieuw token, verlengt de vervaltijd met 7 dagen en stuurt de uitnodigingsmail opnieuw. | company:write |
company_invites_list | Geef de teamuitnodigingen van een bedrijf weer (standaard pending; zet includeExpired om ook verlopen uit te geven). | company:read |
company_list | Geef alle companies weer waar de gebruiker toegang toe heeft (API-sleutels en de Dashboard Assistant zien alleen hun eigen bedrijf). | any |
company_logo_remove | Verwijder het bedrijfslogo (verwijdert de opgeslagen afbeelding en wist de logo-URL). | company:write |
company_member_invite | Nodig een teamlid uit per e-mail met een rol (ADMIN, MANAGER, AGENT of VIEWER). | company:write |
company_member_remove | Verwijder een teamlid uit het bedrijf. | company:write |
company_member_update_role | Wijzig de rol van een teamlid (ADMIN, MANAGER, AGENT of VIEWER). | company:write |
company_members_list | Geef de leden van een bedrijf met hun rollen weer (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Werk de merk-instellingen van het bedrijf bij: primaryColor / secondaryColor (#RRGGBB) en de notificationEmail voor chatreviews. | company:write |
company_update | Werk 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
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Voeg een nieuwe core-instructie toe aan een chatbot (1-5000 tekens). | chatbots:write |
chatbot_confirm_embed | Markeer een chatbot als embedded op de website (verbergt de setup-herinnering in het dashboard). | chatbots:write |
chatbot_create | Maak een nieuwe chatbot aan (zelfde als de dashboard-wizard). | chatbots:write |
chatbot_delete | Verwijder een chatbot permanent met al zijn FAQ's, documenten, chats, leads en formulieren (onherroepelijk). | chatbots:write |
chatbot_delete_instruction | Verwijder een core-instructie uit een chatbot. | chatbots:write |
chatbot_get | Haal 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_code | Haal 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_instructions | Haal alle core-instructies voor een chatbot op. | chatbots:read |
chatbot_improve_instructions | Herschrijf core-instructietekst met de AI-verbeteraar van het platform (zelfde als 'Improve with AI' in het dashboard). | chatbots:write |
chatbot_learning_phase_get | Haal 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_update | Stel 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_list | Geef een lijst van alle chatbots waar de gebruiker toegang toe heeft, met samenvattende statistieken. | chatbots:read |
chatbot_reorder_instructions | Stel de volgorde van de core-instructies van een chatbot in. | chatbots:write |
chatbot_templates_list | Geef 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_active | Activeer of deactiveer een chatbot. | chatbots:write |
chatbot_toggle_learning | Beëindig (false) of heractiveer (true) de leerfase van een chatbot. | chatbots:write |
chatbot_update | Werk 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_instruction | Werk een bestaande core-instructie bij (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Werk 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_get | Haal de huidige widget-instellingen van een chatbot op (alle appearance, branding, behaviour en pre-chat form velden). | chatbots:read |
widget_settings_update | Werk de chat-widget van een chatbot bij: positie (incl. | chatbots:write |
widget_translations_get | Haal de per-taal widget-vertalingen van een chatbot op: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Stel per-taal widget-vertalingen in. | chatbots:write |
Kennisbank
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Annuleer een PENDING of RUNNING crawl-job; resterende pagina's worden overgeslagen. | knowledge:write |
crawler_job_get | Haal de status van een crawl-job op, voortgang (pagesCrawled/pagesFound, tokensUsed) en de status van elke pagina. | knowledge:read |
crawler_jobs_list | Geef de crawl-jobs van een chatbot weer (nieuwste eerst) met status en voortgang. | knowledge:read |
crawler_limits | Haal 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_scan | Scan een website en geef de crawlbare pagina's weer (url, titel, isRecommended) zonder iets te importeren. | knowledge:write |
crawler_start | Start 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_url | Download 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_text | Voeg een tekst- of markdown-document toe aan de kennisbank van een chatbot vanuit inline content (max 10 MB). | knowledge:write |
knowledge_document_delete | Verwijder een geüpload document uit de kennisbank. | knowledge:write |
knowledge_document_get | Haal details op van een geüpload document inclusief verwerkingsstatus, foutmelding en een kortstondige download-URL. | knowledge:read |
knowledge_documents_list | Geef 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_add | Crawlt 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_delete | Verwijder een gecrawlde pagina uit de kennisbank (verwijdert het vector-store bestand). | knowledge:write |
knowledge_page_get | Haal 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_recrawl | Haal een gecrawlde pagina opnieuw op en vervang de geïndexeerde inhoud (bijv. | knowledge:write |
knowledge_pages_delete | Verwijder meerdere gecrawlde pagina's van een chatbot in één keer. | knowledge:write |
knowledge_pages_list | Geef gecrawlde pagina's in de kennisbank van een chatbot weer, eventueel gefilterd op domein, status of een zoekterm (URL/titel). | knowledge:read |
knowledge_stats | Overzicht 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_delete | Verwijder alle gecrawlde pagina's van een website (domein) uit de kennisbank van de chatbot. | knowledge:write |
knowledge_website_recrawl | Her-crawl elke pagina van een website (domein) in de kennisbank van de chatbot om de inhoud te verversen. | knowledge:write |
knowledge_website_recrawl_cancel | Annuleer 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_list | Geef 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.
| Tool | Description | Scope |
|---|---|---|
price_list | Paginering door price heads en afzonderlijke geschiktheid voor goedgekeurde versies. | prices:read |
price_get | Lees volledige itemstatus en revisies. | prices:read |
price_detail | Lees itemdetail met gepagineerde revisiegeschiedenis. | prices:read |
price_suggestions_list | Paginering door prijsvoorstellen. | prices:read |
price_create | Maak een concept aan met een server-gegenereerde item-ID. | prices:write |
price_edit | Maak een nieuw concept vanaf een expliciet verwachte itemversie. | prices:write |
price_import_csv | Importeer concepten met een expliciet formaat en stabiele import-ID voor veilige retries. | prices:write |
price_suggestion_apply | Pas de geselecteerde suggestie-kandidaat toe als concept. | prices:write |
price_approve | Keur één expliciet verwachte itemversie goed. | prices:approve |
price_approve_many | Keur een expliciete ID/versie-selectie atomair goed; elke verouderde versie verwerpt de hele selectie. | prices:approve |
price_archive | Archiveer 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
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Maak de gecachte FAQ-widget data op alle gekoppelde CMS-sites leeg (WordPress-plugin). | faqs:write |
faq_categories_list | Geef de FAQ-categorieën van een chatbot weer met hun FAQ-aantallen, slugs, sorteermodus en vertalingen. | faqs:read |
faq_categories_reorder | Stel de volgorde van FAQ-categorieën in de widget in: positie in categoryIds wordt sortOrder. | faqs:write |
faq_category_create | Maak een FAQ-categorie voor een chatbot aan (slug wordt gegenereerd uit de naam). | faqs:write |
faq_category_delete | Verwijder een FAQ-categorie. | faqs:write |
faq_category_translations_update | Vervang de vertalingen van een FAQ-categorie, bijv. | faqs:write |
faq_category_update | Hernoem een FAQ-categorie of wijzig de beschrijving, icoon of sorteermodus. | faqs:write |
faq_create | Maak een FAQ voor een chatbot aan. | faqs:write |
faq_delete | Verwijder een FAQ permanent (verwijdert deze ook uit de kennisbank van de chatbot en purgeert CMS-widget-caches). | faqs:write |
faq_embed_code_get | Haal 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_get | Haal de volledige details van een FAQ op: vraag, antwoord, categorie, publicatiestatus, sorteerorde, vertalingen, SEO-velden en feedbackstatistieken. | faqs:read |
faq_list | Geef de FAQ's van een chatbot weer (gebruik chatbot_list om de chatbotId te vinden). | faqs:read |
faq_reorder | Stel de weergavevolgorde van FAQ's in de widget in. | faqs:write |
faq_suggestion_approve | Keur 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_get | Haal de volledige details van een FAQ-suggestie op (compleet antwoord, AI-redenering, voorgestelde categorie, review-state). | faqs:read |
faq_suggestion_reject | Weiger een PENDING FAQ-suggestie met een optionele reden. | faqs:write |
faq_suggestions_generate | Laat 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_list | Geef AI-gegenereerde FAQ-suggesties van een chatbot weer (uit chatgesprekken of faq_suggestions_generate). | faqs:read |
faq_translate | Vertaal 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_update | Sla vertalingen van een FAQ per taal op, bijv. | faqs:write |
faq_update | Werk de vraag, het antwoord, de categorie, publicatiestatus of handmatige sorteerorde van een FAQ bij. | faqs:write |
faq_widget_settings_get | Haal 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_update | Werk 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
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Markeer een chat als beoordeeld zonder het te beoordelen (haalt het uit de pending-queue, verandert de confidence-score niet). | chats:write |
chat_feedback_get | Haal één chatreview (feedback) op met AI-analyse, severity, confidence-categorie, scorewijziging en de gekoppelde improvement-session. | chats:read |
chat_feedback_list | Geef chatreviews (feedback-rijen) van een chatbot weer met statusfilter en aantallen. | chats:read |
chat_feedback_set_severity | Overschrijf de severity-classificatie (MINOR|MODERATE|MAJOR|CRITICAL) van een beoordeelde negatieve chat; severity beïnvloedt de drop in confidence-score. | chats:write |
chat_feedback_stats | Sessietellingen per review-bucket voor een chatbot (totaal, none, pending, positive, negative, reviewed, improved) — de statkaarten van de dashboard chats-pagina. | chats:read |
chat_feedback_submit | Beoordeel een chatsessie als Good (isPositive=true) of Needs Work (isPositive=false). | chats:write |
chat_session_get | Haal 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_search | Doorzoek chatsessies van een chatbot op berichtinhoud en/of bezoeker-e-mail. | chats:read |
chat_session_set_category | Wijs 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_list | Geef chatsessies van een chatbot weer, nieuwste eerst, met dezelfde review-queue filters als de dashboard chats-pagina. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Geef de confidence-categorieën van een chatbot weer met per-categorie confidence-score, aantal reviews en review-e-mail frequentie. | chats:read |
confidence_category_create | Maak een confidence-categorie voor een chatbot aan. | chatbots:write |
confidence_category_delete | Verwijder een confidence-categorie. | chatbots:write |
confidence_category_merge | Mergeer éé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_update | Hernoem 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_get | Confidence-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_approve | Keur 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_reject | Weiger een PENDING improvement-voorstel. | chatbots:write |
improvement_proposal_simulate | Simuleer hoe de chatbot zou antwoorden op het problematische bericht met een voorstel toegepast (origineel vs. | chatbots:write |
improvement_proposals_pending | Geef voorgestelde verbeteringen die wachten op beoordeling (status PENDING) weer, bedrijfbreed of voor één chatbot. | chatbots:read |
improvement_session_complete | Markeer een improvement-session als COMPLETED (de chat telt dan als Improved in de review-queue). | chatbots:write |
improvement_session_create | Open de Improvement Agent voor een chat die als Needs Work is beoordeeld. | chatbots:write |
improvement_session_get | Haal 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_reset | Herstart 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_message | Stuur 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_list | Geef 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_assess | Beoordeel 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
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Haal 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_heartbeat | Vernieuw 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_send | Stuur een bericht naar de bezoeker als de toegewezen agent. | chats:write |
live_chat_queue | Haal de livechat-queue op: sessies die wachten op een agent, oudste eerst (FIFO). | chats:read |
live_chat_session_assign | Neem 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_close | Beëindig een livechat-sessie als agent (elk niet-VIEWER lid van het bedrijf). | chats:write |
live_chat_session_get | Haal een livechat-sessie op met bezoekerinfo, toegewezen agent, alle berichten en het voorgaande botgesprek (handoff-context). | chats:read |
live_chat_sessions_list | Geef livechat-sessies weer (nieuwste eerst; WAITING-sessies oudste eerst) met optionele filters op chatbot, status en toegewezen agent. | chats:read |
live_chat_set_availability | Schakel de 'Available for Live Chat' schakelaar van de huidige gebruiker voor een bedrijf. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Wijs een lead toe aan een bedrijfslid of maak deze ongedaan (assignedToId: null). | leads:write |
lead_bulk_update_status | Stel de status van meerdere leads tegelijk in (max 100). | leads:write |
lead_categories_list | Geef de leadcategorieën van een chatbot weer met leadaantallen en de teamleden die per categorie worden geïnformeerd. | leads:read |
lead_category_assign_user | Voeg een bedrijfslid toe aan de notificatielijst van een leadcategorie (of werk hun notificatievlaggen bij). | leads:write |
lead_category_create | Maak een leadcategorie voor een chatbot aan. | leads:write |
lead_category_delete | Verwijder een leadcategorie. | leads:write |
lead_category_remove_user | Verwijder een bedrijfslid uit de notificatielijst van een leadcategorie. | leads:write |
lead_category_update | Werk de naam, beschrijving en/of kleur van een leadcategorie bij. | leads:write |
lead_create | Maak handmatig een lead aan (bijv. | leads:write |
lead_delete | Verwijder een lead permanent. | leads:write |
lead_field_config_get | Haal 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_update | Werk de lead-capture configuratie van een chatbot bij. | leads:write |
lead_get | Haal 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_list | Geef 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_stats | Haal lead-statistieken op voor een chatbot: aantallen per status, leads van de laatste 7 dagen en het conversiepercentage (procent). | leads:read |
lead_update | Werk de status, categorie, notities, vastgelegde data en/of toegewezen persoon van een lead bij. | leads:write |
Formulieren
| Tool | Description | Scope |
|---|---|---|
form_create | Maak een contactformulier voor een chatbot aan (basis, velden, ontwerp en spam-instellingen in één call). | forms:write |
form_delete | Verwijder een contactformulier permanent en ALLE inzendingen (cascade). | forms:write |
form_get | Haal een contactformulier volledig op: velden, vertalingen, styling, spam-instellingen, actieve status, aantal inzendingen en de embed script-tag (embedCode). | forms:read |
form_list | Geef de contactformulieren van een chatbot weer met veldaantallen, inzendingsaantallen en embed-codes. | forms:read |
form_stats | Inzendingsaantallen van een contactformulier: totaal, pending, approved, spam en rejected. | forms:read |
form_submission_delete | Verwijder permanent een contactformulierinzending (bijv. | forms:write |
form_submission_get | Haal een contactformulierinzending volledig op: ingediende velddata, spam-score en AI-spam-analyse, IP/user agent/referrer-metadata en reviewinformatie. | forms:read |
form_submission_update_status | Beoordeel een contactformulierinzending: zet de status op APPROVED, SPAM of REJECTED met een optionele review-opmerking. | forms:write |
form_submissions_list | Geef inzendingen van een contactformulier weer, nieuwste eerst, eventueel gefilterd op status (PENDING, APPROVED, SPAM, REJECTED) en creatiedatum. | forms:read |
form_update | Werk 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_translations | Vervang de veld- en/of UI-vertalingen van een contactformulier. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Geef 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_list | Geef de e-mailcategorieën van een mailbox-verbinding weer (gesorteerd op sortOrder). | email:read |
email_category_create | Maak een e-mailcategorie voor een mailbox-verbinding aan (max 20 per verbinding). | email:write |
email_category_delete | Verwijder een e-mailcategorie. | email:write |
email_category_update | Werk een e-mailcategorie bij (gedeeltelijk: alleen de opgegeven velden wijzigen). | email:write |
email_connection_disconnect | Verbreek een mailbox permanent. | email:write |
email_connection_get | Haal een mailbox-verbinding op incl. | email:read |
email_connection_update | Werk 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_list | Geef 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_delete | Verwijder een geleerd e-mailcontact (vergeet het profiel van de afzender, bijv. | email:write |
email_contact_get | Haal een geleerd e-mailcontact op met alle geleerde feiten, interne notities, relatie, formeel/informeel adres-instelling en e-mailstatistieken. | email:read |
email_contact_update | Werk een geleerd e-mailcontact bij. | email:write |
email_contacts_list | Geef 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_create | Maak 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_list | Geef 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_list | Geef 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
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Chatvolume (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_stats | Per-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_forms | Statistieken 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_leads | Lead-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_overview | Analytics-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_activity | Wat 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:
improvement_proposals_pendinggebruiken om voorstellen op te halen- Elke suggestie analyseren en samenvatten
- Ze namens u goed- of afkeuren met
improvement_proposal_approveofimprovement_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
- Controleer of uw API-sleutel correct is
- Controleer of de sleutel niet is ingetrokken
- Zorg dat uw plan API-toegang bevat
- 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 →