Serwery MCP Cloudflare

Właśnie wdrożyłeś Cloudflare Workera obsługującego uwierzytelnianie. Działa w środowisku deweloperskim, ale coś jest nie tak w produkcji — odczyty z KV zwracają nieaktualne dane, a uprawnienia bucketu R2 wyglądają źle. Otwierasz cztery karty przeglądarki: panel Workers, przeglądarkę namespace KV, ustawienia bucketu R2 i dokumentację Cloudflare. Kopiujesz wartości między kartami, porównujesz konfiguracje i tracisz dwadzieścia minut, zanim znajdziesz problem. Jedna literówka w nazwie powiązania namespace.

Serwery MCP Cloudflare przenoszą całą twoją infrastrukturę edge do kontekstu AI. AI czyta kod twojego Workera, sprawdza namespace’y KV, odpytuje bazy danych D1, weryfikuje buckety R2 i przeszukuje dokumentację Cloudflare — wszystko w jednej rozmowie w edytorze.

Czego się nauczysz

• Konfiguracja zarządzanych zdalnych serwerów MCP Cloudflare
• Przegląd wszystkich 16 dostępnych serwerów i kiedy używać każdego z nich
• Prompty do wdrażania Workers, zarządzania KV/R2, zapytań D1 i wyszukiwania dokumentacji
• Przepływ uwierzytelniania OAuth i wybór konta

Jak działa Cloudflare MCP

Cloudflare uruchamia zdalne serwery MCP — w przeciwieństwie do większości serwerów MCP, które działają lokalnie na twoim komputerze, są to hostowane usługi uwierzytelniające się przez OAuth. Przy pierwszym połączeniu otwiera się okno przeglądarki do logowania w Cloudflare. Po uwierzytelnieniu wybierasz, którego konta Cloudflare użyć, a serwer MCP działa z uprawnieniami twojego konta.

Wszystkie serwery MCP Cloudflare stosują ten sam wzorzec URL: https://{service}.mcp.cloudflare.com/mcp

Pełny katalog serwerów

Cloudflare udostępnia 16 zarządzanych serwerów MCP, ale nie potrzebujesz ich wszystkich. Zacznij od tych, które pasują do twojego stosu technologicznego:

Serwer	URL	Co robi
Workers Bindings	https://bindings.mcp.cloudflare.com/mcp	Zarządzanie powiązaniami Workers (KV, R2, D1 itp.)
Workers Builds	https://builds.mcp.cloudflare.com/mcp	Wdrażanie, budowanie i inspekcja Workers
KV	https://kv.mcp.cloudflare.com/mcp	Odczyt/zapis namespace’ów KV
R2	https://r2.mcp.cloudflare.com/mcp	Zarządzanie bucketami obiektowego storage’u
D1	https://d1.mcp.cloudflare.com/mcp	Zapytania do baz SQLite na edge
Durable Objects	https://do.mcp.cloudflare.com/mcp	Inspekcja stanowych obiektów edge
Pages	https://pages.mcp.cloudflare.com/mcp	Zarządzanie wdrożeniami Pages
DNS	https://dns.mcp.cloudflare.com/mcp	Zarządzanie rekordami DNS
Logs	https://logs.mcp.cloudflare.com/mcp	Zapytania do logów i analityk Workers
Queues	https://queues.mcp.cloudflare.com/mcp	Zarządzanie kolejkami wiadomości
Vectorize	https://vectorize.mcp.cloudflare.com/mcp	Zarządzanie indeksami wyszukiwania wektorowego
AI Gateway	https://ai-gateway.mcp.cloudflare.com/mcp	Monitorowanie routingu zapytań AI
Browser Rendering	https://browser-rendering.mcp.cloudflare.com/mcp	Przeglądarka headless na edge
Hyperdrive	https://hyperdrive.mcp.cloudflare.com/mcp	Pooling połączeń bazodanowych
Images	https://images.mcp.cloudflare.com/mcp	Optymalizacja i transformacja obrazów
Stream	https://stream.mcp.cloudflare.com/mcp	Zarządzanie strumieniowaniem wideo
Docs	https://docs.mcp.cloudflare.com/mcp	Wyszukiwanie dokumentacji Cloudflare

Wskazówka

Zacznij od dwóch lub trzech serwerów. Dodanie wszystkich 16 naraz przytłacza kontekst AI opisami narzędzi, których nie potrzebuje. Dodawaj kolejne w miarę potrzeb.

Konfiguracja: Workers + KV + D1 (zalecany punkt wyjścia)

Cursor

{
  "mcpServers": {
    "cloudflare-bindings": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://bindings.mcp.cloudflare.com/mcp"]
    },
    "cloudflare-builds": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://builds.mcp.cloudflare.com/mcp"]
    },
    "cloudflare-kv": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://kv.mcp.cloudflare.com/mcp"]
    },
    "cloudflare-d1": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://d1.mcp.cloudflare.com/mcp"]
    }
  }
}

Claude Code

claude mcp add cf-bindings -- npx -y mcp-remote https://bindings.mcp.cloudflare.com/mcp
claude mcp add cf-builds -- npx -y mcp-remote https://builds.mcp.cloudflare.com/mcp
claude mcp add cf-kv -- npx -y mcp-remote https://kv.mcp.cloudflare.com/mcp
claude mcp add cf-d1 -- npx -y mcp-remote https://d1.mcp.cloudflare.com/mcp

