--- title: "Ajouter un serveur MCP à Claude Code et Codex" description: "Lancez claude mcp add --transport http dans Claude Code ou codex mcp add --url dans Codex, puis connectez-vous. Nous avons testé les deux avec le serveur MCP de LogBrew." canonical: "https://logbrew.co/fr/guides/mcp-server-claude-code-codex" last_updated: "2026-11-10" --- # Ajouter un serveur MCP à Claude Code et Codex Lancez `claude mcp add --transport http` dans Claude Code ou `codex mcp add --url` dans Codex, puis connectez-vous. Nous avons testé les deux avec le serveur MCP de LogBrew. Testé le 10 novembre 2026 avec Claude Code 2.1.319 et Codex CLI 0.167.0 Par [Furkan Erday](https://github.com/furkanerday). Furkan Erday est le fondateur de LogBrew. Il développe LogBrew avec Claude Code et Codex tous les jours. Canonical: https://logbrew.co/fr/guides/mcp-server-claude-code-codex ## 1 serveur MCP, 2 agents Serveur MCP de LogBrew `https://logbrew.co/mcp` Outils `search` `execute` | | Claude Code | Codex | | --- | --- | --- | | | `claude mcp add --transport http` | `codex mcp add --url` | | Enregistré dans | `~/.claude.json` | `~/.codex/config.toml` | | Avant la connexion | `Needs authentication` | `Not logged in` | ## Claude Code ### Ajouter le serveur Lancez cette commande dans le dossier de votre projet. Claude Code ajoute le serveur pour ce projet uniquement et l’enregistre dans `~/.claude.json`. ```bash claude mcp add --transport http logbrew https://logbrew.co/mcp ``` Sortie ```text Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to local config ``` ### Le partager ou l’utiliser partout `--scope project` écrit `.mcp.json` à la racine du projet, pour que votre équipe récupère le serveur via Git. `--scope user` l’ajoute à tous vos projets. ```bash claude mcp add --transport http logbrew --scope user https://logbrew.co/mcp ``` Sortie ```text Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to user config ``` ### Vérifier le serveur Claude Code vérifie chaque serveur qu’il liste. Avant la connexion, un serveur qui utilise OAuth affiche `Needs authentication`. Un serveur issu de `.mcp.json` affiche `Pending approval` jusqu’à ce que vous l’approuviez dans une session. ```bash claude mcp list ``` Sortie ```text Checking MCP server health… logbrew: https://logbrew.co/mcp (HTTP) - ! Needs authentication ``` ### Se connecter Tapez `/mcp` dans une session, choisissez le serveur et autorisez l’accès dans votre navigateur. Depuis le shell, `claude mcp login logbrew` fait la même chose. En SSH, ajoutez `--no-browser`. ```bash /mcp ``` ## Codex ### Ajouter le serveur Codex écrit une table `[mcp_servers.logbrew]` dans `~/.codex/config.toml`. Si le serveur utilise OAuth, Codex lance aussitôt la connexion et ouvre votre navigateur. ```bash codex mcp add logbrew --url https://logbrew.co/mcp ``` Sortie ```text Added global MCP server 'logbrew'. Detected OAuth support. Starting OAuth flow… ``` ### Se connecter plus tard ou en SSH Si vous fermez l’onglet du navigateur, connectez-vous plus tard avec cette commande. En SSH, ajoutez `--no-browser`, ouvrez l’URL affichée sur un autre ordinateur, puis collez l’URL de redirection complète dans le terminal. ```bash codex mcp login logbrew ``` ### Vérifier le serveur Avant la connexion, la colonne `Auth` affiche `Not logged in`. Tapez `/mcp` dans une session Codex ouverte pour voir vos serveurs actifs. ```bash codex mcp list ``` Sortie ```text Name Url Bearer Token Env Var Status Auth logbrew https://logbrew.co/mcp - enabled Not logged in ``` ## Ce que nous avons constaté en testant Nous avons lancé chaque commande de cette page sur macOS, avec des dossiers de configuration jetables définis par `CLAUDE_CONFIG_DIR` et `CODEX_HOME`, sans toucher à aucune vraie configuration. Dans Claude Code, chaque `claude mcp add` a affiché le fichier modifié. `claude mcp list` a ensuite affiché `Needs authentication` pour le nouveau serveur et `Pending approval` pour celui de `.mcp.json`. Dans Codex, `codex mcp add` a affiché `Detected OAuth support. Starting OAuth flow…`, puis une URL de connexion. Nous avions bloqué le navigateur pour le test, Codex nous a donc demandé de copier l’URL à la main. Attendez-vous à un onglet de navigateur quand vous ajoutez un serveur qui utilise OAuth. Dans les deux agents, nous nous sommes arrêtés avant l’écran de consentement. Les étapes de connexion de cette page suivent la documentation de Claude Code et de Codex. ## Corriger invalid transport dans mcp_servers Codex s’arrête avec `invalid transport` dans `mcp_servers.logbrew` quand une table de serveur n’a ni `url` ni `command`. Nous avons obtenu exactement cette erreur avec une table `[mcp_servers.logbrew]` vide. Donnez à chaque table l’un des 2 champs. Utilisez `url` pour un serveur distant et `command` pour un serveur local. Une table avec les deux échoue aussi, avec `url is not supported for stdio`. Une ligne `type = "http"` à la manière de Claude ne gêne pas, car Codex l’ignore. Le ticket #40715 montre le même message dans l’app de bureau ChatGPT sous Windows, pour une entrée `mcp_servers.codex_app` que l’utilisateur n’a jamais écrite. Le 26 août 2026, un ingénieur d’OpenAI a écrit que l’équipe travaillait sur un correctif. Le ticket est toujours ouvert. Sortie ```text Error: failed to load bootstrap configuration Caused by: invalid transport in `mcp_servers.logbrew` ``` ## Limiter les outils et les délais dans Codex `enabled_tools` garde seulement les outils que vous listez, et `disabled_tools` retire ensuite des outils. `startup_timeout_sec` et `tool_timeout_sec` valent 10 et 60 secondes par défaut. Le serveur LogBrew a 2 outils, `search` et `execute`. `codex mcp get logbrew` a affiché chaque valeur que nous avions définie. ```bash [mcp_servers.logbrew] url = "https://logbrew.co/mcp" enabled_tools = ["search", "execute"] startup_timeout_sec = 20 ``` ## Modifier la configuration de Claude Code à la main Voici le `.mcp.json` que `--scope project` a écrit pendant notre test. Claude Code demande à chaque personne d’approuver le serveur la première fois qu’il démarre dans ce projet. ```bash { "mcpServers": { "logbrew": { "type": "http", "url": "https://logbrew.co/mcp" } } } ``` ## Questions fréquentes ### Claude Code prend-il en charge les serveurs MCP distants ? Oui. Utilisez `--transport http` avec l’URL du serveur. Si le serveur utilise OAuth, Claude Code vous connecte via `/mcp` ou `claude mcp login`. ### Où Claude Code enregistre-t-il les serveurs MCP ? Les serveurs locaux et utilisateur vont dans `~/.claude.json`. Les serveurs de projet vont dans `.mcp.json`, à la racine du projet. ### Où Codex enregistre-t-il les serveurs MCP ? Dans `~/.codex/config.toml`, ou dans `.codex/config.toml` pour un projet de confiance. ### Comment supprimer un serveur MCP ? Lancez `claude mcp remove logbrew` ou `codex mcp remove logbrew`. Dans Claude Code, lancez d’abord `claude mcp logout logbrew` si vous voulez aussi révoquer le jeton. ## Laissez votre agent lire les erreurs de production Le serveur MCP de LogBrew donne à Claude Code, Codex et tout autre client MCP les erreurs, logs et traces des projets que vous approuvez. Il a un accès en lecture seule, sauf si vous autorisez plus. Commencez avec le forfait Free généreux, sans carte bancaire. [Connecter votre agent](https://logbrew.co/fr/agents) ## Sources - [Claude Code docs, Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp) - [Codex docs, Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) - [openai/codex#40715](https://github.com/openai/codex/issues/40715) ## Autres guides pour les agents de code IA - [Utiliser AGENTS.md dans Claude Code et Codex](https://logbrew.co/fr/guides/agents-md) - [Corriger l’erreur Claude overloaded 529 et l’erreur rate limit 429](https://logbrew.co/fr/guides/claude-overloaded-rate-limit-error) - [Corriger les erreurs dans Claude Code, Codex et le JavaScript du navigateur](https://logbrew.co/fr/guides)