INTEGRITY Dokumentace

← Nastavení agentů / agent-setup

Visual Studio Code + Cloudflare

Všichni agenti
Microsoft

Bezplatný open source editor kódu s nativní podporou klienta Model Context Protocol (MCP) a integrací Copilot Chat. Vytvořeno společností Microsoft.

IDETerminálSamostatnýRozšířeníOpen source
Cloudflare SkillsCloudflare Code Mode API MCPServery Cloudflare MCP pro konkrétní doményDokumentace Visual Studio Code

Rychlý start

  1. Nainstalujte Visual Studio Code a GitHub Copilot

    Nainstalujte Visual Studio Code ↗ a ujistěte se, že je zcela aktuální. Poté nainstalujte rozšíření GitHub Copilot ↗ a přihlaste se pomocí účtu GitHub. K vyzkoušení stačí bezplatná úroveň Copilot.

  2. Nakonfigurujte MCP server Cloudflare

    Vytvořit .vscode/mcp.json uvnitř složky vašeho pracovního prostoru:

    {
  "servers": {
    "cloudflare-api": {
      "type": "http",
      "url": "https://mcp.cloudflare.com/mcp"
    }
  }
}

    Visual Studio Code používá servers jako kořenový klíč. Konfigurace zkopírované z Cursor nebo Claude Desktop používají mcpServers a zde tiše neudělá nic. Pro MCP servery specifické pro daný produkt se podívejte na mcp-server-cloudflare ↗. Informace o kompletním serveru Cloudflare API MCP (Code Mode) najdete v cloudflare/mcp ↗.

  3. Spusťte server a autorizujte se

    Po uložení mcp.json, Visual Studio Code zobrazí Spustit CodeLens na cloudflare-api definici serveru. Klikněte na ni a dokončete proces OAuth, kterým autorizujete Cloudflare MCP server ve svém účtu. Začněte s demo účtem, dokud si nebudete jisti rozsahem oprávnění, která udělujete.

  4. Vyzkoušejte prompt

    Otevřete Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I), přepněte do režimu agenta a vyzkoušejte prompt, například:

    Build an AI chat agent using the Cloudflare Agents SDK with persistent conversation history stored in D1.

Podrobný postup krok za krokem se snímky obrazovky, včetně stránky autorizace OAuth, ověření, že server běží, a vytváření a mazání záznamů DNS pomocí přirozeného jazyka, najdete v podrobný návod.

Přístup k platformě Cloudflare

Rozbalením libovolné sekce se dozvíte více.

Cloudflare Skills

Trvalý kontext platformy, který agenta naučí, jak Cloudflare funguje.

