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

_Connecter Claude / Codex · Lecture de 3 min · Mis à jour 2026-11-08 · https://lanachat.ai/guides/fr/ai-troubleshooting/_

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.

1. Dans **Users › API & MCP**, appuyez sur **Edit** sur le token.
2. Cochez la case dont l'action a besoin (voir le tableau dans [Créer votre token MCP](https://lanachat.ai/guides/fr/ai-create-mcp-token/)).
3. 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](https://lanachat.ai/guides/mcp-tool-reference/).
- 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.

> Tip: 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.

## Articles liés

- [Protégez votre token](https://lanachat.ai/guides/fr/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP : connecter un assistant IA](https://lanachat.ai/guides/fr/api-mcp/)