No MCP server named '<name>' found. の原因と直し方 | Codex CLI

エラー文字列

Codex CLI

No MCP server named '<name>' found.

🔴 このメッセージが出ても、終了コードは 0（成功）です。 標準出力に出ます。 CI では何も削除されないまま緑になります。

codex mcp remove に渡した名前のサーバーが登録されていません。

⚠️ 失敗として扱われません。 「消すものが無かった」は正常終了です。

v0.149.0 で実測した対応表です。

実行したもの	出力	終了コード
登録済みの名前を削除	（削除される）	0
登録の無い名前を削除	`No MCP server named 'nonexistent-xyz' found.`	0

⭐ 終了コードでは、消えたかどうかを判定できません。

codex mcp list

⭐ ここに出る綴りをそのまま使ってください。 表示名ではなく識別子です。

Windows（PowerShell）

if ($env:CODEX_HOME) { "CODEX_HOME = $env:CODEX_HOME" } else { "既定: $env:USERPROFILE\.codex" }

macOS / Linux

echo "${CODEX_HOME:-$HOME/.codex}"

⚠️ 追加したときと削除するときで、この値が同じか確認してください。CI が環境変数を変えていると、別の場所を見にいきます。

終了コードが 0 でも消えていないので、出力を見て判定します。

out=$(codex mcp remove "$NAME")

if printf '%s' "$out" | grep -q '^No MCP server named'; then
  echo "削除対象がありませんでした: $out" >&2
  exit 1
fi

Windows（PowerShell）

$out = codex mcp remove $Name
if ($out -match '^No MCP server named') {
  Write-Error "削除対象がありませんでした: $out"
  exit 1
}

codex mcp list