Résoudre les problèmes de connexion MCP

Vérifiez la connexion avant de modifier le projet. Pour la plupart des problèmes de configuration, vous pouvez cerner la cause en vérifiant la commande du serveur, les accès, l’espace de travail ou le mode sélectionné.

1. Vérifiez que Node.js 22 ou une version ultérieure et npx sont disponibles dans l’environnement du processus client.
2. Vérifiez que l’entrée owlmeans respecte le format de configuration attendu par le client.
3. Redémarrez le client après avoir enregistré la configuration ou modifié la préférence d’inférence.
4. Examinez l’état de la connexion au serveur, puis appelez session_status.
5. Connectez-vous dans le navigateur si l’accès a expiré ou a été révoqué.
6. Vérifiez la cible, le mode d’inférence et l’espace de travail avant de réessayer l’action prévue.

Symptôme	Vérifications à effectuer
Le serveur ne démarre pas	Chemin de la commande, tableau d’arguments et délai d’attente au démarrage du client.
Des outils manquent	Liste des outils de l’hôte connecté, cible et mode d’inférence.
Les fichiers locaux ne sont pas les bons	Racines MCP et répertoire du projet explicitement défini.
L’accès est refusé	Compte, entité de l’organisation, expiration du jeton et jeton défini dans l’environnement qui remplace celui configuré.
Le travail délégué est en attente	Gestion des tâches de l’agent et questions en suspens.
La génération semble arrêtée	État du projet ou de l’exécution en cours avant de soumettre à nouveau la demande.

Utilisez une connexion stdio pour l’exécution locale ou l’inférence déléguée. L’endpoint hébergé ne peut pas accéder au poste de travail.

Lorsque vous signalez un problème, indiquez le client, l’erreur affichée, le mode sélectionné et les informations d’état non confidentielles. Ne partagez ni fichiers d’identifiants, ni jetons d’accès, ni URL de connexion privées. Consultez les pages Connexion et Paramètres de la CLI.

Noms et marques

OpenAI, ChatGPT et les marques OpenAI associées appartiennent à OpenAI ; Codex est un produit OpenAI. Politique d’utilisation.

Claude et Claude Code sont des produits Anthropic ; leurs noms et marques restent la propriété de leur titulaire respectif. Politique d’utilisation.

Les noms Node.js et npx, ainsi que les marques associées, restent la propriété de leurs titulaires respectifs ou des responsables de ces projets. Ces références identifient des produits, des normes ou des exemples de code source. La documentation OwlMeans n’implique aucun parrainage ni aucune approbation de la part de ces titulaires.