Connecter un agent IA avec le serveur MCP (Enterprise)

Le serveur MCP permet à un agent IA externe d'utiliser votre outil de support avec un jeton de bot aux autorisations limitées. C'est un endpoint Model Context Protocol : tout agent qui parle MCP (par exemple un bot OpenClaw) peut lire les conversations, y répondre, laisser des notes privées, rédiger des brouillons de réponse qu'une personne valide, gérer les contacts, démarrer des conversations sortantes et interroger un flux d'événements. Vous l'activez dans les Paramètres, vous générez un jeton et vous indiquez à votre agent l'URL de connexion. Le serveur MCP fait partie du forfait Enterprise. Pendant l'essai de 7 jours par lequel commence chaque nouveau compte, un agent peut se connecter, mais seul whoami répond ; tous les autres outils demandent un forfait Enterprise payant.

À quoi sert le serveur MCP ?

C'est le pont entre un agent IA externe et Deskwoot. Au lieu de créer votre propre intégration avec l'API REST, vous connectez un client MCP et l'agent reçoit un ensemble précis d'outils qu'il peut utiliser. C'est comme donner à un bot une clé limitée et révocable vers une partie précise de votre boîte de réception, plutôt que de lui confier un identifiant de connexion. L'agent agit sous une identité de bot : ses messages et ses notes portent le nom de ce bot, pas celui d'un membre de l'équipe.

Comment activer le serveur MCP ?

1. Allez dans Paramètres > Serveur MCP.
2. Activez le serveur MCP pour votre espace de travail.
3. Générez un jeton de bot. Donnez-lui un nom clair (par exemple Bot de tri OpenClaw) pour le reconnaître plus tard.
4. Choisissez les autorisations du jeton et limitez-le à certaines boîtes de réception si l'agent n'a besoin de travailler que dans quelques-unes.
5. Copiez le jeton tout de suite. Par sécurité, il se peut qu'il ne soit plus affiché en entier une fois que vous quittez la page.

Quelle est l'URL de connexion ?

Indiquez cette adresse à votre client MCP :

https://<your-host>/api/mcp

Remplacez <your-host> par votre propre hôte Deskwoot. Transmettez le jeton de bot comme votre client MCP le demande (en général sous forme de jeton bearer dans l'en-tête d'autorisation). Une fois le client connecté, l'agent voit les outils qu'il a le droit d'utiliser selon les autorisations du jeton.

Que peut faire un agent externe via MCP ?

Un agent connecté peut, dans la limite des autorisations que vous lui donnez :

• Lire les conversations et leurs messages.
• Répondre aux conversations.
• Ajouter des notes privées que seule votre équipe voit.
• Créer des brouillons de réponse qu'un membre de l'équipe relit et envoie.
• Lire, créer et mettre à jour des contacts.
• Démarrer des conversations sortantes.
• Interroger un flux d'événements pour réagir aux nouvelles activités.
• Traiter les tickets et les tickets groupés (voir plus bas).

Tickets et tickets groupés

Les tickets sont inclus dans Enterprise ; un administrateur peut les désactiver dans Paramètres > Tickets. Un agent connecté reçoit aussi des outils pour les tickets. Pour lire les tickets, l'autorisation Tout lire suffit, et pour les modifier il faut Répondre et gérer les conversations. Les outils suivent les mêmes règles que les écrans des tickets dans Deskwoot :

• Lister et lire les tickets, avec le fil du ticket, la conversation d'origine et ses issues Jira, et lister vos catégories et statuts de tickets.
• Créer un ticket à partir des messages d'une conversation, ajouter des commentaires internes et changer le statut, le responsable, l'équipe, la catégorie, la priorité ou le titre d'un ticket.
• Répondre au client depuis un ticket. La réponse part dans la conversation d'où vient le ticket. Un jeton en Mode brouillons uniquement (supervisé) ne peut pas le faire.
• Lier une issue Jira existante à un ticket, ou la délier.
• Créer un ticket groupé, y lier des conversations et des tickets, les délier et lister ce qui est lié.

Deux actions restent aux personnes, dans le tableau de bord : créer une nouvelle issue Jira, car elle est créée sous le compte Atlassian d'une personne, et envoyer la mise à jour d'un ticket groupé à tous les clients liés. Un jeton limité à certaines boîtes de réception travaille sur les tickets dont la conversation se trouve dans ces boîtes, et seul un jeton qui a accès à toutes les boîtes peut créer un ticket groupé ou changer ses liens.

Que ne peut-il pas faire ?

Le serveur MCP est volontairement limité. Il ne donne accès ni aux paramètres de votre espace de travail ni à la facturation, et il ne supprime rien. Concrètement, un jeton de bot ne peut pas changer les paramètres ou la configuration, toucher à la facturation, supprimer des données, faire des envois groupés ni gérer les webhooks. Si votre agent doit faire quelque chose en dehors de cette limite, le serveur MCP ne le fera pas, et c'est voulu.

Comment fonctionnent les autorisations et les limites par boîte de réception ?

Chaque jeton porte un ensemble d'autorisations qui décide quels outils l'agent peut utiliser. N'accordez que ce dont l'agent a vraiment besoin. Par exemple, un bot qui rédige des brouillons pour qu'une personne les valide n'a pas besoin du droit d'envoyer des messages tout seul. En plus des autorisations, vous pouvez limiter un jeton à certaines boîtes de réception : un agent qui gère votre boîte de facturation ne voit ainsi jamais les conversations d'une autre boîte. Si un jeton fuite ou si vous n'utilisez plus un agent, révoquez-le dans Paramètres > Serveur MCP et l'accès est coupé immédiatement.

Quels forfaits incluent le serveur MCP ?

Le serveur MCP est une fonctionnalité Enterprise. Pendant l'essai de 7 jours, vous pouvez l'activer, générer un jeton et connecter un agent, mais seul whoami répond (il confirme la connexion) ; tous les autres outils demandent un forfait Enterprise payant. Si vous avez besoin d'un accès par programmation sans MCP, l'API REST couvre les mêmes données et c'est aussi une fonctionnalité Enterprise (les jetons d'API demandent un forfait Enterprise payant ; l'essai ne les inclut pas), avec des jetons gérés dans Paramètres > Jetons d'API.

Questions fréquentes