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
Documentation	https://docs.mcp.cloudflare.com/mcp	Przeszukuje dokumentację referencyjną Cloudflare
Workers Bindings	https://bindings.mcp.cloudflare.com/mcp	Zarządza Workers + powiązanymi zasobami (KV, R2, D1, Durable Objects, Queues, Vectorize, Hyperdrive)
Workers Builds	https://builds.mcp.cloudflare.com/mcp	Sprawdza historię buildów Workers i zarządza nią
Observability	https://observability.mcp.cloudflare.com/mcp	Odpytuje logi, błędy i analitykę Workers
Radar	https://radar.mcp.cloudflare.com/mcp	Ruch internetowy, trendy i skany URL
Container	https://containers.mcp.cloudflare.com/mcp	Uruchamia kontener sandbox dla agenta
Browser Rendering	https://browser.mcp.cloudflare.com/mcp	Pobiera strony, zrzuty ekranu i markdown przez przeglądarkę headless
Logpush	https://logs.mcp.cloudflare.com/mcp	Podsumowuje kondycję zadań Logpush
AI Gateway	https://ai-gateway.mcp.cloudflare.com/mcp	Sprawdza logi, prompty i odpowiedzi AI Gateway
AI Search (AutoRAG)	https://autorag.mcp.cloudflare.com/mcp	Listuje i odpytuje indeksy dokumentów AutoRAG
Audit Logs	https://auditlogs.mcp.cloudflare.com/mcp	Odpytuje logi audytowe konta i generuje raporty
DNS Analytics	https://dns-analytics.mcp.cloudflare.com/mcp	Optymalizuje wydajność DNS i debuguje problemy
Digital Experience Monitoring	https://dex.mcp.cloudflare.com/mcp	Wgląd w łączność organizacji i kondycję aplikacji
Cloudflare One CASB	https://casb.mcp.cloudflare.com/mcp	Wykrywa błędne konfiguracje bezpieczeństwa SaaS
GraphQL	https://graphql.mcp.cloudflare.com/mcp	Odpytuje analityczne API GraphQL Cloudflare
Agents SDK Docs	https://agents.cloudflare.com/mcp	Dokumentacja referencyjna do budowania na Agents SDK

Wskazówka

Zacznij od zaledwie dwóch lub trzech serwerów. Dodanie wszystkich 16 przytłacza kontekst AI opisami narzędzi, których nie potrzebuje. W większości projektów Workers wystarczy połączenie Workers Bindings + Workers Builds + Observability + Documentation. Dodawaj kolejne w miarę potrzeb workflow.

Notatka

Nie ma osobnego serwera KV, R2 ani D1. Te prymitywy są dostępne przez jeden serwer Workers Bindings, który widzi każdy zasób powiązany z twoimi Workers. Jeśli trafiłeś tu w poszukiwaniu “Cloudflare KV MCP”, to właśnie Workers Bindings jest tym, czego szukasz.

Konfiguracja: Bindings + Builds + Observability (zalecany punkt wyjścia)

To trio pokrywa większość pracy z Workers: Workers Bindings sięga do twoich zasobów KV, R2, D1, Durable Objects, Queues, Vectorize i Hyperdrive; Workers Builds sprawdza wdrożenia; Observability odpytuje logi i błędy.

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-observability": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://observability.mcp.cloudflare.com/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http cf-bindings https://bindings.mcp.cloudflare.com/mcp
claude mcp add --transport http cf-builds https://builds.mcp.cloudflare.com/mcp
claude mcp add --transport http cf-observability https://observability.mcp.cloudflare.com/mcp

Lub dodaj do .mcp.json w katalogu głównym projektu:

{
  "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-observability": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://observability.mcp.cloudflare.com/mcp"]
    }
  }
}

Codex

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

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

[mcp_servers.cloudflare-observability]
url = "https://observability.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

Dostęp do KV, R2 i D1 odbywa się przez serwer Workers Bindings — nie ma osobnego serwera per-prymityw, który trzeba by dodawać. Kieruj swoje prompty na namespace’y i bazy danych powiązane z twoimi Workers.

Wskazówka

Gotowy prompt do inspekcji danych:

“Using the Workers Bindings server, 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:

“Using the Workers Bindings server, 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_servers.cloudflare-docs]
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.