Skills jsou instrukce, které agent načítá na vyžádání. cloudflare/skills balíček pokrývá každou vrstvu platformy, takže agent zná vaše konvence, aniž byste mu je museli znovu vysvětlovat.

  • agents-sdkVytvářejte AI agenty na Cloudflare Workers pomocí Agents SDK. Načtěte při vytváření stavových agentů, trvalých workflow, aplikací s WebSocket v reálném čase, naplánovaných úloh, serverů MCP, chatovacích aplikací, hlasových agentů nebo automatizace prohlížeče. Zahrnuje třídu Agent, správu stavu, volatelné RPC, Workflows, trvalé provádění, fronty, opakování, observabilitu a React hooks. Upřednostňuje čerpání z dokumentace Cloudflare před předtrénovanými znalostmi.
  • cloudflareKomplexní dovednost pro platformu Cloudflare zahrnující Workers, Pages, úložiště (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), síťové služby (Tunnel, Spectrum), zabezpečení (WAF, DDoS) a infrastructure as code (Terraform, Pulumi). Použijte ji pro jakýkoli vývojářský úkol týkající se Cloudflare. Upřednostňuje čerpání informací z dokumentace Cloudflare před předtrénovanými znalostmi.
  • cloudflare-email-serviceOdesílejte a přijímejte transakční e-maily pomocí Cloudflare Email Service (Email Sending + Email Routing). Použijte při vytváření odesílání e-mailů (binding Workers nebo REST API), směrování e-mailů, zpracování e-mailů v Agents SDK nebo integraci e-mailu do libovolné aplikace: Workers, Node.js, Python, Go a dalších. Dále použijte pro doručitelnost e-mailů, SPF/DKIM/DMARC, nastavení e-mailu ve wrangler, nástroje MCP pro e-mail nebo když má kódovací agent odesílat e-maily. I pro jednoduché požadavky jako "přidej e-mail do mého Workeru" obsahuje tento skill důležité podrobnosti o konfiguraci.
  • cloudflare-one"Slouží jako průvodce prací s Cloudflare One Zero Trust a SASE napříč Access, Gateway, WARP, Tunnel, Cloudflare WAN, DLP, CASB, device posture a identitou. Použijte při návrhu, konfiguraci, řešení problémů nebo kontrole nasazení Cloudflare One. Přednostně načítá data: používá aktuální dokumentaci a API schémata Cloudflare místo vestavěné dokumentace k produktům."
  • cloudflare-one-migrationsPlánuje migrace ze Zscaler ZIA/ZPA, Palo Alto, starších VPN, SWG nebo SASE řešení na Cloudflare One. Použijte pro posouzení migrace, mapování zásad, plány nasazení a analýzu parity a mezer.
  • durable-objectsVytváří a kontroluje Cloudflare Durable Objects. Použijte při budování stavové koordinace (chatovací místnosti, hry pro více hráčů, rezervační systémy), implementaci metod RPC, ukládání do SQLite, alarmů, WebSockets nebo při kontrole kódu DO z hlediska osvědčených postupů. Zahrnuje integraci s Workers, konfiguraci wrangler a testování pomocí Vitest. Upřednostňuje čerpání informací z dokumentace Cloudflare před předtrénovanými znalostmi.
  • sandbox-migrate-to-nextPoužijte při přechodu aplikace Cloudflare Sandbox ze stabilního @cloudflare/sandbox na @cloudflare/sandbox@next (náhled Sandbox SDK 1.0), nebo když uživatel žádá o migraci či upgrade na Sandbox 1.0 / @next. Nepoužívejte pro běžnou práci se stable verzí (sandbox-stable) ani pro nové aplikace @next (sandbox-next).
  • sandbox-nextPoužijte při vytváření nebo úpravě aplikací Cloudflare Sandbox na @cloudflare/sandbox@next (náhled Sandbox SDK 1.0): spouštění kódu, AI runnery, interpretery, úlohy podobné CI, terminály, soubory, připojení (mounts), tunely, náhledové URL, životní cyklus nebo chyby. Nepoužívejte pro výchozí stabilní balíček (použijte sandbox-stable) ani pro přechod ze stable na @next (použijte sandbox-migrate-to-next).
  • sandbox-stablePoužijte při vytváření nebo úpravě aplikací Cloudflare Sandbox na aktuálním stabilním balíčku @cloudflare/sandbox (výchozí npm tag): příkazy, relace, soubory, porty, tunely, terminály, bridge, produkce nebo čištění zastaralého API při zachování stable verze. Nepoužívejte pro @cloudflare/sandbox@next (použijte sandbox-next) ani pro přechod na verzi 1.0 (použijte sandbox-migrate-to-next).
  • turnstile-spinNastavte Cloudflare Turnstile v projektu od začátku do konce. Projděte kódovou základnu, vytvořte widget přes Cloudflare API, vložte ho tam, kde požadavky uživatelů potřebují ověření proti botům (odesílání formulářů, akce v SPA, API endpointy, odkazy ke stažení, přidávání komentářů nebo hlasování atd.), propojte kanonické server-side siteverify se stávajícím backendem zákazníka, ověřte a uložte skill. Načtěte, když uživatel požádá o přidání Turnstile, nastavení CAPTCHA, ochranu formuláře nebo endpointu proti botům, nebo o opravu integrace Turnstile. Odpovídá developers.cloudflare.com/turnstile/spin.
  • web-perfAnalyzuje výkon webu pomocí Chrome DevTools MCP. Měří Core Web Vitals (LCP, INP, CLS) a doplňkové metriky (FCP, TBT, Speed Index), identifikuje zdroje blokující vykreslování, řetězce síťových závislostí, posuny rozložení a problémy s ukládáním do mezipaměti a přístupností. Použijte, pokud máte auditovat, profilovat, ladit nebo optimalizovat výkon načítání stránky, skóre Lighthouse nebo rychlost webu. Upřednostňuje čerpání z aktuální dokumentace před předtrénovanými znalostmi.
  • workers-best-practicesKontroluje a píše kód Cloudflare Workers podle osvědčených postupů pro produkční nasazení. Načtěte při psaní nových Workers, kontrole kódu Workeru, konfiguraci wrangler.jsonc nebo při hledání běžných antipatternů Workers (streaming, nezachycené promises, globální stav, secrets, bindings, observabilita). Upřednostňuje vyhledávání v dokumentaci Cloudflare před předtrénovanými znalostmi.
  • wranglerNástroj Cloudflare Workers CLI pro nasazování, vývoj a správu Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines a Secrets Store. Načtěte před spuštěním příkazů wrangler, abyste zajistili správnou syntaxi a osvědčené postupy. Upřednostňuje čerpání z dokumentace Cloudflare před předtrénovanými znalostmi.
MCP servery

Přímý přístup k Cloudflare API, dokumentaci a observabilitě.

