Error: invalid server name '<name>' (use letters, numbers, '-', '_') の原因と直し方 | Codex CLI

エラー文字列

Codex CLI

Error: invalid server name '<name>' (use letters, numbers, '-', '_')

⚠️ 標準エラーに出て、終了コードは 1 です。 設定は書き換えられません。

MCP サーバーの名前に使えない文字が入っています。使えるのは次だけです。

使える	使えない
英字・数字・`-`・`_`	空白・記号・日本語

⭐ 空白が最も多い原因です。 表示名のつもりで my server と書くと弾かれます。

v0.149.0 で実測しました。

実行したもの	結果
`codex mcp add "my server" -- echo hi`	`Error: invalid server name 'my server' (use letters, numbers, '-', '_')`
`codex mcp add my-server -- echo hi`	`Added global MCP server 'my-server'.`（成功）

codex mcp add my-server -- echo hi
codex mcp add my_server -- echo hi

codex mcp list

⚠️ エラーが出た場合、設定には何も書かれていません。 半端に登録されることはないので、名前を直して実行し直すだけで済みます。

この名前は設定ファイルのキーになり、あとから参照するときにも使います。短く、打ちやすい形にしてください。

良い	避ける
`github` `local-fs` `db_readonly`	`GitHub の MCP` `my server (test)`