Cloudflare MCP: Code Mode i serwery domenowe

Cloudflare MCP to zestaw zdalnych serwerów MCP Cloudflare dla agentów AI. Zalecany serwer Code Mode pod adresem https://mcp.cloudflare.com/mcp obejmuje całe API Cloudflare trzema narzędziami (search, execute, docs) i zajmuje około 1100 tokenów kontekstu (według README Cloudflare). Serwery domenowe, takie jak Observability i Workers Bindings, dodają typowane narzędzia dla jednego obszaru. Oba rodzaje uwierzytelniają się przez OAuth albo token API.

Ta strona jest dla programistów i tech leadów, którzy wdrażają na Cloudflare Workers. W piątek wdrażasz Workera, w sobotę rośnie odsetek błędów, a ty przez godzinę przełączasz się między panelem Workers, konsolą D1 i dokumentacją, żeby ustalić, która trasa padła. Z właściwym serwerem Cloudflare agent odpowiada na to jednym promptem i pokazuje zapytanie, które wykonał.

Dopiero zaczynasz z MCP? Zacznij od stron serwery MCP i dobre praktyki MCP, a potem wróć tu po szczegóły dotyczące Cloudflare.

Co dostajesz z tej strony o Cloudflare MCP

Tabelę decyzyjną: Code Mode czy serwery domenowe, oraz aktualną listę adresów serwerów domenowych.
Polecenia instalacji dla Claude Code, Codeksa i Cursora: przez wtyczkę cloudflare albo jako zwykły wpis MCP.
Regułę wyboru między OAuth a tokenem API i sposób na trzymanie tokenu poza plikami konfiguracyjnymi.
Prompt do skopiowania, który układa błędy Workera z ostatniej godziny według tras.
Przepływ pracy migracji D1 (plan, budowa, weryfikacja, wdrożenie, obserwacja) z bramkami, które dowodzą, że zadziałało.
Pułapki, na których wykładają się starsze konfiguracje: /sse zwracające 410 Gone, obcięte wyniki i zły pakiet npm.

Który serwer MCP Cloudflare podłączyć?

Cloudflare publikuje dwa rodzaje serwerów. Serwer Code Mode jest w repozytorium cloudflare/mcp. Serwery domenowe są w cloudflare/mcp-server-cloudflare. Oba README przeczytano 2026-09-26.

Chcesz…	Podłącz	Dlaczego
Sięgać do dowolnego produktu Cloudflare (Workers, KV, R2, D1, DNS, Access i innych) z jednego serwera	Code Mode, `https://mcp.cloudflare.com/mcp`	Trzy narzędzia obejmują całe API, więc koszt kontekstu się nie zmienia
Debugować logi i metryki Workers gotowymi zapytaniami	Observability, `https://observability.mcp.cloudflare.com/mcp`	Typowane narzędzia do zdarzeń, metryk i odkrywania pól
Zarządzać KV, R2, D1 i Hyperdrive nazwanymi narzędziami	Workers Bindings, `https://bindings.mcp.cloudflare.com/mcp`	Jedno narzędzie na akcję, np. `d1_database_query`
Tylko sprawdzać aktualną dokumentację Cloudflare	Documentation, `https://docs.mcp.cloudflare.com/mcp`	Żadnego dostępu do konta

Zacznij od Code Mode. Serwer domenowy dodaj dopiero wtedy, gdy ciągle pytasz agenta o ten sam obszar produktu i chcesz mieć do niego typowane narzędzia.

Serwery domenowe według README mcp-server-cloudflare z 2026-09-26:

Serwer	URL	Do czego
Documentation	`https://docs.mcp.cloudflare.com/mcp`	Aktualna dokumentacja referencyjna
Workers Bindings	`https://bindings.mcp.cloudflare.com/mcp`	Workers, KV, R2, D1 i Hyperdrive
Workers Builds	`https://builds.mcp.cloudflare.com/mcp`	Historia i analiza Workers Builds
Observability	`https://observability.mcp.cloudflare.com/mcp`	Logi i analityka Workers
Container	`https://containers.mcp.cloudflare.com/mcp`	Piaskownica deweloperska
Browser Run	`https://browser.mcp.cloudflare.com/mcp`	Pobieranie stron, konwersja do Markdownu, zrzuty ekranu
Logpush	`https://logs.mcp.cloudflare.com/mcp`	Kondycja zadań Logpush
AI Gateway	`https://ai-gateway.mcp.cloudflare.com/mcp`	Logi, prompty i odpowiedzi w AI Gateway
AutoRAG	`https://autorag.mcp.cloudflare.com/mcp`	Instancje AutoRAG
DNS Analytics	`https://dns-analytics.mcp.cloudflare.com/mcp`	Wydajność i debugowanie DNS
Digital Experience Monitoring	`https://dex.mcp.cloudflare.com/mcp`	Kondycja aplikacji w organizacji
Cloudflare One CASB	`https://casb.mcp.cloudflare.com/mcp`	Błędy konfiguracji bezpieczeństwa aplikacji SaaS
Radar	`https://radar.mcp.cloudflare.com/mcp`	Dane o ruchu w internecie
Cloudflare Blog	`https://blog.mcp.cloudflare.com/mcp`	Wyszukiwanie na blogu

