# クライアントを接続する

> Claude、Codex、Gemini CLI、GitHub Copilot、そしてそのほかの MCP のクライアントのための、そのまま使える設定。

**クライアントを接続する**のカードが、対応しているクライアントを 1 つずつ案内します。そこに出る例は、設定したポートをすでに含んでいます（下の例では既定の 18181 を使います）。ローカルのクライアントはどれも、トンネルなしで endpoint に直接つながります。

## Claude {#claude}

Claude Chat（デスクトップアプリ）と Claude Code（CLI/デスクトップアプリ）は設定が別々です。一方をつないでも、もう一方はつながりません。

- **Claude Chat（デスクトップアプリ）**：いちばん簡単な道です。ワンクリックの **MCP バンドル（`.mcpb`）**がアプリに同梱されています。**Claude Desktop にインストール**を押し（ファイルを残したいときは**名前を付けて保存…**）、Claude Desktop のインストールのダイアログで確定してください。バンドルには、Claude の stdio の通信からこのステーションの HTTP の endpoint への小さなローカルの橋渡しが入っています。必要な Node のランタイムは Claude Desktop に付属します。ポートを変えている場合は、インストールのダイアログで endpoint を合わせてください。
- **Claude Code（CLI/デスクトップアプリ）**：ターミナルのコマンド 1 つです。

```
claude mcp add --transport http ganterlab http://127.0.0.1:18181/mcp
```

## Codex（CLI / IDE） {#codex-cli--ide}

Codex は、loopback の endpoint に Streamable HTTP のサーバーとして直接つながります。その `codex mcp add` のコマンドは stdio のサーバーしか扱わないので、HTTP の書き方は `~/.codex/config.toml` に入れます。

```
[mcp_servers.ganterlab]
url = "http://127.0.0.1:18181/mcp"
```

## Gemini CLI {#gemini-cli}

Gemini CLI は、`~/.gemini/settings.json` の `httpUrl` のサーバー種別でつながります。（Gemini の Web チャットには、トンネルを使わずにローカルへつながる道がないので、CLI だけを案内します。）

```
{
  "mcpServers": {
    "ganterlab": {
      "httpUrl": "http://127.0.0.1:18181/mcp"
    }
  }
}
```

## GitHub Copilot {#github-copilot}

道は 2 つあり、最上位の鍵も 2 つに分かれます。

- **VS Code**：サーバーを `.vscode/mcp.json` に追加し（またはコマンドパレットから「MCP: Open User Configuration」を実行し）、Copilot Chat のツールの選択で有効にします。

```
{
  "servers": {
    "ganterlab": {
      "type": "http",
      "url": "http://127.0.0.1:18181/mcp"
    }
  }
}
```

- **CLI**：同じサーバーの形を、`~/.copilot/mcp-config.json` の `mcpServers` の下に置きます（または、CLI の中で `/mcp add` を実行し、HTTP のサーバー種別を選びます）。

## クラウド経由のクライアントには対応していません {#cloud-routed-clients-are-not-supported}

ChatGPT のコネクター、Gemini の Web チャット、そしてインターネットの側からステーションに届くものは、この endpoint を使えませんし、ページもそれらの設定を出しません。endpoint は、`Host` のヘッダーがローカルでない要求を、セッションの握手の前に拒否するので、トンネルは助けになりません。トンネルは自分の公開のホストを渡してきますが、それこそが拒否されるものだからです。ステーションは、エージェントのためにネットワークへ公開されることがありませんし、そうするスイッチもありません。

## そのほかの MCP クライアント {#any-other-mcp-client}

このコンピューターで動き、HTTP の MCP サーバーの URL を受け取れるクライアントなら、このステーションを使えます。ページに出ている endpoint に向けてください。