Remote MCP Flodesk2

You can deploy and run a remote MCP server that exposes your tools over a simple HTTP endpoint or via local clients, enabling quick, authentication-free access to your MCP-powered capabilities from Cloudflare Workers or from local MCP clients. This guide shows practical steps to set up the server, connect from browsing playgrounds, and integrate with desktop clients.

How to use

You will run a remote MCP server that serves tools to MCP clients. Use the HTTP endpoint to access the server from any MCP client or connect from local tools using the provided stdio configuration. In practical terms, you deploy the server, customize the available tools in your init routine, and then connect from the Cloudflare AI Playground or from your desktop MCP client using the exact URLs or commands shown.

How to install

Prerequisites: Node.js installed on your machine. If you do not have Node.js, install it from the official site or using your system’s package manager.

1. Create your remote MCP server project using the Cloudflare template command.

2. Open a terminal in your project directory to customize the server and start it.

Additional steps to configure and connect

Customize your MCP server by defining each tool inside the init() method of the server’s source file, using this.server.tool(...) to register tools you want exposed to clients.

Connect to Cloudflare AI Playground with your deployed MCP server URL to access your tools from the playground interface.

Connect Claude Desktop or other local MCP clients using the provided stdio configuration or the HTTP URL. See the configurations below for exact command and URL structures.

Configuration examples for client connections

{
  "mcpServers": {
    "remote_mcp": {
      "type": "http",
      "url": "https://remote-mcp-server-authless.your-account.workers.dev/sse",
      "args": []
    }
  }
}

Additional configuration for local MCP clients

{
  "mcpServers": {
    "calculator": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}