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
- Accédez à votre Dashboard → Company → onglet API
- Cliquez sur Create API Key
- Donnez à votre clé un nom descriptif (par ex. « Claude Desktop ») et sélectionnez au moins une permission
- 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
| Outil | Description |
|---|---|
user_profile | Obtenir les informations de votre profil |
user_companies | Lister la société à laquelle votre clé API est rattachée |
user_notifications | Obtenir vos notifications récentes |
Gestion de l'entreprise et de l'équipe
| Outil | Description |
|---|---|
company_list | Lister la société à laquelle votre clé API est rattachée |
company_get | Obtenir les détails d'une société spécifique |
company_members_list | Lister les membres de la société avec leurs rôles |
company_chatbots_list | Lister tous les chatbots d'une société |
company_update | Mettre à jour le nom de la société, la description ou les paramètres |
Gestion des chatbots
| Outil | Description |
|---|---|
chatbot_list | Lister tous les chatbots avec des statistiques résumées |
chatbot_get | Obtenir les détails et la configuration d'un chatbot |
chatbot_get_instructions | Obtenir les instructions principales d'un chatbot |
chatbot_add_instruction | Ajouter une nouvelle instruction principale |
chatbot_update_instruction | Mettre à jour une instruction principale existante |
chatbot_delete_instruction | Supprimer une instruction principale |
chatbot_update_personality | Mettre à jour la tonalité, la langue et les messages |
chatbot_toggle_active | Activer ou désactiver un chatbot |
chatbot_toggle_learning | Activer ou désactiver la phase d'apprentissage |
widget_settings_get | Obtenir les paramètres actuels du widget |
widget_settings_update | Mettre à jour l'apparence du widget (couleurs, taille, position) |
Gestion des FAQ
| Outil | Description |
|---|---|
faq_list | Lister toutes les FAQ d'un chatbot |
faq_get | Obtenir les détails d'une FAQ |
faq_create | Créer une nouvelle FAQ |
faq_update | Mettre à jour une FAQ existante |
faq_delete | Supprimer une FAQ |
faq_categories_list | Lister les catégories de FAQ |
faq_suggestions_list | Lister les suggestions de FAQ en attente générées à partir des conversations de chat |
Base de connaissances
| Outil | Description |
|---|---|
knowledge_documents_list | Lister les documents dans la base de connaissances d'un chatbot |
knowledge_document_get | Obtenir les détails d'un document spécifique |
knowledge_document_delete | Supprimer un document de la base de connaissances |
knowledge_stats | Obtenir 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
| Outil | Description |
|---|---|
lead_list | Lister les leads avec filtrage optionnel par statut ou catégorie |
lead_get | Obtenir les détails complets d'un lead y compris la session de chat source |
lead_update | Mettre à jour le statut, la catégorie ou les notes d'un lead |
lead_delete | Supprimer un lead définitivement |
lead_categories_list | Lister les catégories de leads |
lead_stats | Obtenir les statistiques des leads incluant les comptes par statut |
lead_field_config_get | Obtenir la configuration des champs de capture de leads |
Historique des chats
| Outil | Description |
|---|---|
chat_sessions_list | Lister les sessions de chat avec filtres optionnels |
chat_session_get | Obtenir une session de chat avec tous ses messages |
chat_session_search | Rechercher des sessions de chat par contenu des messages ou informations du visiteur |
Analytics
| Outil | Description |
|---|---|
analytics_overview | Obtenir les nombres de chats, le nombre de messages et les taux de satisfaction |
analytics_chat_volume | Obtenir le volume de chats dans le temps pour les graphiques et tendances |
Improvement Agent
| Outil | Description |
|---|---|
improvement_sessions_list | Lister les sessions d'amélioration |
improvement_session_get | Obtenir les détails d'une session incluant les propositions |
improvement_proposals_pending | Lister les propositions en attente d'examen |
improvement_proposal_approve | Approuver une proposition et appliquer la modification |
improvement_proposal_reject | Rejeter une proposition |
Chat en direct
| Outil | Description |
|---|---|
live_chat_sessions_list | Lister les sessions de chat en direct |
live_chat_session_get | Obtenir une session de chat en direct avec tous les messages |
live_chat_queue | Obtenir 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 :
- Utiliser
improvement_proposals_pendingpour récupérer les propositions - Analyser et résumer chaque suggestion
- Les approuver ou les rejeter en votre nom avec
improvement_proposal_approveouimprovement_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
- Vérifiez que votre clé API est correcte
- Vérifiez que la clé n'a pas été révoquée
- Assurez-vous que votre plan inclut l'accès API
- 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 →