MCP Server Integration
ChatReact implémente le Model Context Protocol (MCP), ce qui vous permet de connecter votre compte ChatReact à des assistants IA comme 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 — créer, configurer (persona, langues, widget, comportement, restrictions), intégrer et supprimer des chatbots
- Construire la base de connaissances — ajouter des documents, crawler des sites web, gérer les pages crawlées et les instructions de base
- Gérer les FAQ — FAQs, catégories, suggestions, traductions et le widget FAQ
- Examiner les conversations — noter les conversations, attribuer des catégories de confiance, exécuter l'Improvement Agent
- Gérer les leads et formulaires — leads, catégories de leads, paramètres de capture, formulaires de contact et soumissions
- Agir en tant qu'agent de chat en direct — définir votre disponibilité, prendre en charge des conversations en attente, répondre et clore des sessions
- Administrer votre entreprise — profil, couleurs de marque, membres de l'équipe et invitations
- Utiliser l'Email Assistant — connexions de boîtes mail, catégories, contacts et activité
- Lire les analyses et notifications
Tout ce que vous pouvez faire dans le tableau de bord est disponible via MCP (et la REST API) ; seules les actions liées au navigateur comme les paiements, l'OAuth des boîtes mail, les passkeys, la suppression de compte et la gestion des clés API restent dans le tableau de bord.
Premiers pas
1. Générez une clé API
- Naviguez vers votre Tableau de bord → Entreprise → API onglet
- Cliquez sur Créer une clé API
- Donnez un nom descriptif à votre clé (p. ex. « Claude Desktop ») et sélectionnez au moins une autorisation
- Copiez la clé générée (commence par
cr_)
Les clés API sont disponibles sur les offres payantes — voir notre Pricing page.
Stockez votre clé API en toute sécurité. Elle ne peut pas être récupérée après 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 dans vos paramètres MCP de 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 pont 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. L'exemple utilise l'en-tête X-API-Key car certains clients ne gèrent pas correctement 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
Le MCP de ChatReact expose les outils ci‑dessous, regroupés par domaine. La colonne Scope indique l'autorisation de clé API requise par un outil (any = toute clé valide). Les outils s'exécutent avec les mêmes autorisations applicables, limites de plan et effets secondaires que les opérations prises en charge dans le tableau de bord. Les workflows liés au navigateur pour les paiements, l'autorisation des boîtes mail, les passkeys, la suppression de compte et la gestion des clés restent dans le tableau de bord.
Les outils destructifs (supprimer, réinitialiser, clore, fusionner) demandent confirmation lorsqu'ils sont utilisés via le Dashboard Assistant. Via la clé API, ils s'exécutent immédiatement.
Compte
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Obtenir le plan actuel (tier, status), les compteurs d'utilisation de la période de facturation en cours (companies, chatbots, team members, chats, tokens) et les limites du plan, plus les limites effectives et les flags de fonctionnalités de l'entreprise à laquelle l'appel est scellé. | any |
user_companies | Lister toutes les entreprises auxquelles l'utilisateur actuel a accès, avec le rôle de l'utilisateur dans chacune. | any |
user_notification_mark_read | Marquer comme lue l'une des notifications de l'utilisateur actuel. | any |
user_notification_preferences_get | Obtenir les préférences de notification de l'utilisateur actuel : bascules globales email/push, fréquence/heure/jour de synthèse, fuseau horaire et paramètres par type. | any |
user_notification_preferences_update | Mettre à jour les préférences de notification globales de l'utilisateur actuel (bascules email/push, planning de synthèse, heures calmes). | any |
user_notification_type_setting_update | Activer ou désactiver la livraison par e-mail / in-app pour un type de notification unique de l'utilisateur actuel (par ex. | any |
user_notification_types_list | Lister tous les types de notification regroupés par catégorie (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Obtenir le nombre de notifications non lues de l'utilisateur actuel. | any |
user_notifications | Lister les notifications de l'utilisateur actuel, les plus récentes en premier, avec pagination par curseur. | any |
user_notifications_delete_old | Entretien : supprimer définitivement les notifications de l'utilisateur actuel qui sont déjà lues et datent de plus de 30 jours. | any |
user_notifications_mark_all_read | Marquer toutes les notifications de l'utilisateur actuel comme lues. | any |
user_profile | Obtenir le profil de l'utilisateur actuel (id, name, email, role, subscription tier). | any |
Entreprise & Équipe
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Lister tous les chatbots d'une entreprise spécifique avec des statistiques récapitulatives. | chatbots:read |
company_get | Obtenir des informations détaillées sur une entreprise : profil, propriétaire, paramètres de marque (couleurs, email de notification) et compteurs. | any |
company_invite_cancel | Annuler (supprimer) une invitation d'équipe pour que le lien cesse de fonctionner. | company:write |
company_invite_resend | Renvoyer une invitation d'équipe en attente : émet un nouveau token, prolonge l'expiration de 7 jours et renvoie l'email d'invitation. | company:write |
company_invites_list | Lister les invitations d'équipe d'une entreprise (en attente par défaut ; définir includeExpired pour retourner aussi les expirées). | company:read |
company_list | Lister toutes les entreprises auxquelles l'utilisateur a accès (les clés API et le Dashboard Assistant ne voient que leur propre entreprise). | any |
company_logo_remove | Supprimer le logo de l'entreprise (supprime l'image stockée et efface l'URL du logo). | company:write |
company_member_invite | Inviter un membre d'équipe par e-mail avec un rôle (ADMIN, MANAGER, AGENT ou VIEWER). | company:write |
company_member_remove | Retirer un membre d'équipe de l'entreprise. | company:write |
company_member_update_role | Changer le rôle d'un membre d'équipe (ADMIN, MANAGER, AGENT ou VIEWER). | company:write |
company_members_list | Lister les membres d'une entreprise avec leurs rôles (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Mettre à jour les paramètres de marque de l'entreprise : primaryColor / secondaryColor (#RRGGBB) et l'notificationEmail pour les revues de chat. | company:write |
company_update | Mettre à jour le profil de l'entreprise : nom (2-100 caractères), description (max 1000 caractères) ou site web (https:// ajouté automatiquement ; passer une chaîne vide pour effacer site/description). | company:write |
Gestion des chatbots
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Ajouter une nouvelle instruction de base à un chatbot (1-5000 caractères). | chatbots:write |
chatbot_confirm_embed | Marquer un chatbot comme intégré sur le site web (cache le rappel de configuration dans le tableau de bord). | chatbots:write |
chatbot_create | Créer un nouveau chatbot (comme l'assistant de configuration du tableau de bord). | chatbots:write |
chatbot_delete | Supprimer définitivement un chatbot avec toutes ses FAQs, documents, chats, leads et formulaires (irréversible). | chatbots:write |
chatbot_delete_instruction | Supprimer une instruction de base d'un chatbot. | chatbots:write |
chatbot_get | Obtenir des informations détaillées sur un chatbot : paramètres généraux, personnalité (persona, tonalité, langues, restrictions), paramètres du widget, chat en direct, phase d'apprentissage, statut d'intégration et compteurs. | chatbots:read |
chatbot_get_embed_code | Obtenir le snippet HTML pour installer un chatbot sur un site web (URL du script + balise <script>) et savoir si l'intégration a été confirmée. | chatbots:read |
chatbot_get_instructions | Obtenir toutes les instructions de base d'un chatbot. | chatbots:read |
chatbot_improve_instructions | Réécrire le texte d'une instruction de base avec l'améliorateur IA de la plateforme (comme « Improve with AI » du tableau de bord). | chatbots:write |
chatbot_learning_phase_get | Obtenir les paramètres de la phase d'apprentissage d'un chatbot : preset de comportement (CAUTIOUS, BALANCED, CONFIDENT), prompt personnalisé et indication si le bot est encore en phase d'apprentissage. | chatbots:read |
chatbot_learning_phase_update | Définir le preset de comportement de la phase d'apprentissage (CAUTIOUS = renvoyer à un humain en cas de doute, BALANCED, CONFIDENT) et/ou un prompt personnalisé pour la phase d'apprentissage. | chatbots:write |
chatbot_list | Lister tous les chatbots auxquels l'utilisateur a accès, avec des statistiques récapitulatives. | chatbots:read |
chatbot_reorder_instructions | Définir l'ordre des instructions de base d'un chatbot. | chatbots:write |
chatbot_templates_list | Lister les templates de chatbot (préréglages pour persona, tonalité, messages et comportement du widget) qui peuvent être passés en templateId à chatbot_create, et indiquer si le plan de l'entreprise peut les utiliser. | chatbots:read |
chatbot_toggle_active | Activer ou désactiver un chatbot. | chatbots:write |
chatbot_toggle_learning | Terminer (false) ou réactiver (true) la phase d'apprentissage d'un chatbot. | chatbots:write |
chatbot_update | Mettre à jour les paramètres généraux d'un chatbot : nom, description, isActive, live chat (liveChatEnabled/liveChatMode, fonctionnalité selon le plan), showBranding (plans white-label), emails de revue de chat, génération automatique de FAQ, texte legacy coreInstructions, phase d'apprentissage (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Mettre à jour une instruction de base existante (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Mettre à jour la personnalité d'un chatbot : persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), curseurs de tonalité 1-5, langues (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), messages (welcomeMessage, fallbackMessage, proactive greeting) et restrictions (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Obtenir les paramètres actuels du widget d'un chatbot (tous les aspects d'apparence, branding, comportement et champs du formulaire pré-chat). | chatbots:read |
widget_settings_update | Mettre à jour le widget de chat d'un chatbot : position (incl. | chatbots:write |
widget_translations_get | Obtenir les traductions par langue du widget d'un chatbot : { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Définir les traductions du widget par langue. | chatbots:write |
Base de connaissances
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Annuler un job de crawl PENDING ou RUNNING ; les pages restantes sont ignorées. | knowledge:write |
crawler_job_get | Obtenir le statut d'un job de crawl, sa progression (pagesCrawled/pagesFound, tokensUsed) et le statut de chaque page. | knowledge:read |
crawler_jobs_list | Lister les jobs de crawl d'un chatbot (les plus récents en premier) avec statut et progression. | knowledge:read |
crawler_limits | Obtenir les limites de crawl du plan pour un chatbot (max pages par crawl, tokens par page, crawls par mois) et savoir si un nouveau crawl peut être lancé ce mois-ci. | knowledge:read |
crawler_preview_scan | Scanner un site web et lister ses pages crawlables (url, title, isRecommended) sans rien importer. | knowledge:write |
crawler_start | Démarrer un job de crawl qui importe les URLs sélectionnées dans la base de connaissances du chatbot (traité en arrière-plan ; poller crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Télécharger un document (PDF, TXT, MD, CSV, JSON, DOCX ; max 10 MB) depuis une URL publique http(s) et l'ajouter à la base de connaissances d'un chatbot. | knowledge:write |
knowledge_document_add_text | Ajouter un document texte ou markdown à la base de connaissances d'un chatbot à partir d'un contenu en ligne (max 10 MB). | knowledge:write |
knowledge_document_delete | Supprimer un document téléversé de la base de connaissances. | knowledge:write |
knowledge_document_get | Obtenir les détails d'un document téléversé incluant le statut de traitement, le message d'erreur et une URL de téléchargement temporaire. | knowledge:read |
knowledge_documents_list | Lister les documents téléversés (PDF, TXT, MD, CSV, JSON, DOCX) dans la base de connaissances d'un chatbot avec statut et taille. | knowledge:read |
knowledge_page_add | Crawler une seule URL et l'ajouter à la base de connaissances du chatbot (échoue avec CONFLICT lorsque l'URL est déjà indexée, FORBIDDEN lorsque la limite de tokens est atteinte). | knowledge:write |
knowledge_page_delete | Supprimer une page crawlée de la base de connaissances (supprime son fichier de vector-store). | knowledge:write |
knowledge_page_get | Obtenir une page crawlée incluant le contenu markdown qui a été indexé pour le chatbot (utile pour vérifier ce que le bot connaît d'une page). | knowledge:read |
knowledge_page_recrawl | Récupérer à nouveau une page crawlée et remplacer son contenu indexé (par ex. | knowledge:write |
knowledge_pages_delete | Supprimer plusieurs pages crawlées d'un chatbot en une seule fois. | knowledge:write |
knowledge_pages_list | Lister les pages crawlées dans la base de connaissances d'un chatbot, éventuellement filtrées par domaine, statut ou terme de recherche (URL/title). | knowledge:read |
knowledge_stats | Aperçu de la base de connaissances d'un chatbot : documents (par statut, taille), pages crawlées et sites web (par statut), jobs de crawl, instructions de base séparées par source (manuel vs improvement agent), FAQs, statut/tailles du vector store et usage de stockage vs. | knowledge:read |
knowledge_website_delete | Supprimer toutes les pages crawlées d'un site web (domaine) de la base de connaissances du chatbot. | knowledge:write |
knowledge_website_recrawl | Re-crawler toutes les pages d'un site (domaine) dans la base de connaissances du chatbot pour actualiser son contenu. | knowledge:write |
knowledge_website_recrawl_cancel | Annuler un re-crawl de site en cours : les pages en file d'attente (PENDING) du domaine sont reverties à leur état indexé précédent. | knowledge:write |
knowledge_websites_list | Lister les sites web (domaines) dont les pages sont dans la base de connaissances d'un chatbot, avec le nombre de pages par statut et les totaux de tokens. | knowledge:read |
Gestion des prix
Ces outils gèrent des brouillons de prix structurés et des approbations explicites. Sauvegarder un brouillon est distinct de l'approbation de la version exacte ; l'éligibilité dépend aussi du statut et de la validité. Les clés API existantes ne reçoivent pas automatiquement les autorisations prix. Seul le propriétaire de l'entreprise peut accorder prices:write ou prices:approve. Les appels via clé API s'exécutent directement, donc vérifiez l'entrée exacte avant d'appeler une mutation. Voir Prices & services pour le workflow client.
| Tool | Description | Scope |
|---|---|---|
price_list | Paginer les price heads et séparer l'éligibilité des versions approuvées. | prices:read |
price_get | Lire l'état complet d'un item et ses révisions. | prices:read |
price_detail | Lire le détail d'un item avec historique de révisions paginé. | prices:read |
price_suggestions_list | Paginer les suggestions de prix. | prices:read |
price_create | Créer un brouillon avec un ID d'item généré par le serveur. | prices:write |
price_edit | Créer un nouveau brouillon à partir d'une version d'item explicitement attendue. | prices:write |
price_import_csv | Importer des brouillons avec un format explicite et un import ID stable pour des retries sûrs. | prices:write |
price_suggestion_apply | Appliquer le candidat de suggestion sélectionné comme brouillon. | prices:write |
price_approve | Approuver une version d'item explicitement attendue. | prices:approve |
price_approve_many | Approuver atomiquement une sélection explicite ID/version ; toute version obsolète rejette la sélection entière. | prices:approve |
price_archive | Archiver un item à sa version explicitement attendue. | prices:approve |
Les modifications de brouillon préservent la révision approuvée précédente. Le format CSV et le séparateur décimal doivent être explicites ; tout changement du contenu CSV nécessite un nouvel import ID. Toutes les opérations sont liées à l'entreprise de la clé API et au chatbot spécifié.
Gestion des FAQ
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Vider les données mises en cache du widget FAQ sur tous les sites CMS connectés (plugin WordPress). | faqs:write |
faq_categories_list | Lister les catégories FAQ d'un chatbot avec leur nombre de FAQs, slugs, mode de tri et traductions. | faqs:read |
faq_categories_reorder | Définir l'ordre des catégories FAQ dans le widget : la position dans categoryIds devient le sortOrder. | faqs:write |
faq_category_create | Créer une catégorie FAQ pour un chatbot (le slug est généré à partir du nom). | faqs:write |
faq_category_delete | Supprimer une catégorie FAQ. | faqs:write |
faq_category_translations_update | Remplacer les traductions d'une catégorie FAQ, par ex. | faqs:write |
faq_category_update | Renommer une catégorie FAQ ou modifier sa description, son icône ou son mode de tri. | faqs:write |
faq_create | Créer une FAQ pour un chatbot. | faqs:write |
faq_delete | Supprimer définitivement une FAQ (l'enlève aussi de la base de connaissances du chatbot et purge les caches du widget CMS). | faqs:write |
faq_embed_code_get | Obtenir les snippets d'intégration pour le widget FAQ : balise script, shortcode WordPress et snippet Shopify Liquid, plus les variantes par catégorie (utiliser categorySlug de faq_categories_list pour intégrer une seule catégorie). | chatbots:read |
faq_get | Obtenir les détails complets d'une FAQ : question, réponse, catégorie, état de publication, ordre de tri, traductions, champs SEO et statistiques de feedback. | faqs:read |
faq_list | Lister les FAQs d'un chatbot (utilisez chatbot_list pour trouver le chatbotId). | faqs:read |
faq_reorder | Définir l'ordre d'affichage des FAQs dans le widget. | faqs:write |
faq_suggestion_approve | Approuver une suggestion FAQ PENDING : crée une FAQ publiée (optionnellement avec question/réponse/catégorie modifiées) et marque la suggestion APPROVED. | faqs:write |
faq_suggestion_get | Obtenir les détails complets d'une suggestion FAQ (réponse complète, raisonnement IA, catégorie suggérée, état de revue). | faqs:read |
faq_suggestion_reject | Rejeter une suggestion FAQ PENDING avec une raison optionnelle. | faqs:write |
faq_suggestions_generate | Laisser l'IA proposer de nouvelles FAQs à partir de la base de connaissances du chatbot (pages crawlées / documents téléversés), éventuellement pour une catégorie donnée. | faqs:write |
faq_suggestions_list | Lister les suggestions FAQ générées par l'IA d'un chatbot (à partir de conversations ou faq_suggestions_generate). | faqs:read |
faq_translate | Traduire la question et la réponse d'une FAQ avec l'IA dans les autres langues supportées du chatbot (ou les targetLanguages fournies) et sauvegarder le résultat. | faqs:write |
faq_translations_update | Sauvegarder les traductions d'une FAQ par langue, p. ex. | faqs:write |
faq_update | Mettre à jour la question, la réponse, la catégorie, l'état de publication ou l'ordre de tri manuel d'une FAQ. | faqs:write |
faq_widget_settings_get | Obtenir les paramètres d'apparence et de comportement du widget FAQ intégrable (couleurs, bordure, titre, espacement, largeur max, allowMultipleOpen, autoOpenFirst, mode de tri, traductions de titre). | chatbots:read |
faq_widget_settings_update | Mettre à jour les paramètres du widget FAQ : couleurs (hex), borderRadius 0-32, titre (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = pleine largeur), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name et traductions de titre par langue. | chatbots:write |
Historique des chats & Feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Marquer un chat comme revu sans le noter (le retire de la file d'attente pending, ne change pas le score de confiance). | chats:write |
chat_feedback_get | Obtenir une revue de chat (feedback) avec analyse IA, gravité, catégorie de confiance, changement de score et session d'amélioration liée. | chats:read |
chat_feedback_list | Lister les revues de chat (lignes de feedback) d'un chatbot avec filtre de statut et compteurs. | chats:read |
chat_feedback_set_severity | Outrepasser la classification de gravité (MINOR|MODERATE|MAJOR|CRITICAL) d'un chat négatif revu ; la gravité pondère la chute du score de confiance. | chats:write |
chat_feedback_stats | Comptes de sessions par bucket de revue pour un chatbot (total, none, pending, positive, negative, reviewed, improved) — les cartes statistiques de la page chats du tableau de bord. | chats:read |
chat_feedback_submit | Noter une session de chat comme Good (isPositive=true) ou Needs Work (isPositive=false). | chats:write |
chat_session_get | Obtenir une session de chat avec la transcription complète (par message token/model/latency/pageUrl), détails du visiteur, URL de la page de démarrage, catégorie de confiance, feedback (gravité, analyse IA, session d'amélioration liée) et tags. | chats:read |
chat_session_search | Rechercher des sessions de chat d'un chatbot par contenu de message et/ou email du visiteur. | chats:read |
chat_session_set_category | Attribuer ou changer la catégorie de confiance d'une session de chat (corrige la catégorisation IA ; la confiance par catégorie est recalculée quand le chat a été revu). | chats:write |
chat_sessions_list | Lister les sessions de chat d'un chatbot, les plus récentes en premier, avec les mêmes filtres de file d'attente de revue que la page chats du tableau de bord. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Lister les catégories de confiance d'un chatbot avec score de confiance par catégorie, nombre de revues et fréquence des emails de revue. | chats:read |
confidence_category_create | Créer une catégorie de confiance pour un chatbot. | chatbots:write |
confidence_category_delete | Supprimer une catégorie de confiance. | chatbots:write |
confidence_category_merge | Fusionner une catégorie de confiance dans une autre du même chatbot : tous les chats/revues passent vers la cible, la source est supprimée et les scores sont recalculés. | chatbots:write |
confidence_category_update | Renommer une catégorie de confiance et/ou définir sa fréquence d'email de revue (EVERY|HOURLY|DAILY|WEEKLY|NEVER ; emailFrequencyHours 1-24 uniquement pour HOURLY). | chatbots:write |
confidence_status_get | Statut de confiance d'un chatbot : score, seuil de graduation, flag de phase d'apprentissage, comportement de la phase d'apprentissage (CAUTIOUS|BALANCED|CONFIDENT) et prompt personnalisé, comptes de revues et scores de confiance par catégorie. | analytics:read |
improvement_proposal_approve | Approuver une proposition d'amélioration PENDING et appliquer le changement au chatbot (ajout/mise à jour d'instruction de base, création/mise à jour de FAQ ou mise à jour de persona) — même logique et limites de plan que le tableau de bord. | chatbots:write |
improvement_proposal_reject | Rejeter une proposition d'amélioration PENDING. | chatbots:write |
improvement_proposal_simulate | Simuler comment le chatbot répondrait au message problématique avec une proposition appliquée (original vs. | chatbots:write |
improvement_proposals_pending | Lister les propositions d'amélioration en attente de revue (statut PENDING) à l'échelle de l'entreprise ou pour un chatbot. | chatbots:read |
improvement_session_complete | Marquer une session d'amélioration comme COMPLETED (le chat compte alors comme Improved dans la file d'attente de revue). | chatbots:write |
improvement_session_create | Ouvrir l'Improvement Agent pour un chat noté Needs Work. | chatbots:write |
improvement_session_get | Obtenir une session d'amélioration avec le chat original (les messages ont un index 1-based utilisable comme targetMessageIndex), la conversation de l'agent, toutes les propositions (avec leur dernière simulation) et les simulations. | chatbots:read |
improvement_session_reset | Redémarrer une session d'amélioration : supprime tous les messages de l'agent, les simulations et les propositions PENDING/REJECTED (les propositions appliquées sont conservées) et lance une nouvelle conversation. | chatbots:write |
improvement_session_send_message | Envoyer un message à l'Improvement Agent (décrire ce qui était erroné dans la réponse du bot ; optionnellement targetMessageIndex = index 1-based du message du bot dans originalChat.messages). | chatbots:write |
improvement_sessions_list | Lister les sessions d'amélioration (conversations de l'Improvement Agent démarrées depuis des revues de chat négatives) pour un chatbot ou l'ensemble de l'entreprise, les plus récentes en premier, avec le nombre de propositions. | chatbots:read |
improvement_simulation_assess | Noter un résultat de simulation : isApproved=true lorsque la réponse simulée est bonne (la proposition peut alors être appliquée), false lorsque cela nécessite plus de travail (commentaire 'almost' = presque correct). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Obtenir la disponibilité live chat de l'utilisateur actuel, les agents actuellement disponibles pour le live chat (heartbeat récent, le même signal que le widget utilise) et savoir si le plan de l'entreprise inclut le live chat. | chats:read |
live_chat_heartbeat | Rafraîchir le heartbeat de présence live chat de l'utilisateur actuel (uniquement lorsqu'il est marqué disponible via live_chat_set_availability). | chats:write |
live_chat_message_send | Envoyer un message au visiteur en tant qu'agent assigné. | chats:write |
live_chat_queue | Obtenir la file d'attente live chat : sessions en attente d'un agent, les plus anciennes en premier (FIFO). | chats:read |
live_chat_session_assign | Prendre une session live chat WAITING depuis la file : l'assigne à l'utilisateur actuel (propriétaire de l'entreprise pour les clés API) et notifie le visiteur que l'agent a rejoint. | chats:write |
live_chat_session_close | Terminer une session live chat en tant qu'agent (tout membre de l'entreprise non-VIEWER). | chats:write |
live_chat_session_get | Obtenir une session live chat avec info visiteur, agent assigné, tous les messages et la conversation bot précédente (contexte de handoff). | chats:read |
live_chat_sessions_list | Lister les sessions live chat (les plus récentes en premier ; les sessions WAITING les plus anciennes en premier) avec filtres optionnels par chatbot, statut et agent assigné. | chats:read |
live_chat_set_availability | Basculer l'interrupteur 'Available for Live Chat' de l'utilisateur actuel pour une entreprise. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Assigner un lead à un membre de l'entreprise ou le désassigner (assignedToId: null). | leads:write |
lead_bulk_update_status | Définir le statut de plusieurs leads (max 100) en une seule fois. | leads:write |
lead_categories_list | Lister les catégories de leads d'un chatbot avec le nombre de leads et les membres notifiés par catégorie. | leads:read |
lead_category_assign_user | Ajouter un membre de l'entreprise à la liste de notification d'une catégorie de lead (ou mettre à jour ses flags de notification). | leads:write |
lead_category_create | Créer une catégorie de lead pour un chatbot. | leads:write |
lead_category_delete | Supprimer une catégorie de lead. | leads:write |
lead_category_remove_user | Retirer un membre de la liste de notification d'une catégorie de lead. | leads:write |
lead_category_update | Mettre à jour le nom, la description et/ou la couleur d'une catégorie de lead. | leads:write |
lead_create | Créer un lead manuellement (par ex. | leads:write |
lead_delete | Supprimer définitivement un lead. | leads:write |
lead_field_config_get | Obtenir la configuration de capture de leads d'un chatbot : champs (ids mappés aux clés dans lead.data), message de confirmation, traductions des champs/UI et paramètres de reconnaissance IA. | leads:read |
lead_field_config_update | Mettre à jour la configuration de capture de leads d'un chatbot. | leads:write |
lead_get | Obtenir les détails complets d'un lead incluant assigné, catégorie et la transcription du chat source (paginée avec messageOffset/messageLimit, par défaut les 20 premiers messages). | leads:read |
lead_list | Lister les leads d'un chatbot (les plus récents en premier) avec filtres optionnels par statut, catégorie, assigné et recherche en texte libre (name/email/company). | leads:read |
lead_stats | Obtenir les statistiques de leads pour un chatbot : comptes par statut, leads des 7 derniers jours et taux de conversion (pourcentage). | leads:read |
lead_update | Mettre à jour le statut, la catégorie, les notes, les données capturées et/ou l'assigné d'un lead. | leads:write |
Formulaires
| Tool | Description | Scope |
|---|---|---|
form_create | Créer un formulaire de contact pour un chatbot (basique, champs, design et paramètres anti-spam en un seul appel). | forms:write |
form_delete | Supprimer définitivement un formulaire de contact et TOUTES ses soumissions (cascade). | forms:write |
form_get | Obtenir un formulaire de contact en entier : champs, traductions, style, paramètres anti-spam, état actif, nombre de soumissions et le code d'intégration (embedCode). | forms:read |
form_list | Lister les formulaires de contact d'un chatbot avec nombre de champs, nombre de soumissions et codes d'intégration. | forms:read |
form_stats | Comptes de soumissions d'un formulaire de contact : total, pending, approved, spam et rejected. | forms:read |
form_submission_delete | Supprimer définitivement une soumission de formulaire de contact (par ex. | forms:write |
form_submission_get | Obtenir une soumission de formulaire de contact en entier : données des champs soumis, score anti-spam et analyse IA anti-spam, métadonnées IP/user agent/referrer et informations de revue. | forms:read |
form_submission_update_status | Revoir une soumission de formulaire de contact : définir son statut sur APPROVED, SPAM ou REJECTED avec une note de revue optionnelle. | forms:write |
form_submissions_list | Lister les soumissions d'un formulaire de contact, les plus récentes en premier, éventuellement filtrées par statut (PENDING, APPROVED, SPAM, REJECTED) et date de création. | forms:read |
form_update | Mettre à jour un formulaire de contact : nom, description, état actif (isActive contrôle si l'intégration se rend), champs (remplacement complet), design (couleurs, texte du bouton, message de succès) et paramètres anti-spam (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Remplacer les traductions des champs et/ou de l'UI d'un formulaire de contact. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Lister le journal d'activité des emails traités d'une connexion de boîte mail (les plus récents en premier) : expéditeur, sujet, catégorie assignée, résultat (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) et outcomeDetail. | email:read |
email_categories_list | Lister les catégories d'email d'une connexion de boîte mail (ordonnées par sortOrder). | email:read |
email_category_create | Créer une catégorie d'email pour une connexion de boîte mail (max 20 par connexion). | email:write |
email_category_delete | Supprimer une catégorie d'email. | email:write |
email_category_update | Mettre à jour une catégorie d'email (partiel : seules les champs fournis changent). | email:write |
email_connection_disconnect | Déconnecter définitivement une boîte mail. | email:write |
email_connection_get | Obtenir une connexion de boîte mail incl. | email:read |
email_connection_update | Mettre à jour une connexion de boîte mail : mettre en pause/reprendre la sync (paused true/false ; ne fait que basculer ACTIVE<->DISABLED, ne remplace jamais TOKEN_EXPIRED/ERROR), basculer le draft de réponse (draftingEnabled) et la catégorisation/organisation (organizingEnabled), rediriger le chatbot alimentant (chatbotId de la même entreprise) ou définir la signature HTML de réponse (signatureHtml, max 20000 caractères ; chaîne vide la supprime). | email:write |
email_connections_list | Lister les connexions de boîtes mail Email Assistant de l'entreprise (adresse, statut ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, dernière sync, dernière erreur, toggles drafting/organizing, chatbot alimentant, draftReadyCategoryCount = catégories pouvant produire des brouillons, baseRuleCount = règles "Chat + Email" appliquées à chaque brouillon) ainsi que les limites du plan (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Supprimer un contact email appris (oublier le profil de l'expéditeur, par ex. | email:write |
email_contact_get | Obtenir un contact email appris avec tous les faits appris, notes internes, relation, paramètre d'adresse formelle/informelle et statistiques email. | email:read |
email_contact_update | Mettre à jour un contact email appris. | email:write |
email_contacts_list | Lister les contacts email appris de l'entreprise (email le plus récent en premier) avec relation, adresse formelle/informelle (formalAddress: true = adresse formelle 'Sie', false = adresse informelle 'Du', null = automatique), nombre de faits et aperçu des notes. | email:read |
email_folder_create | Créer un dossier mail sous la boîte de réception (retourne l'existant si le nom est pris) à utiliser comme cible de déplacement de catégorie. | email:write |
email_folders_list | Lister les dossiers dans lesquels une catégorie d'email peut déplacer le courrier, en direct depuis la boîte : sous-dossiers inbox, dossiers top-level personnalisés, archive, spam et corbeille (id 'deleteditems'). | email:read |
email_general_rules_list | Lister les règles applicables à chaque brouillon de réponse d'une boîte mail : instructions de base actives avec channel BOTH ("Chat + Email"), plus les anciennes règles email-only non encore migrées vers une catégorie. | email:read |
Analytics
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Volume de chats (sessions démarrées) dans le temps pour graphiques et tendances : période week/month/quarter/year, granularité hour/day/week/month, éventuellement pour un chatbot. | analytics:read |
analytics_chatbot_stats | Performance par chatbot d'une entreprise en un appel (la table de performance chatbot du tableau de bord) : id, name, slug, isActive, sessions, messages, FAQs et leads par chatbot, trié par sessions. | analytics:read |
analytics_forms | Statistiques de soumissions de formulaires de contact pour une entreprise ou un chatbot (widget analytics du tableau de bord) : soumissions par statut (pending/approved/rejected/spam), nombre de formulaires, total, taux de spam en pourcentage et la série submissions-per-day des 7 derniers jours. | analytics:read |
analytics_leads | Entonnoir de leads pour une entreprise ou un chatbot (widget analytics du tableau de bord) : leads par statut (new/contacted/qualified/converted/lost), total, taux de conversion en pourcentage et la série leads-per-day des 7 derniers jours. | analytics:read |
analytics_overview | Aperçu analytics pour une entreprise ou un chatbot : chats, messages, taux de satisfaction et questions principales pour une période roulante (day/week/month/year), plus le widget overview du tableau de bord (total chatbots/published FAQs/leads, sessions aujourd'hui/cette semaine/ce mois, leads aujourd'hui/cette semaine, soumissions de formulaire total/aujourd'hui/pending). | analytics:read |
dashboard_activity | Ce qui nécessite actuellement de l'attention (vue d'accueil du tableau de bord) : par entreprise, les chatbots avec de nouveaux leads aujourd'hui, suggestions FAQ pending, soumissions de formulaire pending, live chats en attente/actifs ou une phase d'apprentissage en cours. | any |
Scénarios d'exemple
Ajouter une instruction de base
Demandez à votre assistant IA :
« Ajoutez une instruction de base à 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 des suggestions d'amélioration
« Montrez-moi toutes les propositions d'amélioration en attente pour mon chatbot et expliquez les changements qu'elles proposent »
L'assistant :
- Utilisera
improvement_proposals_pendingpour récupérer les propositions - Analysera et résumera chaque suggestion
- Les approuvera ou les rejettera en votre nom avec
improvement_proposal_approveouimprovement_proposal_reject
Analyser la performance des chats
« 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.
Importer un site web
« Scannez https://example.com, importez les pages produit et tarif dans mon 'Support Bot' et dites‑moi quand le crawl est terminé »
L'assistant appellera crawler_preview_scan, sélectionnera les pages pertinentes, démarrera l'import avec crawler_start et interrogera crawler_job_get jusqu'à la fin du job.
Examiner les leads et soumissions de formulaires
« Montrez‑moi les nouveaux leads de cette semaine, assignez les qualifiés à Anna et approuvez les soumissions de formulaires en attente »
L'assistant combine lead_list, lead_assign, form_submissions_list et form_submission_update_status.
Prendre en charge un live chat
« Passez disponible pour le live chat et prenez la conversation en attente la plus ancienne »
L'assistant utilise live_chat_set_availability, live_chat_queue et live_chat_session_assign ; les réponses passent par live_chat_message_send.
Sécurité
- Les clés API sont liées à votre entreprise et aux scopes d'autorisation que vous sélectionnez lors de leur création (voir la colonne Scope ci‑dessus)
- Les clés s'exécutent avec les autorisations du propriétaire de l'entreprise ; les limites de plan et les gates de fonctionnalités s'appliquent exactement comme dans le tableau de bord
- Les clés peuvent être révoquées à tout moment depuis le tableau de bord
- L'accès API est disponible sur les offres payantes — 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 introuvable
Redémarrez votre client MCP après avoir modifié la configuration afin qu'il recharge les outils disponibles. Les noms d'outils sont en minuscules avec des underscores (par ex., faq_list).
Besoin d'aide ? Contactez notre équipe support →