mcp / add-stdio · 約 8 分

stdio サーバを追加する

codex mcp add NAME -- command の形を確認し、list します。

学習目標

codex mcp add <server-name> --env VAR1=VALUE1 -- <stdio server-command>
codex mcp list

公式例は Context7 です。-- のあとにコマンドが続きます。 ^[codex-mcp]

学習用の filesystem 例(ディレクトリは自分の workspace に置き換えてください):

codex mcp add fs -- npx -y @modelcontextprotocol/server-filesystem .
codex mcp list

secret を --env に書くなら、値を Git にコミットしないでください。

前提

Node / npx。project .codex/config.toml は trusted なときだけ読みます。

既存ファイルがあるときの統合:

1. サイトの starter 保存が既存ファイルを勝手に全置換しない前提で、不足テーブルだけを追記する。
2. 少なくとも [features] hooks = true を残す(hooks 章の設定を消さない)。
3. [mcp_servers.fs] を追加する。

starter 例(単体で置く場合。既存があればマージ):

[features]
hooks = true

[mcp_servers.fs]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "."]
startup_timeout_sec = 20

なぜ必要か

stdio はローカルプロセスです。HTTP とは設定キーが違います。

実行場所

Codex 操作は local-bridge です。Web実習 (browser) では config の TOML 編集はできますが、codex mcp list は動きません。

成功結果

workspace の config に mcp_servers.fs と features.hooks = true があり、codex mcp list が終了コード 0 です。

失敗対処

起動タイムアウトは startup_timeout_sec(既定 10)を上げます。npx 初回は特に遅いです。 ^[codex-mcp]