Lub dodaj do .claude/settings.json:

{
  "mcpServers": {
    "cloudflare-bindings": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://bindings.mcp.cloudflare.com/mcp"]
    },
    "cloudflare-builds": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://builds.mcp.cloudflare.com/mcp"]
    },
    "cloudflare-kv": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://kv.mcp.cloudflare.com/mcp"]
    },
    "cloudflare-d1": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://d1.mcp.cloudflare.com/mcp"]
    }
  }
}

Codex

[mcp.cloudflare-bindings]
transport = "http"
url = "https://bindings.mcp.cloudflare.com/mcp"

[mcp.cloudflare-builds]
transport = "http"
url = "https://builds.mcp.cloudflare.com/mcp"

[mcp.cloudflare-kv]
transport = "http"
url = "https://kv.mcp.cloudflare.com/mcp"

[mcp.cloudflare-d1]
transport = "http"
url = "https://d1.mcp.cloudflare.com/mcp"

Każdy serwer uruchamia własny przepływ OAuth przy pierwszym użyciu. Po pierwszej autoryzacji poświadczenia są zapisywane lokalnie w pamięci podręcznej.

Przepływy pracy z Workers

Wskazówka

Gotowy prompt do debugowania Workera:

“List all my deployed Workers. Find the one handling authentication routes. Read its code and check for any issues with the KV binding configuration. Compare the binding names in the Worker code to the actual KV namespaces in my account and flag any mismatches.”

Wskazówka

Gotowy prompt do tworzenia Workera:

“Create a new Cloudflare Worker called ‘api-rate-limiter’ that uses a KV namespace to track request counts per IP address. The Worker should allow 100 requests per minute per IP and return a 429 response with a Retry-After header when the limit is exceeded. Deploy it to my account.”

Przepływy pracy z KV i D1

Wskazówka

Gotowy prompt do inspekcji danych:

“List all KV namespaces in my account. For the namespace called ‘user-sessions’, list the last 20 keys and read the value of the most recent one. Check if the session data structure matches what the Worker code in src/worker.ts expects.”

Wskazówka

Gotowy prompt do zarządzania bazą danych D1:

“List my D1 databases. Connect to the ‘production’ database and show the schema for all tables. Then run a query to count active users from the last 7 days, grouped by signup source. Compare the schema to the Drizzle ORM types in src/lib/db/schema.ts and flag any drift.”

Wyszukiwanie dokumentacji Cloudflare

Serwer MCP Docs jest niedoceniany. Zamiast przeszukiwać docs.cloudflare.com w przeglądarce, AI przeszukuje dokumentację Cloudflare bezpośrednio i stosuje to, co znajdzie, do twojego kodu.

Cursor

{
  "mcpServers": {
    "cloudflare-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mcp.cloudflare.com/mcp"]
    }
  }
}

Claude Code

claude mcp add cf-docs -- npx -y mcp-remote https://docs.mcp.cloudflare.com/mcp

Codex

[mcp.cloudflare-docs]
transport = "http"
url = "https://docs.mcp.cloudflare.com/mcp"

Wskazówka

Gotowy prompt do programowania opartego na dokumentacji:

“Search the Cloudflare documentation for how to set up Durable Objects with WebSocket hibernation. Read the relevant docs and then implement a chat room Durable Object in src/durable-objects/chat-room.ts that follows Cloudflare’s recommended patterns exactly.”

Kiedy coś się psuje

Przepływ OAuth nie działa. OAuth Cloudflare przekierowuje na localhost. Jeśli coś blokuje wywołania zwrotne localhost (VPN, korporacyjne proxy, rozszerzenia przeglądarki), przepływ się zawiesza. Spróbuj innej przeglądarki lub tymczasowo wyłącz proxy.

Wybrano złe konto. Jeśli masz wiele kont Cloudflare, serwer MCP pozwala wybrać, którego użyć. Jeśli widzisz nieprawidłowe Workers lub namespace’y KV, odłącz się i ponownie połącz, aby wybrać właściwe konto.

Limity zapytań. Serwery MCP Cloudflare są zasilane przez API Cloudflare, które ma limity zapytań. Jeśli je osiągniesz, zmniejsz zakres swoich promptów. Zamiast “list all KV keys”, spróbuj “list the first 50 KV keys matching the prefix ‘user:’”.

Nieaktualne dane po wdrożeniach. Jeśli wdrożysz Workera przez Wrangler, a następnie zapytasz serwer MCP o niego, może wystąpić krótkie opóźnienie, zanim nowe wdrożenie się pojawi. Poczekaj 10-15 sekund i spróbuj ponownie.

Zbyt wiele serwerów MCP spowalnia uruchamianie. Każdy serwer MCP Cloudflare dodaje opisy narzędzi do kontekstu AI. Jeśli masz podłączone wszystkie 16, to setki opisów narzędzi konkurujących o uwagę. Podłączaj tylko serwery, których aktywnie potrzebujesz.

Co dalej

Bezpieczeństwo MCP Zabezpiecz swoje zdalne połączenia MCP za pomocą OAuth i kontroli dostępu.

MCP do baz danych Połącz się z bazami danych innymi niż Cloudflare D1.