cloudflare-mcp-server

Configure MCP server base-path and transport settings for Cloudflare Workers.

961|99|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/jezweb/claude-skills --skill cloudflare-mcp-server
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cloudflare-mcp-server
Source: https://github.com/jezweb/claude-skills/tree/main/skills/cloudflare-mcp-server
Command: npx skills add https://github.com/jezweb/claude-skills --skill cloudflare-mcp-server

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/sdk, @cloudflare/workers-oauth-provider, agents, and includes templates (resource) and references (resource) and scripts (resource) components.

What problem does it solve?

This Skill eliminates the complexity of building and deploying Model Context Protocol servers, preventing 22+ common errors that derail MCP projects.

Core Features & Use Cases

  • Production-Ready Templates: Start with Cloudflare's official MCP server templates for instant deployment.
  • Error Prevention: Automatically catches URL path mismatches - the #1 reason MCP servers fail to connect.
  • Use Case: Imagine you need to create a GitHub-integrated MCP server. Use this Skill to deploy a fully functional OAuth-enabled server in under 5 minutes.

Quick Start

Use the cloudflare-mcp-server skill to create and deploy a new MCP server using the authless template.

Frequently Asked Questions about cloudflare-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an MCP server on Cloudflare Workers without URL path errors?

Deploy MCP servers on Cloudflare Workers using production-ready templates that handle SSE and HTTP transport configuration automatically. This Skill catches URL path mismatches—the top reason MCP servers fail to connect—by validating base paths and ensuring startsWith matching against your exact deployed URL before testing.

Can I set up OAuth flows for an MCP server integrated with GitHub?

Yes. This Skill includes OAuth-enabled templates and the @cloudflare/workers-oauth-provider integration to deploy GitHub-connected MCP servers. Pre-built scripts handle OAuth configuration, Durable Objects state management, and deployment validation so your server authenticates requests correctly on first deploy.

What's the fastest way to test an MCP server before production deployment?

Run pre-deployment testing steps included in this Skill to validate URL paths, transport configuration, and McpAgent exports against your live Cloudflare Worker URL. Testing catches path mismatches and Durable Objects state issues locally, preventing 22+ common MCP deployment errors.

Do I need to manually configure base paths and transport for Cloudflare Workers MCP servers?

No. This Skill solves base-path and transport configuration problems automatically through templates and reference scripts. It handles SSE and Streamable HTTP transport setup, validates path accuracy with startsWith logic, and ensures Durable Objects and McpAgent exports match your deployed Worker URL.

Why does my MCP server connection fail after deploying to Cloudflare?

URL path mismatches between configuration and deployed Worker endpoints are the primary cause. This Skill provides debugging tools and validation scripts to identify and fix path mismatches, ensuring your MCP server's base path exactly matches the Cloudflare Workers deployment URL.

How do I handle Durable Objects state and McpAgent exports in an MCP server?

This Skill's templates and reference implementations show correct Durable Objects initialization and McpAgent export patterns for Cloudflare Workers. Pre-deployment testing validates state handling and exports match your transport configuration, preventing runtime connection failures.