Servery MCP poskytují typované nástroje pro volání Cloudflare za běhu. Na výběr máte ze dvou možností: Code Mode tedy jediný server, který pokrývá celé Cloudflare API (2,500+ endpointů v ~1,000 tokenech), nebo sadu zaměřených serverů pro konkrétní produkty, hostovaných v cloudflare/mcp-server-cloudflare repozitáři. Úplný katalog najdete také v Servery MCP pro Cloudflare dokumentaci.

  • Code mode APIcode modeŠiroký přístup k celému Cloudflare API prostřednictvím spouštění kódu, s minimální režií na tokenyhttps://mcp.cloudflare.com/mcp
  • server AI GatewayProhledávejte své logy, získávejte podrobnosti o promptech a odpovědíchhttps://ai-gateway.mcp.cloudflare.com/mcp
  • Server Audit LogsDotazování na protokoly auditu a generování reportů pro kontroluhttps://auditlogs.mcp.cloudflare.com/mcp
  • Server AutoRAGVyhledávejte a dotazujte se na instance AutoRAG účtuhttps://autorag.mcp.cloudflare.com/mcp
  • Server Browser RunNačítá webové stránky, převádí je do markdownu a pořizuje snímky obrazovkyhttps://browser.mcp.cloudflare.com/mcp
  • Server Cloudflare BlogVyhledávejte a čtěte příspěvky z Cloudflare Bloguhttps://blog.mcp.cloudflare.com/mcp
  • Cloudflare One CASB serverRychle odhalte bezpečnostní nedostatky v konfiguraci aplikací SaaS a chraňte tak uživatele i datahttps://casb.mcp.cloudflare.com/mcp
  • Kontejnerový serverVytvořte vývojové prostředí typu sandboxhttps://containers.mcp.cloudflare.com/mcp
  • server Demo DayUkázka minimálního MCP serveru Cloudflarehttps://demo-day.mcp.cloudflare.com/mcp
  • Server Digital Experience MonitoringZískat rychlý přehled o kritických aplikacích ve vaší organizacihttps://dex.mcp.cloudflare.com/mcp
  • Server DNS AnalyticsOptimalizace výkonu DNS a ladění problémů na základě aktuálního nastaveníhttps://dns-analytics.mcp.cloudflare.com/mcp
  • Dokumentační serverZískejte aktuální referenční informace o Cloudflarehttps://docs.mcp.cloudflare.com/mcp
  • Server LogpushZískat rychlé souhrny stavu úloh Logpushhttps://logs.mcp.cloudflare.com/mcp
  • Server pro observabilituLadění a přehled o protokolech a analytice vaší aplikacehttps://observability.mcp.cloudflare.com/mcp
  • Server RadarProzkoumejte přehledy o internetu Cloudflare Radarhttps://radar.mcp.cloudflare.com/mcp
  • Server Workers BindingsVytvářejte aplikace Workers s úložištěm, AI a výpočetními primitivyhttps://bindings.mcp.cloudflare.com/mcp
  • Server Workers BuildsZískat přehledy a spravovat Cloudflare Workers Buildshttps://builds.mcp.cloudflare.com/mcp
Wrangler CLI

Lokální vývoj, nasazení a příkazy specifické pro Workers.

Použijte Wrangler pro místní vývoj, nasazení a příkazy specifické pro daný produkt, například wrangler d1 migrations apply nebo wrangler tail. Součástí je wrangler Skill učí agenta, kdy po něm sáhnout.

Dokumentace vhodná pro agenty

Reference optimalizované pro agenty s úsporným využitím tokenů.

Připojte /index.md k libovolné URL adrese Cloudflare docs a získáte čistou verzi v markdownu. Každá sekce nejvyšší úrovně produktu má také vlastní llms.txt tedy index stránek přizpůsobený velikosti jednoho kontextového okna. Několik užitečných příkladů:

Úplný přehled o tom, jak je tato dokumentace strukturovaná pro agenty, najdete v průvodce Docs for Agents.

Příklad promptů

Build a serverless AI inference endpoint on Workers AI with streaming responses.
Use Workers for Platforms to let my customers deploy their own code in isolated environments.
Configure caching rules and cache TTLs to reduce origin load for my e-commerce store.
Optimize my Worker to serve WebP images with responsive resizing using Cloudflare Images.
Set up a Waiting Room to handle flash sale traffic spikes without dropping requests.

Tipy

Časté dotazy

Proč server MCP zobrazuje jen tři nástroje?

Specifikace Cloudflare API má zhruba dva miliony tokenů, což je na přímé předání agentovi příliš mnoho. Server Cloudflare MCP proto používá vzor spouštění kódu: agent dostane nástroj pro prohledávání API specifikace a nástroj pro provádění volání, zatímco specifikace zůstává na straně serveru. Tři nástroje jsou tedy správný a zdravý stav.

Funguje to pouze s Visual Studio Code?

