リモート MCP サーバーをテストする

リモートかつ認可付きの接続は、Model Context Protocol (MCP) 仕様 ↗のなかでも発展中の部分です。すべての MCP クライアントが、まだリモート接続に対応しているわけではありません。

このガイドでは、リモート接続に対応した MCP クライアントで、リモート MCP サーバーを使い始める方法を示します。まだリモート MCP サーバーを作成・デプロイしていない場合は、先にリモート MCP サーバーを構築するを実施してください。

Model Context Protocol (MCP) Inspector

@modelcontextprotocol/inspector パッケージ ↗ は、MCP サーバー向けの視覚的なテストツールです。

ターミナルを開き、次のコマンドを実行します。
```
npx @modelcontextprotocol/inspector
```
```
🚀 MCP Inspector is up and running at:
	http://localhost:5173/?MCP_PROXY_AUTH_TOKEN=46ab..cd3

🌐 Opening browser...
```
MCP Inspector が Web ブラウザーで起動します。ブラウザーを開いて http://localhost:<PORT> にアクセスし、手動で起動することもできます。MCP Inspector が動いているローカルポートは、コマンド出力で確認してください。この例では、MCP Inspector はポート 5173 で提供されています。
MCP Inspector で、MCP サーバーの URL を入力します（例: http://localhost:8788/mcp）。Connect を選択します。

ローカルマシン上の MCP サーバーにも、Cloudflare 上のリモート MCP サーバーにも接続できます。
サーバーが認証を要求する場合、接続は失敗します。認証するには次の手順を行います。
1. MCP Inspector で Open Auth settings を選択します。
2. Quick OAuth Flow を選択します。
3. OAuth プロバイダーでの認証が完了すると、MCP Inspector に戻ります。Connect を選択します。

List tools ボタンが表示されます。これを使うと、MCP サーバーが公開しているツールの一覧を取得できます。

Workers AI Playground ↗ を開き、MCP サーバーの URL を入力して「Connect」をクリックします。認証が必要な場合は完了すると、ツールが一覧表示され、チャット内の AI モデルから利用できます。

mcp-remote ローカルプロキシ ↗ を使うと、Claude Desktop をリモート MCP サーバーに接続できます。実際の MCP クライアントで、リモート MCP サーバーとのやり取りがどうなるかを確認できます。

Claude Desktop を開き、Settings -> Developer -> Edit Config に移動します。Claude がアクセスできる MCP サーバーを制御する設定ファイルが開きます。
内容を、次のような設定に置き換えます。

{
	"mcpServers": {
		"my-server": {
			"command": "npx",
			"args": ["mcp-remote", "http://my-mcp-server.my-account.workers.dev/mcp"]
		}
	}
}

ファイルを保存し、Claude Desktop を再起動します（command/ctrl + R）。Claude の再起動時に、OAuth のログインページを示すブラウザーウィンドウが開きます。認可フローを完了し、Claude に MCP サーバーへのアクセスを許可します。

認証後、Claude の画面右下にあるツールアイコンをクリックすると、ツールを確認できます。

プロジェクトの .cursor/mcp.json、またはグローバルの ~/.cursor/mcp.json を編集し、次の設定を追加すると、Cursor ↗ をリモート MCP サーバーに接続できます。

{
	"mcpServers": {
		"my-server": {
			"url": "http://my-mcp-server.my-account.workers.dev/mcp"
		}
	}
}

mcp_config.json ファイル ↗ を編集し、次の設定を追加すると、リモート MCP サーバーを Windsurf ↗ に接続できます。

{
	"mcpServers": {
		"my-server": {
			"serverUrl": "http://my-mcp-server.my-account.workers.dev/mcp"
		}
	}
}