Claude CodeとCodexでMCPサーバーを設定する方法

2026/06/17(水)Claude CodeとCodexでMCPサーバーを設定する方法

投稿日：2026/06/17

技術::LLM

公式ドキュメントは読みづらいしLLM本人はまともに説明しないし、ググっても具体的でパッと解る記事が出てこなかったので書く。

確認環境

Env	Ver
Codex CLI	0.0140.0
Claude Code	2.1.179

Codex

設定例

~/.codex/config.tomlを開き、ファイルの最後に以下を追記

[mcp_servers.hoge]
command = "/path/to/some-command"

[mcp_servers.hoge.env]
URL = "https://example.com"
API_KEY = "xxxxxxxxxx"

書式

MCPサーバー名の部分は解りやすい名前を入れておくといい。PukiwikiのMCPならpukiwiki、Redmineならredmineなど。

[mcp_servers.<MCPサーバー名>]
command = "MCPサーバーの起動コマンド"

[mcp_servers.<MCPサーバー名>.env]
このセクションには<KEY> = "<VALUE>"形式で環境変数を列挙する
必要な環境変数がなければ、このセクションは作らなくてよい

Claude Code

設定例

~/.claude.jsonを開き、projects."/path/to".mcpServersをこんな感じで書き換える。

"mcpServers": {
    "hoge": {
        "type": "stdio",
        "command": "/path/to/some-command",
        "env": {
            "URL": "https://example.com",
            "API_KEY": "xxxxxxxxxx"
        }
    }
},

書式

MCPサーバー名の部分は解りやすい名前を入れておくといい。PukiwikiのMCPならpukiwiki、Redmineならredmineなど。

"mcpServers": {
    "<MCPサーバー名>": {
        "type": "stdio", ← おまじない
        "command": "/path/to/some-command", ← MCPサーバーの起動コマンド
        "env": { ← ここに環境引数をKEY: VALUE形式で書く。なければこのセクションは不要
            "URL": "https://example.com",
            "API_KEY": "xxxxxxxxxx"
        }
    }
},

mcp addで追加した場合に起きていること

claude mcp add hoge -- npx -y git@github.com:Hoge/hoge-mcp.git

このコマンドで追加すると、~/.claude.jsonに叩いたカレントディレクトリの設定として以下が追加される。

"mcpServers": {
  "hoge": {
    "type": "stdio",
    "command": "npx",
    "args": [
      "-y",
      "git@github.com:Hoge/hoge-mcp.git"
    ],
    "env": {}
  }
},

やってることは要するにnpx -y git@github.com:Hoge/hoge-mcp.gitを実行しているだけである。

Node.js製のMCPサーバーをローカルにクローンして設定する場合の手順の一例

まずはリポジトリをローカルに持ってくる

cd ~
mkdir mcp
cd mcp
git clone git@github.com:Hoge/hoge-mcp.git
cd hoge-mcp
pnpm i && pnpm build
pnpm approve-builds
pnpm build
chmod u+x dist/index.js

使うLLMに応じて設定を行う

Codex
~/.codex/config.tomlを開き、ファイルの最後に以下を追記

[mcp_servers.hoge]
command = "/home/fuga/mcp/hoge-mcp/dist/index.js"

[mcp_servers.hoge.env]
URL = "https://hoge.example.com"
API_KEY = "xxxxxxxxxx"

Claude Code

MCPを使いたいパスでclaude mcp add hoge -- hogeを叩く

~/.claude.jsonを開き、先ほど叩いたパスのエントリを探し、mcpServersのところを次の形式で書き換える

"mcpServers": {
   "hoge": {
       "type": "stdio",
       "command": "/home/fuga/mcp/hoge-mcp/dist/index.js",
       "env": {
           "URL": "https://hoge.example.com",
           "API_KEY": "xxxxxxxxxx"
       }
   }
},