Connecter des applications IA (MCP)

Le MonoChat MCP Server permet à une application IA compatible avec le Model Context Protocol (MCP), comme Claude Code ou Cursor, de travailler avec votre compte MonoChat. L'application IA demande des données à MonoChat via un ensemble fixe d'outils ; elle ne peut voir que ce que vous pouvez voir.

Le MonoChat MCP Server est disponible avec tous les forfaits, sans limite selon le forfait.

Une connexion agit en votre nom

Une application IA connectée avec votre clé d'accès agit comme votre utilisateur. Elle accède aux tenants auxquels vous avez accès, et à rien d'autre. Révoquez les connexions que vous n'utilisez plus.

Ce que l'application IA peut faire

Ces outils sont disponibles pour toutes les connexions :

Outil	Ce qu'il fait
list_tenants	Liste les tenants auxquels la connexion a accès.
list_sessions	Liste les sessions de conversation d'un tenant, de la plus récente à la plus ancienne, éventuellement uniquement les sessions opened, assigned ou closed.
get_session	Renvoie une session de conversation.
list_messages	Liste les messages d'une session, du plus récent au plus ancien.
search_customers	Recherche les clients d'un tenant par mot-clé.
list_message_templates	Liste les modèles de message d'un canal d'un tenant.

Le texte des messages provient des clients et des agents. Ce sont des données que l'application IA lit, pas des instructions.

Une connexion a une portée, Lecture seule ou Lecture et écriture. Une connexion en lecture seule ne voit jamais les outils qui modifient des données. Tous les outils listés ci-dessus ne font que lire.

Créer une connexion

Une connexion appartient à votre compte, pas à un tenant. Vous devez d'abord avoir configuré la vérification en deux étapes (par e-mail ou avec une application d'authentification).

1. Ouvrez les paramètres du profil, sélectionnez l'onglet Connexions MCP et cliquez sur Créer.
2. Saisissez un nom, choisissez la portée (Lecture seule par défaut) et la durée de validité en jours (90 par défaut, 365 au maximum).
3. Saisissez le code de confirmation à 6 chiffres de votre méthode de vérification en deux étapes. Avec la vérification par e-mail, cliquez d'abord sur Envoyer le code de confirmation.
4. Copiez la clé d'accès. Elle n'est affichée qu'une seule fois ; elle commence par mcp_sk_.

Vous pouvez avoir jusqu'à 10 connexions actives.

Connecter une application IA

Le serveur se trouve à l'adresse https://app.monochat.ai/api/mcp-server (utilisez votre propre adresse MonoChat si vous exécutez MonoChat sur vos propres serveurs) et attend la clé d'accès comme bearer token dans l'en-tête Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Ajoutez le serveur à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Tout autre client MCP compatible avec le transport HTTP streamable et les en-têtes personnalisés se connecte de la même manière.

Limites

Les appels sont comptés par minute : 60 par connexion, 300 par compte et 600 par tenant, et au maximum 4 appels simultanés par connexion. Certains outils comptent pour plus d'un appel. Lorsqu'une limite est atteinte, le serveur répond avec un statut 429 et un en-tête Retry-After ; l'application IA doit attendre ce nombre de secondes.

Révoquer une connexion

Chaque connexion de l'onglet Connexions MCP indique son statut, sa portée, son expiration et sa dernière utilisation. Cliquez sur Révoquer pour couper immédiatement l'accès de l'application IA. Une connexion révoquée ou expirée ne peut plus être utilisée ; créez-en une nouvelle.

Gérer l'accès MCP d'une organisation

Les utilisateurs qui peuvent modifier les paramètres d'une organisation gèrent son accès MCP dans Paramètres › Organisation › Serveur MCP.

• Désactiver l'accès MCP pour cette organisation : activez-le et cliquez sur Enregistrer pour refuser tout appel MCP vers cette organisation, depuis chaque connexion de chaque utilisateur. L'organisation n'apparaît plus dans list_tenants. Désactivez-le et enregistrez pour autoriser à nouveau l'accès MCP.
• Appels MCP : chaque appel à un outil qui désigne cette organisation, du plus récent au plus ancien, appels refusés compris. Chaque ligne indique l'utilisateur, la connexion, l'outil, le statut (Succès ou Échoué), l'adresse IP et l'heure. Les appels des utilisateurs qui ne sont pas membres de cette organisation ne sont pas affichés.