Après avoir configuré le MCP avec Codex, vous ne verrez aucun outil. D’abord, vérifiez si le serveur est chargé par le client actuel, puis vérifiez le démarrage, l’authentification et le filtrage des outils. Ne supprimez pas et ne réinstallez pas les configurations tout de suite ; La plupart des problèmes peuvent être détectés en /mcp dans codex mcp list ou TUI et un redémarrage clair.
Étape 1 : Confirmez que la modification est la même configuration
Les applications Codex, les CLI et les extensions IDE partagent les configurations Codex, l’emplacement par défaut étant ~/.codex/config.toml ; Les projets de confiance peuvent également bénéficier de .codex/config.toml. Si un CODEX_HOME différent est défini ou si le fichier de configuration est commuté, le client courant peut lire un autre fichier. D’abord, courez :
codex mcp listS’il n’y a pas de nom de cible dans la liste, cela signifie que la configuration n’a pas été lue par l’environnement actuel.
Étape 2 : Laissez le client recharger
Après avoir sauvegardé le MCP dans l’application Codex, cliquez sur Redémarrer ; Pour les extensions de l’IDE, sélectionnez Redémarrer extension. Après avoir lancé une nouvelle session dans la CLI, entrez /mcp dans la TUI pour confirmer le statut du serveur et les outils exposés. Si vous ne modifiez que config.toml mais continuez à utiliser l’ancienne session, la liste d’outils peut ne pas se rafraîchir.
Étape 3 : Distinguer entre échec de démarrage et échec d’authentification
Les serveurs STDIO reposent sur des commandes locales, des paramètres, des répertoires de travail et des variables d’environnement. Copiez la commande de démarrage de la configuration vers le même terminal et exécutez-la directement ; Si l’invite n’existe pas ou si des dépendances manquent, il faut d’abord réparer le PATH et l’environnement d’exécution. Lorsque le serveur HTTP a besoin d’OAuth, il exécute :
codex mcp login <服务器名称>Après l’autorisation, redémarrez le client. Lorsque le serveur démarre lentement, il peut s’améliorer startup_timeout_sec ; Le temps d’attente par défaut au démarrage n’est que de 10 secondes.
Étape 4 : Vérifiez si l’outil est filtré
L’élément de configuration enabled = false désactivera l’ensemble du serveur, enabled_tools n’autorisera que les outils listés, disabled_tools continuera d’exclure les outils après la liste autorisée. Lorsque le serveur est connecté mais que le nombre d’outils est nul, il faut prioriser la vérification de ces trois éléments plutôt que de douter du modèle.
Si l’outil n’est toujours pas disponible, conservez le statut affiché par /mcp, les erreurs de commande de démarrage et les journaux du serveur. Ces trois peuvent clairement distinguer entre « configuration non chargée », « processus non lancé », « autorisation non terminée » et « filtré par l’outil ». Les réparations ultérieures ne traitent que la couche correspondante.