Nie ma osobnego serwera KV, R2 ani D1 (README sprawdzone 2026-09-26). Te zasoby obsługuje Code Mode albo Workers Bindings. README wymienia też minimalny serwer Demo Day, ale to przykład, a nie narzędzie, którego potrzebujesz.

Jak Code Mode mieści całe API Cloudflare w około 1100 tokenach?

Code Mode trzyma specyfikację OpenAPI na serwerze. Zamiast jednego narzędzia na endpoint agent dostaje trzy:

Narzędzie	Co agent z nim robi
`search`	Pisze JavaScript, który przeszukuje `spec.paths` i znajduje właściwe endpointy
`execute`	Pisze JavaScript, który wywołuje `cloudflare.request()` na znalezionych endpointach
`docs`	Przeszukuje dokumentację deweloperską Cloudflare

Według pomiaru Cloudflare w README cloudflare/mcp (przeczytane 2026-09-26) trzy narzędzia Code Mode kosztują około 1100 tokenów. To samo API jako natywne narzędzia MCP tylko z wymaganymi parametrami kosztuje 244 047 tokenów, a z pełnymi schematami 1 170 523. Do agenta trafia tylko wynik kodu, nie specyfikacja.

Dwa parametry URL zmieniają to zachowanie:

Limit wyniku. Każdy wynik narzędzia jest domyślnie przycinany do około 6000 tokenów. Długie listy zachowują pierwsze elementy, długie łańcuchy są ucinane, a każde cięcie jest oznaczone --- TRUNCATED ---. Dodaj ?truncateToolResult=false tylko wtedy, gdy klient sam ogranicza wyniki. Bez limitu szerokie zapytanie potrafi samo zapełnić okno kontekstu.
Wyłączony Code Mode. ?codemode=false rejestruje jedno narzędzie na endpoint (około 2500 narzędzi). Cloudflare zaleca to tylko przy łączeniu serwera z innym systemem Code Mode. Narzędzie docs zostaje w obu trybach.

Szerzej o tej technice, w tym o context-mode i ścieżce CLI + skill, piszemy w tekście jak obniżyć koszt tokenów MCP.

Jak podłączyć Cloudflare MCP do Claude Code, Codeksa i Cursora?

Najprościej przez wtyczkę cloudflare z repozytorium cloudflare/skills. Wtyczka łączy serwer Code Mode z 14 skillami, w tym wrangler i workers-best-practices. Celowo zawiera tylko serwer Code Mode, więc serwery domenowe dodajesz sam.

Zainstaluj wtyczkę w sesji Claude Code:

/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflare

Ta sama wtyczka jest też dostępna jako cloudflare@claude-plugins-official. Instaluj ją tylko z jednego marketplace’u.

Żeby dodać serwery bez wtyczki, uruchom w terminalu:

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

Potem wpisz /mcp w sesji i zaloguj się do każdego serwera w przeglądarce.

Zainstaluj wtyczkę z terminala:

codex plugin marketplace add cloudflare/skills
codex plugin add cloudflare@cloudflare

cloudflare@openai-curated z kuratorowanego marketplace’u OpenAI podłącza ten sam adres Code Mode. Po instalacji zacznij nową sesję Codeksa.

Żeby dodać serwery bez wtyczki:

codex mcp add cloudflare --url https://mcp.cloudflare.com/mcp
codex mcp add cf-observability --url https://observability.mcp.cloudflare.com/mcp
codex mcp login cloudflare
codex mcp login cf-observability

README Cloudflare każe instalować wtyczkę z Cursor Marketplace. Żeby dodać serwery samodzielnie, wpisz to do .cursor/mcp.json:

{
  "mcpServers": {
    "cloudflare": { "url": "https://mcp.cloudflare.com/mcp" },
    "cf-observability": { "url": "https://observability.mcp.cloudflare.com/mcp" }
  }
}

Instrukcje dla Cursora pochodzą z README Cloudflare, a nie z testu: w chwili sprawdzania strony cursor.com był niedostępny.

Pierwsze wywołanie każdego serwera otwiera stronę logowania Cloudflare. Wybierasz tam konto i uprawnienia, które dostanie serwer.

OAuth czy token API?

Sytuacja	Użyj	Dlaczego
Twój laptop, praca interaktywna	OAuth	Uprawnienia wybierasz przy logowaniu i nie dotykasz żadnego sekretu
CI, zadania cykliczne, agenci działający bez interfejsu (headless)	Token API jako bearer token	Nie ma przeglądarki; ogranicz token dokładnie do tego, czego potrzebuje zadanie
Token z włączonym Client IP Address Filtering	Na razie nic nie zadziała	README Cloudflare mówi, że takie tokeny nie są obsługiwane

Tokenowi konta nadaj uprawnienie Account Resources : Read, żeby serwer sam wykrył identyfikator konta. Nie wpisuj tokenu w linii poleceń ani w commitowanych plikach. Czytaj go ze zmiennej środowiskowej o własnej nazwie:

Dodaj to do .mcp.json w katalogu głównym repozytorium (zakres projektu):

{
  "mcpServers": {
    "cloudflare": {
      "type": "http",
      "url": "https://mcp.cloudflare.com/mcp",
      "headers": { "Authorization": "Bearer ${CF_MCP_TOKEN}" }
    }
  }
}

Claude Code rozwija ${VAR} w nagłówkach .mcp.json. Użyj nazwy zmiennej, którą sam kontrolujesz, np. CF_MCP_TOKEN.

codex mcp add cloudflare --url https://mcp.cloudflare.com/mcp --bearer-token-env-var CF_MCP_TOKEN

Przykład: która trasa zwróciła najwięcej błędów Workera w ostatniej godzinie?

Podłącz serwer Observability (albo Code Mode) i wklej ten prompt. Zamień api-worker na nazwę swojego Workera.

Using the Cloudflare observability tools, look at the Worker "api-worker" for the last 60 minutes.
1. Count invocations and errors (outcome is not "ok" or status >= 500), grouped by request path.
2. Show the top 5 paths by error count as a table: path, requests, errors, error rate.
3. For the worst path, list the 3 most frequent error messages with one example request ID each.
4. At the end, print the exact query you ran: dataset, filters, time window, and group-by,
   so I can reproduce it in the dashboard. Do not change any Cloudflare resource.

Z serwerem Observability agent zwykle wywołuje observability_keys, żeby poznać nazwy pól w logach, a potem query_worker_observability, żeby pogrupować zdarzenia. Z Code Mode najpierw uruchamia search, żeby znaleźć endpoint obserwowalności, a potem execute. W obu przypadkach dostajesz krótką tabelę i zapytanie, które da się powtórzyć.

Żeby zaufać odpowiedzi bez przeglądania każdego wywołania narzędzia, sprawdź dwie rzeczy. Suma żądań powinna zgadzać się z panelem Workers dla tej samej godziny. Identyfikatory żądań podane przez agenta powinny otwierać prawdziwe wpisy w logach. Jeśli sumy się nie zgadzają, agent grupował po polu, którego brakuje w części ruchu. Poproś go, żeby najpierw sprawdził to pole przez observability_values i powtórzył zapytanie.

Przepływ pracy: migracja D1 ze skillami Cloudflare i serwerem obserwowalności

Ta pętla używa skilla wrangler z wtyczki cloudflare do zbudowania zmiany, lokalnych bramek do jej weryfikacji i serwera Observability do potwierdzenia stanu produkcji po wdrożeniu. Agent nigdy nie dotyka danych produkcyjnych: kroki zdalne uruchamia człowiek albo CI.

