home / mcp / remote cloudflare mcp server
cloudflare-mcp-server
Configuration
View docs{
"mcpServers": {
"ishaangupta-yb-cloudflare-mcp-server": {
"url": "https://remote-mcp-server-authless.<your-account>.workers.dev/sse"
}
}
}You can run a remote MCP server on Cloudflare Workers that exposes your tools to clients without requiring authentication. This setup lets you deploy, connect from AI playgrounds, and use local MCP clients to access your tools remotely.
Connect to your remote MCP server from the Cloudflare AI Playground to try your tools directly in the browser. Open the Playground, enter the deployed server URL, and you can invoke your MCP tools in a hosted environment.
Connect to your remote MCP server from Claude Desktop or other local MCP clients using the mcp-remote proxy. If you want to run tools locally through the proxy, use the provided server URL for the remote endpoint.
{
"mcpServers": {
"remote_authless": {
"type": "http",
"url": "https://remote-mcp-server-authless.<your-account>.workers.dev/sse",
"args": []
},
"calculator_mcp": {
"type": "stdio",
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8787/sse"
]
}
}
}To connect Claude Desktop to your remote MCP server, import the stdio configuration shown in the deployment snippet and restart Claude. You should see your tools become available for use through the proxy.
Prerequisites: ensure you have Node.js and npm installed on your machine.
Install and initialize the remote MCP server on Cloudflare using the following command. This creates a Cloudflare-styled MCP server that runs without authentication.
npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authlessAfter deployment, you will access the MCP server at a URL similar to remote-mcp-server-authless.YOUR_ACCOUNT.workers.dev/sse.
Customizing your MCP server is done by editing the server’s init logic to register tools. In the deployment template, tools are added by calling this.server.tool(...) within the initialization method.
Useful connection options include: - Cloudflare AI Playground: use your deployed URL to test tools in the browser. - Claude Desktop: run the mcp-remote proxy locally and point Claude at your remote server for seamless access to tools.
Notes and considerations: - The remote server URL is the endpoint you share with clients. - The local mcp-remote proxy URL is used by local MCP clients to reach the remote server. - You can customize tools by editing the init method in the source to add your own tool definitions.
You can add your own tools to the MCP server by defining each tool inside the init() method using this.server.tool(...). This is how you expose new capabilities to clients without changing client code.