Remote、authorized 连接是 Model Context Protocol (MCP) 规范 ↗中仍在演进的部分。并非所有 MCP 客户端都已支持 remote 连接。
本指南介绍如何在支持 remote 连接的 MCP 客户端上开始使用 remote MCP server。若你尚未创建并部署 remote MCP server,请先遵循构建 Remote MCP Server 指南。
@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 需要身份验证,连接会失败。要进行身份验证:
- 在 MCP Inspector 中选择 Open Auth settings(打开身份验证设置)。
- 选择 Quick OAuth Flow(快速 OAuth 流程)。
- 通过 OAuth provider 完成身份验证后,会重定向回 MCP Inspector。选择 Connect(连接)。
你应看到 List tools(列出工具) 按钮,它会列出 MCP server 暴露的工具。
访问 Workers AI Playground ↗,输入 MCP server URL,并点击 "Connect"。完成身份验证(如需要)后,你应看到列出的工具,并可在聊天中供 AI 模型使用。
使用 Streamable HTTP 将远程服务器直接添加到 Claude Code:
claude mcp add --transport http my-server https://my-mcp-server.my-account.workers.dev/mcp运行 claude mcp list 验证连接。如果服务器需要身份验证,请在浏览器中完成授权流程。
通过编辑项目的 .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"
}
}
}