HomeDocumentation

Intégration MCP Server

ChatReact implémente le Model Context Protocol (MCP), vous permettant de connecter votre compte ChatReact à des assistants IA comme Claude Desktop, Cursor et autres outils compatibles MCP.

Qu'est-ce que le MCP ?

Le Model Context Protocol est une norme ouverte qui permet aux assistants IA d'interagir avec des services externes et des sources de données. Avec l'intégration MCP de ChatReact, vous pouvez :

  • Gérer les chatbots directement depuis votre assistant IA
  • Créer et mettre à jour des FAQ en langage naturel
  • Consulter les analytics et l'historique des conversations
  • Contrôler l'Improvement Agent pour l'optimisation des chatbots
  • Gérer les sessions de chat en direct sans quitter votre outil IA

Pour commencer

1. Générez une clé API

  1. Rendez-vous dans votre DashboardSettingsAPI Keys
  2. Cliquez sur Create API Key
  3. Donnez à votre clé un nom descriptif (par ex. « Claude Desktop »)
  4. Copiez la clé générée (commence par cr_)

Stockez votre clé API en lieu sûr. Elle ne peut pas être récupérée après sa création.

2. Configurez votre client MCP

Claude Desktop

Ajoutez ce qui suit dans le fichier de configuration de Claude Desktop :

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

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

Cursor IDE

Ajoutez à vos paramètres Cursor MCP :

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

Développement local (stdio)

Pour le développement local, vous pouvez utiliser notre package npm :

npm install -g @chatreact/mcp

Configurez dans votre client MCP :

{
  "mcpServers": {
    "chatreact": {
      "command": "chatreact-mcp",
      "args": ["--api-key", "cr_your_api_key_here"]
    }
  }
}

3. Redémarrez votre assistant IA

Après avoir enregistré la configuration, redémarrez Claude Desktop ou Cursor pour établir la connexion.

Outils disponibles

ChatReact MCP fournit plus de 30 outils organisés en catégories :

Gestion de l'entreprise et de l'équipe

ToolDescription
company_listLister toutes les entreprises auxquelles vous avez accès
company_getObtenir les détails d'une entreprise spécifique
company_team_listLister les membres de l'équipe d'une entreprise

Gestion des chatbots

ToolDescription
chatbot_listLister tous les chatbots d'une entreprise
chatbot_getObtenir les détails et la configuration d'un chatbot
chatbot_createCréer un nouveau chatbot
chatbot_updateMettre à jour les paramètres du chatbot
chatbot_get_instructionsObtenir les instructions principales d'un chatbot
chatbot_add_instructionAjouter une nouvelle instruction principale

Gestion des FAQ

ToolDescription
faq_listLister toutes les FAQ d'un chatbot
faq_getObtenir les détails d'une FAQ
faq_createCréer une nouvelle FAQ
faq_updateMettre à jour une FAQ existante
faq_deleteSupprimer une FAQ
faq_categories_listLister les catégories de FAQ
faq_suggestGénérer des FAQ suggérées par l'IA

Base de connaissances

ToolDescription
knowledge_list_documentsLister les documents téléchargés
knowledge_list_websitesLister les sites web crawlés
knowledge_crawl_websiteDémarrer un crawl de site web
knowledge_get_crawl_statusVérifier l'avancement du crawl

Analytics

ToolDescription
analytics_overviewObtenir les métriques de performance globales
analytics_chat_volumeObtenir le volume de chats au fil du temps
analytics_feedbackObtenir les retours et évaluations
analytics_chat_historyParcourir les sessions de chat
analytics_get_sessionObtenir les données détaillées d'une session

Improvement Agent

ToolDescription
improvement_list_sessionsLister les sessions d'amélioration
improvement_start_sessionDémarrer une nouvelle session d'analyse
improvement_list_proposalsLister les propositions d'amélioration
improvement_get_proposalObtenir les détails d'une proposition
improvement_create_proposalCréer une proposition personnalisée
improvement_simulate_proposalPrévisualiser les effets d'une proposition
improvement_apply_proposalAppliquer une proposition
improvement_reject_proposalRejeter une proposition

Live Chat

ToolDescription
livechat_get_queueObtenir les sessions de chat en attente
livechat_get_active_sessionsLister les sessions actives avec agent humain
livechat_get_sessionObtenir les détails d'une session
livechat_assign_sessionVous assigner à une session
livechat_send_messageEnvoyer un message en tant qu'agent
livechat_close_sessionClore une session de chat
livechat_check_availabilityVérifier la disponibilité des agents

Exemples de workflows

Création d'un nouveau chatbot

Demandez à votre assistant IA :

"Create a new chatbot called 'Support Bot' for my company 'acme-corp' with a friendly, professional tone"

L'assistant utilisera chatbot_create avec les paramètres appropriés.

Revue des suggestions d'amélioration

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

L'assistant va :

  1. Utiliser improvement_list_proposals pour récupérer les propositions
  2. Analyser et résumer chaque suggestion
  3. Vous aider à décider lesquelles appliquer

Analyse des performances de chat

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

L'assistant utilisera analytics_overview et analytics_feedback pour compiler un rapport complet.

Sécurité

  • Les clés API sont limitées à votre compte utilisateur et à l'accès aux entreprises
  • Toutes les requêtes sont consignées dans la piste d'audit
  • Les clés peuvent être révoquées à tout moment depuis le tableau de bord
  • Des limites de débit s'appliquent : 60 requests/minute

Dépannage

Échec de connexion

  1. Vérifiez que votre clé API est correcte
  2. Vérifiez que la clé n'a pas été révoquée
  3. Assurez-vous d'avoir une connexion internet active
  4. Redémarrez votre client MCP

Outil introuvable

Certains outils requièrent des permissions spécifiques. Assurez-vous d'avoir le rôle approprié dans l'entreprise (Owner, Admin, ou Manager).

Limite de débit atteinte

Si vous rencontrez des erreurs de limite de débit, attendez une minute avant de réessayer. Envisagez de regrouper les opérations lorsque c'est possible.


Besoin d'aide ? Contactez notre équipe de support →