Plan. Opisz zachowanie w dwóch–trzech zdaniach, np. „trzymaj sesje w D1, żeby przetrwały wdrożenie”. Dodaj kryterium akceptacji: test integracyjny, który zapisuje i odczytuje sesję przez Workera.
Budowa. Wklej poniższy prompt budujący. Skill wrangler ładuje się sam, bo prośba pasuje do jego wyzwalaczy (Workers, D1, wdrożenia).
Weryfikacja lokalna. Agent uruchamia npx wrangler d1 migrations apply <DATABASE> --local, twoje testy oraz npx wrangler deploy --dry-run. Wszystkie trzy muszą przejść, zanim człowiek spojrzy na diff. Jeśli testujesz z @cloudflare/vitest-pool-workers, test działa na prawdziwym lokalnym bindingu D1, a nie na atrapie.
Przegląd. Poproś agenta o przegląd migracji i konfiguracji Wranglera ze skillem workers-best-practices. SQL migracji przeczytaj sam. To jedyny plik, którego błędu nie cofniesz ponownym wdrożeniem.
Wdrożenie. Człowiek albo pipeline CI uruchamia npx wrangler d1 migrations apply <DATABASE> --remote, a potem wdraża. Jeśli zespół ma już pipeline, zostaw wdrożenia w CI.
Obserwacja. 30 minut po wdrożeniu wklej poniższy prompt kontrolny. Porównaj odsetek błędów na zmienionych trasach z 30 minutami przed wdrożeniem.
Wycofanie w razie potrzeby. npx wrangler rollback przywraca poprzednią wersję Workera. Nie cofa migracji D1, więc błąd schematu naprawiasz kolejną migracją „w przód”.

<DATABASE> to nazwa bazy albo bindingu z konfiguracji Wranglera.

Add D1-backed session storage to this Worker.
- Create a migration with `npx wrangler d1 migrations create` for a `sessions` table:
  id TEXT PRIMARY KEY, user_id TEXT NOT NULL, expires_at INTEGER NOT NULL, plus an index on user_id.
- Add the D1 binding named SESSIONS_DB to the Wrangler config. Use the existing database if one
  is configured; otherwise stop and ask me before creating anything in my Cloudflare account.
- Write the session read/write code and an integration test that writes, reads, and expires a session.
- Apply the migration with --local only, run the tests, and run `npx wrangler deploy --dry-run`.
- Do NOT run any --remote command and do NOT deploy. Report each command with its exit code.

Using the Cloudflare observability tools, compare the Worker "api-worker" in two windows:
the 30 minutes before <DEPLOY_TIME> and the 30 minutes after it.
For each route that touches sessions, show requests, error count, error rate, and p95 wall time
in both windows. Flag any route whose error rate rose by more than 1 percentage point
and show its top error message. Print the queries you ran. Read-only: change nothing.

<DEPLOY_TIME> to znacznik czasu wdrożenia z logu CI albo z npx wrangler deployments list.

Akceptacja to nie przegląd linijka po linijce, tylko łańcuch dowodów: migracja przeszła lokalnie, testy przeszły, dry run się zbudował, człowiek przeczytał SQL, a porównanie produkcji nie pokazało wzrostu. Decyzję o wdrożeniu podejmuje programista, który scala zmianę. Tech lead ustala próg (tu 1 punkt procentowy), po którego przekroczeniu zespół wycofuje wersję.

Ile kontekstu kosztuje Cloudflare MCP?

Zmierz to we własnej sesji zamiast ufać opublikowanym liczbom:

W Claude Code uruchom /context przed i po podłączeniu serwera i porównaj wiersz z narzędziami MCP.
Uruchom claude plugin details cloudflare@cloudflare, żeby zobaczyć komponenty wtyczki i szacowany koszt w tokenach.
W Codeksie uruchom codex mcp list i codex mcp remove <NAME> dla każdego serwera, którego ten projekt nie potrzebuje.

Serwer Code Mode pozostaje mały niezależnie od tego, jak rośnie API. Każdy serwer domenowy dokłada własne schematy narzędzi, a serwer Observability potrafi łączyć wiele wywołań z dużymi wynikami. Serwery domenowe podłączaj osobno dla każdego projektu, a nie globalnie.

Jak popularny jest Cloudflare MCP?

Stan na 2026-09-26 (GitHub API i pliki marketplace’ów): cloudflare/mcp ma 883 gwiazdki, cloudflare/mcp-server-cloudflare około 4,3 tys., a cloudflare/skills około 2,9 tys. Serwer Code Mode jest w Official MCP Registry jako com.cloudflare.mcp/mcp. Wtyczka jest zarówno w claude-plugins-official, jak i w openai-curated. skills.sh podaje dla cloudflare/skills około 825,6 tys. instalacji (źródło wtórne: fragment wyników wyszukiwania widziany 2026-09-26, strona nieczytana bezpośrednio).

