Résoudre les problèmes de connexion MCP

Le client renvoie une erreur à la connexion

La plupart des erreurs de connexion viennent d'un cache d'authentification obsolète laissé par mcp-remote. Videz-le puis reconnectez-vous :

rm -rf ~/.mcp-auth

Si l'erreur persiste, vérifiez que votre version de Node.js est bien 18 ou ultérieure : les versions plus anciennes ne peuvent pas terminer le flux OAuth.

Les outils n'apparaissent pas dans l'assistant

Le client s'est connecté mais n'a pas chargé la liste des outils. Déconnectez le serveur depuis les paramètres MCP de votre client, puis reconnectez-le. Dans Claude Code, lancez /mcp et reconnectez-vous depuis cet écran.

La connexion se coupe au bout d'un moment

Les sessions MCP distantes expirent. Déconnectez puis reconnectez le serveur depuis les paramètres MCP du client pour ouvrir une nouvelle session.

L'assistant ne voit pas toutes mes données

La session MCP hérite des permissions du compte utilisé lors de l'authentification. S'il manque des applications, des coûts ou des équipes, vérifiez votre rôle dans le guide Rôles et permissions : un assistant ne peut jamais voir plus que vous dans l'interface.

Je dois connecter plusieurs espaces Kabeen

Une simple reconnexion ne change pas d'espace au sein d'une session d'authentification existante. Pour les clients passant par mcp-remote, donnez à chaque espace son propre répertoire de configuration :

MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/kabeen-espace-a npx -y mcp-remote https://api.kabeen.io/mcp

Déclarez une entrée de serveur par espace, chacune avec son répertoire.

WSL sous Windows

L'exécution du pont via WSL nécessite de l'invoquer explicitement :

{
  "mcpServers": {
    "kabeen": {
      "command": "wsl",
      "args": ["npx", "-y", "mcp-remote", "https://api.kabeen.io/mcp"]
    }
  }
}

Révoquer un client

Ouvrez les paramètres de votre compte Kabeen et révoquez l'autorisation accordée au client. L'accès est coupé immédiatement ; le client vous demandera de vous authentifier à nouveau lors de sa prochaine connexion.

Toujours bloqué ?

Contactez votre référent Kabeen en précisant le nom et la version de votre client, ainsi que le message d'erreur exact renvoyé à la connexion.