Dépanner le MCP : 401, 403, outils manquants

Q: Que faire si un outil est manquant, ou « tool not found » ?

Sans Configure agency AI, l'assistant n'obtient que les 132 outils de configuration, de fans et de ventes : aucun outil AI Brain, Playground ou de publication. Cochez la case, redémarrez. Un outil qui est listé mais qui refuse (« requires can_generate », « requires the owner's can_publish permission ») signifie qu'il manque une case au token. Cochez-la avec Edit, redémarrez. L'assistant a deviné un nom. Demandez-lui : « Liste les outils de lanachat. » Les vrais noms sont dans la référence des outils. Le serveur n'est pas connecté : dans Claude Code ou Codex, tapez /mcp ; dans un éditeur, vérifiez ses réglages MCP.

Lecture de 3 minMis à jour 8 nov. 2026Markdown

Ouvrir dans la Console

La plupart des problèmes MCP de LanaChat viennent du token : faux, expiré, ou avec une case manquante. Repérez l'erreur que vous voyez dans le tableau, puis les détails ci-dessous.

Ce que vous voyez	Cause probable	Solution
`401`, « unauthorized »	token faux, expiré, révoqué ou renouvelé par rotation	copiez-le de nouveau ou Rotate, vérifiez `Bearer`
`403`, « permission », « requires … »	il manque une case au token	modifiez le token avec Edit, cochez la case, redémarrez
« tool not found »	case décochée, nom deviné, serveur non ajouté	cochez la case, vérifiez `/mcp`
`409`, « revision » ou « hash »	l'élément a changé entre-temps	relisez-le et refaites le changement
« request too large »	plus de 4 MiB dans une requête	importez les fichiers dans le Vault ou par Drive
aucune réponse	réseau ou court redémarrage	réessayez dans quelques minutes

Que faire en cas de 401 : unauthorized ? #

Le serveur n'a pas accepté le token.

Le token a été copié avec un caractère manquant ou en trop. Copiez-le de nouveau, depuis l'endroit où vous l'avez enregistré.
L'en-tête doit être exactement Authorization: Bearer suivi du token. Le mot Bearer et l'espace sont obligatoires.
Le token a été révoqué, ou renouvelé par rotation (l'ancien meurt immédiatement). Dans Users › API & MCP, vérifiez son statut.
Le token a expiré : les tokens durent 365 jours. Appuyez sur Rotate (ou Renew) et mettez le nouveau dans votre assistant.
Vous avez utilisé une clé d'employé (Team Management) ou un mot de passe de la Console. Le MCP n'accepte qu'un token venant de API & MCP.

Que faire en cas de 403 : forbidden, ou « permission » ? #

Le token est valide mais il lui manque une case pour cette action.

Dans Users › API & MCP, appuyez sur Edit sur le token.
Cochez la case dont l'action a besoin (voir le tableau dans Créer votre token MCP).
Enregistrez, puis quittez et redémarrez votre assistant.

Deux cas particuliers :

L'attribution d'une licence est refusée : il manque au token Spend the balance on licences (il lui faut aussi Read sales, et seul le propriétaire de l'espace de travail peut la cocher), ou la Daily limit for licences est atteinte (0 signifie aucune licence). Le refus précise lequel. Corrigez avec Edit sur le token, ou attribuez la licence dans la Console, dans Billing › Licences.
Playground refusé : les réponses du Playground demandent un solde positif. Rechargez dans Billing › Top up, ou sautez le test.

Que faire si un outil est manquant, ou « tool not found » ? #

Sans Configure agency AI, l'assistant n'obtient que les 132 outils de configuration, de fans et de ventes : aucun outil AI Brain, Playground ou de publication. Cochez la case, redémarrez.
Un outil qui est listé mais qui refuse (« requires can_generate », « requires the owner's can_publish permission ») signifie qu'il manque une case au token. Cochez-la avec Edit, redémarrez.
L'assistant a deviné un nom. Demandez-lui : « Liste les outils de lanachat. » Les vrais noms sont dans la référence des outils.
Le serveur n'est pas connecté : dans Claude Code ou Codex, tapez /mcp ; dans un éditeur, vérifiez ses réglages MCP.

Que faire en cas de 409, « revision » ou « hash » changé ? #

Quelqu'un (ou l'assistant lui-même) a modifié la même chose entre-temps. Demandez à l'assistant de relire l'élément et de refaire le changement avec la révision à jour. Rien n'a été perdu.

Que faire si la requête est trop grande ? #

Une requête MCP est plafonnée à 4 MiB. Les photos et vidéos ne passent pas par la conversation : importez-les dans le Vault, ou donnez le lien d'un dossier Google Drive public et laissez l'assistant l'importer.

Que faire si le serveur ne répond pas ? #

Vérifiez votre connexion internet.
Réessayez dans quelques minutes : un court redémarrage du serveur peut arriver.
Toujours en panne après 15 minutes : écrivez-nous depuis la Console (Support) avec l'heure et le nom de l'outil. N'envoyez jamais le token.

Astuce Après toute modification d'un token (Edit, Rotate), redémarrez l'assistant. Il ne lit la liste des outils qu'à sa connexion.

FAQ #

Pourquoi un outil apparaît-il dans la liste mais refuse-t-il de s'exécuter ? #

Tous les outils de la famille sont listés, et les cases sont vérifiées à chaque appel. Un refus qui nomme une permission signifie qu'il manque cette case au token.

Mon token fonctionnait hier. Pourquoi un 401 aujourd'hui ? #

Il a été renouvelé par rotation, révoqué ou il a expiré (365 jours). Vérifiez son statut dans Users › API & MCP et mettez le nouveau token dans votre assistant.

Dois-je redémarrer l'assistant après avoir modifié le token ? #

Oui. L'assistant ne lit la liste des outils qu'à sa connexion.