HomeDocumentatie

MCP Serverintegratie

ChatReact implementeert het Model Context Protocol (MCP), waarmee u uw ChatReact-account kunt verbinden met 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 ChatReact's MCP-integratie kunt u:

  • Chatbots beheren — instructies, persoonlijkheid en widgetinstellingen bijwerken
  • FAQ's maken en bijwerken met natuurlijke taal
  • Analyse, chatgeschiedenis en leads bekijken
  • Voorstellen van de Improvement Agent beoordelen en goedkeuren of afwijzen
  • Live chatsessies en de wachtrij monitoren

Aan de slag

1. Genereer een API-sleutel

  1. Ga naar uw DashboardCompanyAPI tab
  2. Klik op Create API Key
  3. Geef uw sleutel een beschrijvende naam (bijv. "Claude Desktop") en selecteer ten minste één permissie
  4. Kopieer de gegenereerde sleutel (begint met cr_)

API keys zijn beschikbaar op betaalde abonnementen — 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 is 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 externe 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 is geïnstalleerd. Het voorbeeld gebruikt de X-API-Key header omdat sommige clients moeite hebben met spaties in argumenten.

3. Herstart uw AI-assistent

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

Beschikbare tools

ChatReact MCP biedt een uitgebreide set tools, georganiseerd in categorieën:

Uw account

ToolBeschrijving
user_profileHaal uw profielinformatie op
user_companiesGeef de onderneming waar uw API-sleutel aan is gekoppeld weer
user_notificationsHaal uw recente meldingen op

Bedrijf & teambeheer

ToolBeschrijving
company_listGeef de onderneming waar uw API-sleutel aan is gekoppeld weer
company_getHaal details van een specifieke onderneming op
company_members_listLijst van bedrijfslidmaatschappen met hun rollen
company_chatbots_listLijst van alle chatbots voor een bedrijf
company_updateWerk bedrijfsnaam, beschrijving of instellingen bij

Chatbotbeheer

ToolBeschrijving
chatbot_listLijst van alle chatbots met samenvattende statistieken
chatbot_getHaal chatbotdetails en configuratie op
chatbot_get_instructionsHaal kerninstructies voor een chatbot op
chatbot_add_instructionVoeg een nieuwe kerninstructie toe
chatbot_update_instructionWerk een bestaande kerninstructie bij
chatbot_delete_instructionVerwijder een kerninstructie
chatbot_update_personalityWerk tonaliteit, taal en berichten bij
chatbot_toggle_activeActiveer of deactiveer een chatbot
chatbot_toggle_learningSchakel de leerfase in of uit
widget_settings_getHaal de huidige widgetinstellingen op
widget_settings_updateWerk de widgetweergave bij (kleuren, grootte, positie)

FAQ-beheer

ToolBeschrijving
faq_listLijst van alle FAQ's voor een chatbot
faq_getHaal FAQ-details op
faq_createMaak een nieuwe FAQ aan
faq_updateWerk een bestaande FAQ bij
faq_deleteVerwijder een FAQ
faq_categories_listLijst van FAQ-categorieën
faq_suggestions_listLijst van in behandeling zijnde FAQ-voorstellen gegenereerd uit chatgesprekken

Kennisbank

ToolBeschrijving
knowledge_documents_listLijst van documenten in de kennisbank van een chatbot
knowledge_document_getHaal details van een specifiek document op
knowledge_document_deleteVerwijder een document uit de kennisbank
knowledge_statsHaal statistieken van de kennisbank op

Websitecrawling wordt beheerd vanaf het dashboard — zie Knowledge Base.

Leadbeheer

ToolBeschrijving
lead_listLijst met leads met optionele filtering op status of categorie
lead_getHaal volledige leaddetails op inclusief de bron-chatsessie
lead_updateWerk de status, categorie of notities van een lead bij
lead_deleteVerwijder een lead permanent
lead_categories_listLijst van leadcategorieën
lead_statsHaal leadstatistieken op inclusief aantallen per status
lead_field_config_getHaal de configuratie van velden voor leadcaptatie op

Chatgeschiedenis

ToolBeschrijving
chat_sessions_listLijst van chatsessies met optionele filters
chat_session_getHaal een chatsessie op met alle berichten
chat_session_searchDoorzoek chatsessies op berichtinhoud of bezoekerinfo

Analyse

ToolBeschrijving
analytics_overviewHaal chataantallen, berichtenaantallen en tevredenheidspercentages op
analytics_chat_volumeHaal chatvolume over tijd op voor grafieken en trends

Improvement Agent

ToolBeschrijving
improvement_sessions_listLijst van improvement-sessies
improvement_session_getHaal sessiedetails op inclusief voorstellen
improvement_proposals_pendingLijst van in afwachting zijnde voorstellen die beoordeling vereisen
improvement_proposal_approveKeur een voorstel goed en pas de wijziging toe
improvement_proposal_rejectWeiger een voorstel

Live Chat

ToolBeschrijving
live_chat_sessions_listLijst van live chatsessies
live_chat_session_getHaal een live chatsessie op met alle berichten
live_chat_queueHaal sessies op die wachten op een agent

Live chat-tools zijn alleen-lezen. Om rechtstreeks met bezoekers te chatten, gebruikt u het Live Chat dashboard.

Voorbeeldworkflows

Een kerninstructie toevoegen

Vraag uw AI-assistent:

"Voeg een kerninstructie toe aan mijn 'Support Bot' chatbot: we bieden gratis verzending bij bestellingen boven de €50"

De assistent zal chatbot_add_instruction gebruiken met de juiste parameters.

Voorstellen van Improvement beoordelen

"Toon mij alle in behandeling zijnde 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 goedkeuren of afwijzen met improvement_proposal_approve of improvement_proposal_reject

Chatprestaties analyseren

"Geef mij een wekelijkse rapportage van chatvolume en klanttevredenheid voor mijn chatbot"

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

Beveiliging

  • API-sleutels zijn gekoppeld aan uw bedrijf
  • Sleutels kunnen op elk moment worden ingetrokken via het dashboard
  • API-toegang is beschikbaar op betaalde abonnementen — 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 abonnement API-toegang bevat
  4. Herstart uw MCP-client

Tool niet gevonden

Herstart uw MCP-client nadat u de configuratie hebt gewijzigd, zodat deze de beschikbare tools opnieuw inlaadt. Tool-namen zijn kleine letters met underscores (bijv. faq_list).


Hulp nodig? Neem contact op met ons supportteam →