AccueilDocumentation

Intégration du serveur MCP

ChatReact implémente le Model Context Protocol (MCP), vous permettant de connecter votre compte ChatReact à des assistants IA tels que Claude Desktop, Cursor, et d'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 et des sources de données externes. Grâce à l'intégration MCP de ChatReact, vous pouvez :

  • Gérer les chatbots — mettre à jour les instructions, la personnalité et les paramètres du widget
  • Créer et mettre à jour des FAQ en langage naturel
  • Consulter les analyses, l'historique des chats et les leads
  • Examiner les propositions de l'Improvement Agent et les approuver ou les rejeter
  • Surveiller les sessions de chat en direct et la file d'attente

Pour commencer

1. Générez une clé API

  1. Accédez à votre DashboardCompany → onglet API
  2. Cliquez sur Create API Key
  3. Donnez à votre clé un nom descriptif (par ex. « Claude Desktop ») et sélectionnez au moins une permission
  4. Copiez la clé générée (commence par cr_)

Les clés API sont disponibles sur les plans payants — voir notre Pricing page.

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

Le serveur MCP de ChatReact est hébergé à https://www.chatreact.ai/api/mcp et communique via HTTP (JSON-RPC). Authentifiez-vous avec un en-tête Authorization: Bearer — un en-tête X-API-Key avec la même clé est également accepté.

Cursor IDE

Cursor prend en charge les serveurs MCP distants directement. Ajoutez aux paramètres MCP de votre Cursor :

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

Claude Desktop

Le fichier de configuration de Claude Desktop prend en charge les serveurs basés sur des commandes, utilisez donc le bridge standard mcp-remote pour vous connecter au point de terminaison hébergé :

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

Cette configuration nécessite Node.js installé. L'exemple utilise l'en-tête X-API-Key car certains clients ne gèrent pas de manière fiable les espaces dans les arguments.

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 un ensemble complet d'outils organisés par catégories :

Votre compte

OutilDescription
user_profileObtenir les informations de votre profil
user_companiesLister la société à laquelle votre clé API est rattachée
user_notificationsObtenir vos notifications récentes

Gestion de l'entreprise et de l'équipe

OutilDescription
company_listLister la société à laquelle votre clé API est rattachée
company_getObtenir les détails d'une société spécifique
company_members_listLister les membres de la société avec leurs rôles
company_chatbots_listLister tous les chatbots d'une société
company_updateMettre à jour le nom de la société, la description ou les paramètres

Gestion des chatbots

OutilDescription
chatbot_listLister tous les chatbots avec des statistiques résumées
chatbot_getObtenir les détails et la configuration d'un chatbot
chatbot_get_instructionsObtenir les instructions principales d'un chatbot
chatbot_add_instructionAjouter une nouvelle instruction principale
chatbot_update_instructionMettre à jour une instruction principale existante
chatbot_delete_instructionSupprimer une instruction principale
chatbot_update_personalityMettre à jour la tonalité, la langue et les messages
chatbot_toggle_activeActiver ou désactiver un chatbot
chatbot_toggle_learningActiver ou désactiver la phase d'apprentissage
widget_settings_getObtenir les paramètres actuels du widget
widget_settings_updateMettre à jour l'apparence du widget (couleurs, taille, position)

Gestion des FAQ

OutilDescription
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_suggestions_listLister les suggestions de FAQ en attente générées à partir des conversations de chat

Base de connaissances

OutilDescription
knowledge_documents_listLister les documents dans la base de connaissances d'un chatbot
knowledge_document_getObtenir les détails d'un document spécifique
knowledge_document_deleteSupprimer un document de la base de connaissances
knowledge_statsObtenir les statistiques de la base de connaissances

L'exploration de sites Web est gérée depuis le dashboard — voir Knowledge Base.

Gestion des leads

OutilDescription
lead_listLister les leads avec filtrage optionnel par statut ou catégorie
lead_getObtenir les détails complets d'un lead y compris la session de chat source
lead_updateMettre à jour le statut, la catégorie ou les notes d'un lead
lead_deleteSupprimer un lead définitivement
lead_categories_listLister les catégories de leads
lead_statsObtenir les statistiques des leads incluant les comptes par statut
lead_field_config_getObtenir la configuration des champs de capture de leads

Historique des chats

OutilDescription
chat_sessions_listLister les sessions de chat avec filtres optionnels
chat_session_getObtenir une session de chat avec tous ses messages
chat_session_searchRechercher des sessions de chat par contenu des messages ou informations du visiteur

Analytics

OutilDescription
analytics_overviewObtenir les nombres de chats, le nombre de messages et les taux de satisfaction
analytics_chat_volumeObtenir le volume de chats dans le temps pour les graphiques et tendances

Improvement Agent

OutilDescription
improvement_sessions_listLister les sessions d'amélioration
improvement_session_getObtenir les détails d'une session incluant les propositions
improvement_proposals_pendingLister les propositions en attente d'examen
improvement_proposal_approveApprouver une proposition et appliquer la modification
improvement_proposal_rejectRejeter une proposition

Chat en direct

OutilDescription
live_chat_sessions_listLister les sessions de chat en direct
live_chat_session_getObtenir une session de chat en direct avec tous les messages
live_chat_queueObtenir les sessions en attente d'un agent

Les outils de chat en direct sont en lecture seule. Pour discuter directement avec les visiteurs, utilisez le dashboard Live Chat.

Exemples de flux de travail

Ajouter une instruction principale

Demandez à votre assistant IA :

« Ajoutez une instruction principale à mon chatbot 'Support Bot' : nous offrons la livraison gratuite pour les commandes supérieures à 50 € »

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

Examiner les suggestions d'amélioration

« Montrez-moi toutes les propositions d'amélioration en attente pour mon chatbot et expliquez les changements proposés »

L'assistant va :

  1. Utiliser improvement_proposals_pending pour récupérer les propositions
  2. Analyser et résumer chaque suggestion
  3. Les approuver ou les rejeter en votre nom avec improvement_proposal_approve ou improvement_proposal_reject

Analyser les performances de chat

« Donnez-moi un rapport hebdomadaire du volume de chats et de la satisfaction client pour mon chatbot »

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

Sécurité

  • Les clés API sont limitées à votre société
  • Les clés peuvent être révoquées à tout moment depuis le dashboard
  • L'accès API est disponible sur les plans payants — voir notre Pricing page

Dépannage

Connexion échouée

  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 que votre plan inclut l'accès API
  4. Redémarrez votre client MCP

Outil non trouvé

Redémarrez votre client MCP après avoir modifié la configuration afin qu'il recharge les outils disponibles. Les noms d'outil sont en minuscules avec des underscores (par ex., faq_list).


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