クライアントを接続する
Claude、Codex、Gemini CLI、GitHub Copilot、そしてそのほかの MCP のクライアントのための、そのまま使える設定。
クライアントを接続するのカードが、対応しているクライアントを 1 つずつ案内します。そこに出る例は、設定したポートをすでに含んでいます(下の例では既定の 18181 を使います)。ローカルのクライアントはどれも、トンネルなしでエンドポイントに直接つながります。
Claude
Claude Chat(デスクトップアプリ)と Claude Code(CLI/デスクトップアプリ)は設定が別々です。一方をつないでも、もう一方はつながりません。
- Claude Chat(デスクトップアプリ):いちばん簡単な道です。ワンクリックの MCP バンドル(
.mcpb)がアプリに同梱されています。Claude Desktop にインストールを押し(ファイルを残したいときは名前を付けて保存…)、Claude Desktop のインストールのダイアログで確定してください。バンドルには、Claude の stdio の通信からこのステーションの HTTP のエンドポイントへの小さなローカルの橋渡しが入っています。必要な Node のランタイムは Claude Desktop に付属します。ポートを変えている場合は、インストールのダイアログでエンドポイントを合わせてください。 - Claude Code(CLI/デスクトップアプリ):ターミナルのコマンド 1 つです。
claude mcp add --transport http ganterlab http://127.0.0.1:18181/mcp
Codex(CLI / IDE)
Codex は、loopback のエンドポイントに 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/settings.json の httpUrl のサーバー種別でつながります。(Gemini の Web チャットには、トンネルを使わずにローカルへつながる道がないので、CLI だけを案内します。)
{
"mcpServers": {
"ganterlab": {
"httpUrl": "http://127.0.0.1:18181/mcp"
}
}
}
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 のサーバー種別を選びます)。
クラウド経由のクライアントには対応していません
ChatGPT のコネクター、Gemini の Web チャット、そしてインターネットの側からステーションに届くものは、このエンドポイントを使えませんし、ページもそれらの設定を出しません。エンドポイントは、Host のヘッダーがローカルでない要求を、セッションの握手の前に拒否するので、トンネルは助けになりません。トンネルは自分の公開のホストを渡してきますが、それこそが拒否されるものだからです。ステーションは、エージェントのためにネットワークへ公開されることがありませんし、そうするスイッチもありません。
そのほかの MCP のクライアント
このコンピューターで動き、HTTP の MCP サーバーの URL を受け取れるクライアントなら、このステーションを使えます。ページに出ているエンドポイントに向けてください。