测试远程 MCP 服务器

带授权的远程连接是 Model Context Protocol (MCP) 规范 ↗ 中正在演进的部分。并非所有 MCP 客户端都已支持远程连接。

本指南介绍如何使用支持远程连接的 MCP 客户端连接到你的远程 MCP 服务器。如果你尚未创建并部署远程 MCP 服务器,请先按照构建远程 MCP 服务器指南完成部署。

Model Context Protocol (MCP) Inspector

@modelcontextprotocol/inspector ↗ 是一个用于 MCP 服务器的可视化测试工具。

打开终端,运行下面的命令: Terminal window

npx @modelcontextprotocol/inspector

🚀 MCP Inspector is up and running at:
  http://localhost:5173/?MCP_PROXY_AUTH_TOKEN=46ab..cd3
🌐 Opening browser...

MCP Inspector 会在浏览器中启动。你也可以手动在浏览器里访问 http://localhost:<PORT>。检查命令输出中显示的本地端口。本例中,MCP Inspector 运行在端口 5173 上。 2. 在 MCP Inspector 中输入你的 MCP 服务器 URL(例如 http://localhost:8788/mcp),点击 Connect。你可以连接到本机运行的 MCP 服务器,也可以连接到运行在 Cloudflare 上的远程 MCP 服务器。 3. 如果你的服务器需要认证,连接会失败。要进行认证:

在 MCP Inspector 中点击 Open Auth settings。
选择 Quick OAuth Flow。
完成 OAuth 提供商认证后,你会被重定向回 MCP Inspector。点击 Connect。

你应该能看到 List tools 按钮,它会列出你的 MCP 服务器暴露的工具。

连接到 Cloudflare Workers AI Playground

访问 Workers AI Playground ↗,输入你的 MCP 服务器 URL,点击 “Connect”。完成认证(如有要求)后,你应该能看到工具列表,这些工具会在聊天中提供给 AI 模型使用。

通过本地代理把远程 MCP 服务器连接到 Claude Desktop

你可以使用 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 界面右下角的工具图标查看你的工具。

把远程 MCP 服务器连接到 Cursor

通过编辑项目的 .cursor/mcp.json 文件或全局的 ~/.cursor/mcp.json 文件并加入如下配置,把 Cursor ↗ 连接到你的远程 MCP 服务器:


{

  "mcpServers": {

    "my-server": {

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

    }

  }

}

把远程 MCP 服务器连接到 Windsurf

通过编辑 mcp_config.json 文件 ↗ 并加入如下配置,把你的远程 MCP 服务器连接到 Windsurf ↗:


{

  "mcpServers": {

    "my-server": {

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

    }

  }

}