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
- Rendez-vous dans votre Dashboard → Settings → API Keys
- Cliquez sur Create API Key
- Donnez à votre clé un nom descriptif (par ex. « Claude Desktop »)
- 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
| Tool | Description |
|---|---|
company_list | Lister toutes les entreprises auxquelles vous avez accès |
company_get | Obtenir les détails d'une entreprise spécifique |
company_team_list | Lister les membres de l'équipe d'une entreprise |
Gestion des chatbots
| Tool | Description |
|---|---|
chatbot_list | Lister tous les chatbots d'une entreprise |
chatbot_get | Obtenir les détails et la configuration d'un chatbot |
chatbot_create | Créer un nouveau chatbot |
chatbot_update | Mettre à jour les paramètres du chatbot |
chatbot_get_instructions | Obtenir les instructions principales d'un chatbot |
chatbot_add_instruction | Ajouter une nouvelle instruction principale |
Gestion des FAQ
| Tool | 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_suggest | Générer des FAQ suggérées par l'IA |
Base de connaissances
| Tool | Description |
|---|---|
knowledge_list_documents | Lister les documents téléchargés |
knowledge_list_websites | Lister les sites web crawlés |
knowledge_crawl_website | Démarrer un crawl de site web |
knowledge_get_crawl_status | Vérifier l'avancement du crawl |
Analytics
| Tool | Description |
|---|---|
analytics_overview | Obtenir les métriques de performance globales |
analytics_chat_volume | Obtenir le volume de chats au fil du temps |
analytics_feedback | Obtenir les retours et évaluations |
analytics_chat_history | Parcourir les sessions de chat |
analytics_get_session | Obtenir les données détaillées d'une session |
Improvement Agent
| Tool | Description |
|---|---|
improvement_list_sessions | Lister les sessions d'amélioration |
improvement_start_session | Démarrer une nouvelle session d'analyse |
improvement_list_proposals | Lister les propositions d'amélioration |
improvement_get_proposal | Obtenir les détails d'une proposition |
improvement_create_proposal | Créer une proposition personnalisée |
improvement_simulate_proposal | Prévisualiser les effets d'une proposition |
improvement_apply_proposal | Appliquer une proposition |
improvement_reject_proposal | Rejeter une proposition |
Live Chat
| Tool | Description |
|---|---|
livechat_get_queue | Obtenir les sessions de chat en attente |
livechat_get_active_sessions | Lister les sessions actives avec agent humain |
livechat_get_session | Obtenir les détails d'une session |
livechat_assign_session | Vous assigner à une session |
livechat_send_message | Envoyer un message en tant qu'agent |
livechat_close_session | Clore une session de chat |
livechat_check_availability | Vé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 :
- Utiliser
improvement_list_proposalspour récupérer les propositions - Analyser et résumer chaque suggestion
- 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
- Vérifiez que votre clé API est correcte
- Vérifiez que la clé n'a pas été révoquée
- Assurez-vous d'avoir une connexion internet active
- 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 →