Skip to content

Commit 1f2b21b

Browse files
authored
fix: remote mcp servers testing docs (#26790)
* fix: remote servers testing docs * fix: cursor link
1 parent 0ba4dc2 commit 1f2b21b

File tree

1 file changed

+20
-9
lines changed

1 file changed

+20
-9
lines changed

src/content/docs/agents/guides/test-remote-mcp-server.mdx

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,10 @@ Once you have authenticated, you will be redirected back to the inspector. You s
3131

3232
![MCP inspector — authenticated](~/assets/images/agents/mcp-inspector-authenticated.png)
3333

34+
## Connect your remote MCP server to Cloudflare Workers AI Playground
35+
36+
Visit the [Workers AI Playground](https://playground.ai.cloudflare.com/), enter your MCP server URL, and click "Connect". Once authenticated (if required), you should see your tools listed and they will be available to the AI model in the chat.
37+
3438
## Connect your remote MCP server to Claude Desktop via a local proxy
3539

3640
Even though [Claude Desktop](https://claude.ai/download) doesn't yet support remote MCP clients, you can use the [`mcp-remote` local proxy](https://www.npmjs.com/package/mcp-remote) to connect it to your remote MCP server. This lets you to test what an interaction with your remote MCP server will be like with a real-world MCP client.
@@ -41,34 +45,41 @@ Even though [Claude Desktop](https://claude.ai/download) doesn't yet support rem
4145
```json
4246
{
4347
"mcpServers": {
44-
"math": {
48+
"my-server": {
4549
"command": "npx",
46-
"args": ["mcp-remote", "http://my-mcp-server.my-account.workers.dev/sse"]
50+
"args": ["mcp-remote", "http://my-mcp-server.my-account.workers.dev/mcp"]
4751
}
4852
}
4953
}
5054
```
5155

52-
This tells Claude to communicate with your MCP server running at `http://localhost:8788/sse`.
53-
5456
3. Save the file and restart Claude Desktop (command/ctrl + R). When Claude restarts, a browser window will open showing your OAuth login page. Complete the authorization flow to grant Claude access to your MCP server.
5557

5658
Once authenticated, you'll be able to see your tools by clicking the tools icon in the bottom right corner of Claude's interface.
5759

5860
## Connect your remote MCP server to Cursor
5961

60-
To connect [Cursor](https://www.cursor.com/) with your remote MCP server, choose `Type`: "Command" and in the `Command` field, combine the command and args fields into one (e.g.`npx mcp-remote https://your-worker-name.your-account.workers.dev/sse`).
62+
Connect [Cursor](https://cursor.com/docs/context/mcp) to your remote MCP server by editing the project's `.cursor/mcp.json` file or a global `~/.cursor/mcp.json` file and adding the following configuration:
63+
64+
```json
65+
{
66+
"mcpServers": {
67+
"my-server": {
68+
"url": "http://my-mcp-server.my-account.workers.dev/mcp"
69+
}
70+
}
71+
}
72+
```
6173

6274
## Connect your remote MCP server to Windsurf
6375

64-
You can connect your remote MCP server to [Windsurf](https://codeium.com/windsurf) by editing the [`mcp_config.json` file](https://docs.codeium.com/windsurf/mcp), and adding the following configuration:
76+
You can connect your remote MCP server to [Windsurf](https://docs.windsurf.com) by editing the [`mcp_config.json` file](https://docs.windsurf.com/windsurf/cascade/mcp), and adding the following configuration:
6577

6678
```json
6779
{
6880
"mcpServers": {
69-
"math": {
70-
"command": "npx",
71-
"args": ["mcp-remote", "http://my-mcp-server.my-account.workers.dev/sse"]
81+
"my-server": {
82+
"serverUrl": "http://my-mcp-server.my-account.workers.dev/mcp"
7283
}
7384
}
7485
}

0 commit comments

Comments
 (0)