测试远程 MCP 服务器

Remote、authorized 连接是 Model Context Protocol (MCP) 规范 ↗中仍在演进的部分。并非所有 MCP 客户端都已支持 remote 连接。

本指南介绍如何在支持 remote 连接的 MCP 客户端上开始使用 remote MCP server。若你尚未创建并部署 remote MCP server，请先遵循构建 Remote MCP Server 指南。

Model Context Protocol（MCP）Inspector

@modelcontextprotocol/inspector 包 ↗是 MCP server 的可视化测试工具。

打开终端并运行以下命令：
```
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 server 的 URL（例如 http://localhost:8788/mcp）。选择 Connect（连接）。

你可以连接运行在本地机器上的 MCP server，或运行在 Cloudflare 上的 remote MCP server。
若 server 需要身份验证，连接会失败。要进行身份验证：
1. 在 MCP Inspector 中选择 Open Auth settings（打开身份验证设置）。
2. 选择 Quick OAuth Flow（快速 OAuth 流程）。
3. 通过 OAuth provider 完成身份验证后，会重定向回 MCP Inspector。选择 Connect（连接）。

你应看到 List tools（列出工具） 按钮，它会列出 MCP server 暴露的工具。

访问 Workers AI Playground ↗，输入 MCP server URL，并点击 "Connect"。完成身份验证（如需要）后，你应看到列出的工具，并可在聊天中供 AI 模型使用。

你可以使用 mcp-remote 本地代理 ↗将 Claude Desktop 连接到 remote MCP server。这样可测试 remote MCP server 在真实 MCP 客户端中的交互效果。

打开 Claude Desktop，导航至 Settings -> Developer -> Edit Config。这会打开控制 Claude 可访问哪些 MCP server 的配置文件。
将内容替换为类似以下配置：

{
	"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 server 的权限。

身份验证完成后，点击 Claude 界面右下角的工具图标即可查看工具。

通过编辑项目的 .cursor/mcp.json 或全局 ~/.cursor/mcp.json，并添加以下配置，将 Cursor ↗ 连接到 remote MCP server：

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

通过编辑 mcp_config.json 文件 ↗并添加以下配置，将 remote MCP server 连接到 Windsurf ↗：

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