クライアントを接続する

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

Markdown で表示

クライアントを接続するのカードが、対応しているクライアントを 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.jsonhttpUrl のサーバー種別でつながります。(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.jsonmcpServers の下に置きます(または、CLI の中で /mcp add を実行し、HTTP のサーバー種別を選びます)。

クラウド経由のクライアントには対応していません

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

そのほかの MCP のクライアント

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