---
title: "Claude Code と Codex に MCP サーバーを追加する"
description: "Claude Code では claude mcp add --transport http、Codex では codex mcp add --url を実行し、ログインします。どちらも LogBrew の MCP サーバーで検証しました。"
canonical: "https://logbrew.co/ja/guides/mcp-server-claude-code-codex"
last_updated: "2026-11-10"
---

# Claude Code と Codex に MCP サーバーを追加する

Claude Code では `claude mcp add --transport http`、Codex では `codex mcp add --url` を実行し、ログインします。どちらも LogBrew の MCP サーバーで検証しました。

2026年11月10日 に Claude Code 2.1.319、Codex CLI 0.167.0 で検証

執筆 [Furkan Erday](https://github.com/furkanerday). Furkan Erday は LogBrew の創業者です。毎日 Claude Code と Codex を使って LogBrew を開発しています。

Canonical: https://logbrew.co/ja/guides/mcp-server-claude-code-codex

## 1 つの MCP サーバー、2 つのエージェント

LogBrew の MCP サーバー `https://logbrew.co/mcp`

ツール `search` `execute`

|  | Claude Code | Codex |
| --- | --- | --- |
|  | `claude mcp add --transport http` | `codex mcp add --url` |
| 保存先 | `~/.claude.json` | `~/.codex/config.toml` |
| ログイン前 | `Needs authentication` | `Not logged in` |

## Claude Code

### サーバーを追加する

プロジェクトのフォルダーで実行します。Claude Code はこのプロジェクトだけにサーバーを追加し、`~/.claude.json` に保存します。

```bash
claude mcp add --transport http logbrew https://logbrew.co/mcp
```

出力

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to local config
```

### 共有する、またはすべてのプロジェクトで使う

`--scope project` はプロジェクトのルートに `.mcp.json` を書き込むので、チームは Git 経由でサーバーを受け取れます。`--scope user` はすべてのプロジェクトに追加します。

```bash
claude mcp add --transport http logbrew --scope user https://logbrew.co/mcp
```

出力

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to user config
```

### サーバーを確認する

Claude Code は一覧に出す各サーバーを確認します。ログイン前は、OAuth を使うサーバーに `Needs authentication` と表示されます。`.mcp.json` のサーバーには、セッションで承認するまで `Pending approval` と表示されます。

```bash
claude mcp list
```

出力

```text
Checking MCP server health…

logbrew: https://logbrew.co/mcp (HTTP) - ! Needs authentication
```

### ログインする

セッションで `/mcp` と入力し、サーバーを選んでブラウザーでアクセスを承認します。シェルからは `claude mcp login logbrew` でも同じことができます。SSH 経由なら `--no-browser` を付けます。

```bash
/mcp
```

## Codex

### サーバーを追加する

Codex は `~/.codex/config.toml` に `[mcp_servers.logbrew]` テーブルを書き込みます。サーバーが OAuth を使う場合、Codex はすぐにログインを始めてブラウザーを開きます。

```bash
codex mcp add logbrew --url https://logbrew.co/mcp
```

出力

```text
Added global MCP server 'logbrew'.
Detected OAuth support. Starting OAuth flow…
```

### あとで、または SSH 経由でログインする

ブラウザーのタブを閉じた場合は、あとでこのコマンドでログインします。SSH 経由なら `--no-browser` を付け、表示された URL を別のコンピューターで開き、リダイレクト先の URL 全体をターミナルに貼り付けます。

```bash
codex mcp login logbrew
```

### サーバーを確認する

ログイン前は、`Auth` 列に `Not logged in` と表示されます。開いている Codex セッションで `/mcp` と入力すると、有効なサーバーを確認できます。

```bash
codex mcp list
```

出力

```text
Name     Url                     Bearer Token Env Var  Status   Auth
logbrew  https://logbrew.co/mcp  -                     enabled  Not logged in
```

## 実際に試して確認したこと

このページのコマンドはすべて macOS で実行しました。`CLAUDE_CONFIG_DIR` と `CODEX_HOME` で使い捨ての設定フォルダーを指定したので、実際の環境は何も変わっていません。

Claude Code では、`claude mcp add` を実行するたびに変更したファイルが表示されました。そのあと `claude mcp list` は、新しいサーバーに `Needs authentication`、`.mcp.json` のサーバーに `Pending approval` と表示しました。

Codex では、`codex mcp add` が `Detected OAuth support. Starting OAuth flow…` と表示し、続けてログイン用の URL を表示しました。検証ではブラウザーが開かないようにしていたので、Codex は URL を手動でコピーするよう求めました。OAuth を使うサーバーを追加すると、ブラウザーのタブが開きます。

どちらのエージェントでも、同意画面の手前で止めました。このページのログイン手順は、Claude Code と Codex のドキュメントに沿っています。

## mcp_servers の invalid transport を直す

サーバーのテーブルに `url` も `command` もないと、Codex は `mcp_servers.logbrew` で `invalid transport` を出して止まります。空の `[mcp_servers.logbrew]` テーブルで、まさにこのエラーが出ました。

各テーブルには 2 つのうち 1 つを指定します。リモートサーバーには `url`、ローカルサーバーには `command` を使います。両方あるテーブルも `url is not supported for stdio` で失敗します。Claude 形式の `type = "http"` の行は問題ありません。Codex が無視するからです。

報告 #40715 では、Windows 版 ChatGPT デスクトップアプリで同じメッセージが出ています。対象は、ユーザーが書いていない `mcp_servers.codex_app` のエントリです。2026年8月26日、OpenAI のエンジニアが、チームで修正に取り組んでいると書きました。この報告はまだ開いています。

出力

```text
Error: failed to load bootstrap configuration

Caused by:
    invalid transport
    in `mcp_servers.logbrew`
```

## Codex でツールと待ち時間を制限する

`enabled_tools` は指定したツールだけを残し、そのあと `disabled_tools` がツールを除外します。`startup_timeout_sec` と `tool_timeout_sec` の既定値は 10 秒と 60 秒です。LogBrew のサーバーには `search` と `execute` の 2 つのツールがあります。`codex mcp get logbrew` で、設定した値がすべて表示されました。

```bash
[mcp_servers.logbrew]
url = "https://logbrew.co/mcp"
enabled_tools = ["search", "execute"]
startup_timeout_sec = 20
```

## Claude Code の設定を手で編集する

これは検証時に `--scope project` が書き込んだ `.mcp.json` です。Claude Code は、そのプロジェクトでサーバーが初めて起動するときに、各メンバーに承認を求めます。

```bash
{
  "mcpServers": {
    "logbrew": {
      "type": "http",
      "url": "https://logbrew.co/mcp"
    }
  }
}
```

## よくある質問

### Claude Code はリモート MCP サーバーに対応していますか？

はい。サーバーの URL と一緒に `--transport http` を使います。サーバーが OAuth を使う場合は、`/mcp` または `claude mcp login` で Claude Code にログインできます。

### Claude Code は MCP サーバーをどこに保存しますか？

ローカルとユーザーのサーバーは `~/.claude.json` に、プロジェクトのサーバーはプロジェクトのルートの `.mcp.json` に保存されます。

### Codex は MCP サーバーをどこに保存しますか？

`~/.codex/config.toml` です。信頼済みのプロジェクトでは `.codex/config.toml` にも保存できます。

### MCP サーバーを削除するには？

`claude mcp remove logbrew` または `codex mcp remove logbrew` を実行します。Claude Code でトークンも取り消したい場合は、先に `claude mcp logout logbrew` を実行します。

## 本番環境のエラーをエージェントに読ませる

LogBrew の MCP サーバーは、承認したプロジェクトのエラー、ログ、トレースを Claude Code、Codex、その他の MCP クライアントに渡します。許可しない限り、読み取りだけです。十分な無料プランで始められ、カードは不要です。

[エージェントを接続](https://logbrew.co/ja/agents)

## 出典

- [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)

## AI コーディングエージェントのその他のガイド

- [Claude Code と Codex で AGENTS.md を使う](https://logbrew.co/ja/guides/agents-md)
- [Claude の overloaded エラー 529 とレート制限エラー 429 を解決する](https://logbrew.co/ja/guides/claude-overloaded-rate-limit-error)
- [Claude Code、Codex、ブラウザー JavaScript のエラーを解決する](https://logbrew.co/ja/guides)