@cloudflare/mcp-server-cloudflare w npm (0.2.0) to stary serwer lokalny. Używaj zdalnych adresów z tej strony. Starsze poradniki opakowują też adresy w npx mcp-remote; klienci z natywną obsługą HTTP tego nie potrzebują.
/sse to alias, a nie SSE. Na serwerach domenowych /sse mówi Streamable HTTP. Stare żądanie SSE GET /sse dostaje 410 Gone. Zmień adres na /mcp.
claude mcp add bez --transport http zapisuje serwer stdio, którego poleceniem jest URL, i połączenie się nie udaje. --url to flaga Codeksa; claude mcp add --url zostaje odrzucone (Claude Code 2.1.285, codex-cli 0.157.1).
Serwery, które nie istnieją. Serwery GraphQL, Audit Logs i Agents SDK Docs pojawiają się w starszych artykułach, ale nie ma ich w aktualnym README (2026-09-26).
Wtyczka plus ręczny wpis. Instalacja wtyczki i ręczne dodanie mcp.cloudflare.com daje dwie kopie tych samych narzędzi.

Co psuje się przy pracy z Cloudflare MCP?

Logowanie wisi albo nie wraca. VPN, proxy albo rozszerzenie przeglądarki blokuje przekierowanie OAuth na twój komputer. Spróbuj w czystym profilu przeglądarki. W Claude Code claude mcp add --callback-port <PORT> ustala port przekierowania, gdy sieć przepuszcza tylko wybrane porty.

Agent widzi złe Workery albo nie widzi żadnych zasobów. Serwer jest zalogowany do innego konta albo wybrane uprawnienia są za wąskie. Wyloguj się z serwera (/mcp w Claude Code, codex mcp logout <NAME> w Codeksie), zaloguj ponownie i wybierz właściwe konto oraz zakresy.

Wyniki kończą się --- TRUNCATED ---. Limit 6000 tokenów przyciął szerokie zapytanie. Poproś o węższe okno czasowe, filtr albo agregat zamiast surowych zdarzeń. Limit wyłączaj tylko wtedy, gdy klient sam ogranicza wyniki.

„Claude’s response was interrupted”. README Cloudflare wyjaśnia, że zwykle oznacza to wyczerpanie kontekstu, najczęściej na serwerze Observability przy wielu łańcuchowych wywołaniach. Podziel pytanie na mniejsze zapytania i zacznij od agregatów.

410 Gone przy połączeniu. Klient wciąż używa starego transportu SSE na /sse. Zmień adres na /mcp albo ustaw w kliencie transport HTTP.

401 lub 403 z tokenem. Tokenowi brakuje uprawnienia, ma włączone Client IP Address Filtering albo jest tokenem konta bez Account Resources : Read. Utwórz nowy token z zakresami, których potrzebuje zadanie.

Narzędzie nie działa dla funkcji, za którą nie płacisz. Niektóre funkcje wymagają płatnego planu Workers. Ten błąd zwraca API Cloudflare, a nie serwer MCP.

Agent próbuje zmieniać produkcję. execute w Code Mode może wywołać każdy endpoint, na który pozwalają uprawnienia. W Claude Code dodaj to narzędzie do listy ask w .claude/settings.json. Jego nazwa zależy od sposobu podłączenia serwera (sprawdzone w Claude Code 2.1.285): mcp__cloudflare__execute dla serwera dodanego ręcznie pod nazwą cloudflare i mcp__plugin_cloudflare_cloudflare__execute dla wtyczki cloudflare. W razie wątpliwości uruchom /mcp i skopiuj dokładną nazwę narzędzia, którą pokazuje. W każdym narzędziu do diagnozy używaj zakresów tylko do odczytu. Pełny zestaw zabezpieczeń opisuje strona bezpieczeństwo MCP.

Błędy połączenia po stronie klienta, niezwiązane z Cloudflare, omawia strona problemy z połączeniem MCP.

Co dalej po Cloudflare MCP

Niższy koszt tokenów MCP Code Mode, context-mode i ścieżka CLI + skill porównane, z metodą pomiaru.

Serwery MCP do obserwowalności Sentry, Datadog, Grafana i inne serwery do debugowania produkcji.

Skille backendowe i platformowe Skille Cloudflare, Supabase, Neon, AWS i innych dostawców według stosu.

Serwery MCP platform chmurowych Odpowiedniki Cloudflare MCP dla AWS, Azure i Google Cloud.

Bezpieczeństwo MCP Zakresy, zatwierdzenia i tokeny dla zdalnych serwerów MCP.

Przegląd serwerów MCP Wszystkie przewodniki po serwerach MCP w tym serwisie, pogrupowane według zadań.