Ne. Stejná adresa URL serveru (https://mcp.cloudflare.com/mcp) funguje v Claude Code, Cursoru, Claude Desktopu nebo v jakémkoli klientovi podporujícím MCP. Visual Studio Code je jen jednou z mnoha možností.

Mohu místo OAuth použít token Cloudflare API?

Ano. Token Cloudflare API můžete předat jako přihlašovací údaj typu bearer, což dává smysl pro CI/CD nebo sdílenou automatizaci. Pro interaktivní použití v editoru je doporučenou cestou OAuth. API tokeny využívající Client IP Address Filtering nejsou podporovány.

Potřebuji GitHub Copilot k používání MCP ve Visual Studio Code?

Copilot Chat je MCP klient používaný v tomto průvodci, takže ano: potřebujete Copilot (nebo jiné rozšíření podporující MCP), abyste mohli server skutečně ovládat. Visual Studio Code samotné poskytuje konfiguraci a životní cyklus MCP, ale chatovací rozhraní pochází z Copilotu.

Řešení potíží

Chat hlásí chybu 'Cannot read properties of undefined'

Sestavení Visual Studio Code a rozšíření Copilot nejsou synchronizovaná. Aktualizujte Visual Studio Code pomocí modrého tlačítka v záhlaví okna, nechte ho restartovat a zkuste to znovu.

Zápisy selžou s chybou API 10000, ale čtení funguje

Udělení OAuth je jen pro čtení, přestože jste chtěli udělit plný přístup. Toto se může stát, pokud autorizujete více než jednou: další průchody mohou tiše proběhnout s omezeným rozsahem. Zrušte aplikaci v My Profile → Access Management → Connected Applications v dashboardu Cloudflare se odhlaste z relace MCP ve Visual Studio Code (ikona účtu ve spodní části postranního panelu Activity Bar) a poté server spusťte znovu.

V mcp.json se nezobrazuje tlačítko Start

Zkontrolujte kořenový klíč v JSON. Visual Studio Code vyžaduje servers, nikoli mcpServers. Zároveň ověřte, že je soubor umístěn na .vscode/mcp.json uvnitř otevřené složky, nikoli v jejím kořeni.

Agent navrhuje vytvoření API tokenu jako obejití chyby

Odmítněte to. Pokud je autentizace nefunkční, řešením je nové udělení OAuth, ne vložení bearer tokenu do chatovacího okna. Postupujte podle kroků řešení potíží pro chybu API 10000 a proveďte čisté nové udělení.

Chyby 401 v protokolech Visual Studio Code

Očekávané chování, dokud nevyberete Allow in this Session ve výzvě k autorizaci v Copilot Chat.

Vytváření agentů na Cloudflare

Cloudflare není jen cíl pro nasazení agentů, je to kompletní stack pro vytváření vlastních.

Agents SDK

Stavoví AI agenti se stavem, plánováním, RPC, e-maily a streamovaným chatem, a Code Mode SDK pro tokenově efektivní používání nástrojů.

Zjistit více
Vytvoření serveru MCP

Nasaďte vzdálený server MCP na Workers s OAuth, trvalým stavem (durable state) a streamovatelným HTTP transportem.

Zjistit více
Workers AI

Spouštějte open source LLM, embedding modely a obrazové modely na edge síti. Použijte je jako poskytovatele modelu pro svého agenta.

Zjistit více
Worker Loader

Načítejte uživatelský kód na vyžádání do izolovaných Workers. Zabezpečený sandbox, na kterém Code Mode stojí.

Zjistit více

Další agenti

Anthropic

Claude Code

Kódovací agent pro terminál, který rozumí vaší kódové základně, spouští příkazy, upravuje soubory a spravuje git. Vytvořila společnost Anthropic.

Zobrazit návod
OpenAI

Codex

Kódovací agent OpenAI dostupný jako terminálové CLI i desktopová aplikace. Čte a zapisuje soubory, spouští příkazy a prochází web v sandboxu.

Zobrazit návod
Cursor

Cursor

IDE postavené primárně na AI, založené na VS Code, s úpravami více souborů přes Composer a agenty běžícími na pozadí. Vytváří ho společnost Cursor.

Zobrazit návod
GitHub

GitHub Copilot

Rozšíření editoru a CLI s režimem agenta, kontextem pracovního prostoru a nativní integrací PR. Vytvořeno společností GitHub.

Zobrazit návod
Anomálie

OpenCode

Open source terminálový agent s bohatým textovým rozhraním (TUI), který funguje s 75+ LLM. Vytvořila společnost Anomaly.

Zobrazit návod
Cognition

Windsurf

Agentní IDE s kontextem Cascade a Flows pro vícekrokové úlohy. Vytváří ho společnost Cognition.

Zobrazit návod
LM Studio

Bionic

Výkonný agent pro programování a práci. Nativně lokální, s otevřenými modely v cloudu. Od LM Studio.

Zobrazit návod