← Nastavení agentů / agent-setup
OpenCode + Cloudflare
Open source terminálový agent s bohatým textovým rozhraním (TUI), který funguje s 75+ LLM. Vytvořila společnost Anomaly.
Rychlý start
-
Nainstalujte OpenCode
Nainstalujte OpenCode. Možnosti instalace pro npm, Homebrew, Bun, Scoop nebo Windows najdete v Instalační příručka OpenCode ↗.
curl -fsSL https://opencode.ai/install | bash -
Nainstalujte Cloudflare Skills
npx skills add https://github.com/cloudflare/skills -
Přidání serverů Cloudflare MCP
Přidání serverů MCP do
.opencode.jsonc. Servery MCP pro konkrétní domény najdete v mcp-server-cloudflare ↗. Informace o kompletním serveru Cloudflare API MCP (Code Mode) najdete v cloudflare/mcp ↗.{ "mcp": { "cloudflare": { "type": "remote", "url": "https://mcp.cloudflare.com/mcp", "enabled": true }, "cloudflare-docs": { "type": "remote", "url": "https://docs.mcp.cloudflare.com/mcp", "enabled": true }, "cloudflare-bindings": { "type": "remote", "url": "https://bindings.mcp.cloudflare.com/mcp", "enabled": true }, "cloudflare-builds": { "type": "remote", "url": "https://builds.mcp.cloudflare.com/mcp", "enabled": true }, "cloudflare-observability": { "type": "remote", "url": "https://observability.mcp.cloudflare.com/mcp", "enabled": true } } } -
Spusťte OpenCode
Spusťte OpenCode z kořenového adresáře projektu, kde
wrangler.jsoncse nachází (pokud již existuje).opencode -
Vyzkoušejte prompt
Například:
Optimize my Worker to serve WebP images with responsive resizing using Cloudflare Images.
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ů:
- developers.cloudflare.com/llms.txt tedy katalog všech produktů Cloudflare.
- developers.cloudflare.com/workers/llms.txt
- developers.cloudflare.com/agents/llms.txt
- developers.cloudflare.com/r2/llms.txt
- developers.cloudflare.com/d1/llms.txt
Úplný přehled o tom, jak je tato dokumentace strukturovaná pro agenty, najdete v průvodce Docs for Agents.
Příklad promptů
Build a multi-tenant SaaS backend where each customer gets an isolated D1 database.Configure caching rules and cache TTLs to reduce origin load for my e-commerce store.Create a RAG pipeline using Vectorize and Workers AI to answer questions over my documentation.Set up GitHub Actions to deploy this Worker to staging and production on Cloudflare.Add a cron trigger to my Worker that processes a job queue every hour.Tipy
- Server Cloudflare API MCP používá Code Mode: OpenCode píše JavaScript, aby se dostal ke kterémukoli z 2,500+ koncových bodů za ~1,000 tokenů.
- OpenCode podporuje 75+ LLM. Jako poskytovatele modelu můžete použít Cloudflare Workers AI a mít tak workflow plně postavený na Cloudflare.
- Plánovacího agenta v OpenCode (klávesa Tab) použijte k rozdělení složitých projektů Workers ještě před psaním kódu: zkombinujte ho s
/cloudflare:build-agentnebo/cloudflare:build-mcppříkazy slash.
Časté dotazy
Mám použít Skills, server MCP, Wrangler CLI, nebo všechno dohromady?
Všechny tři. Skills poskytují trvalé odborné znalosti o Cloudflare, díky nimž OpenCode ví,
kdy sáhnout po Durable Objects a kdy po KV, jak strukturovat projekt Workers
a kdy volat CLI a kdy API. Server Cloudflare API MCP zajišťuje operace na platformě
(DNS, WAF, Zero Trust, R2 buckets). Wrangler se stará o lokální vývoj,
nasazení a příkazy specifické pro Workers. Součástí je wrangler Skill učí
OpenCode, který z nich použít.
Jak připojím OpenCode ke Cloudflare?
Při prvním volání nástroje Cloudflare vás OpenCode přesměruje k autorizaci přes OAuth, kde zvolíte oprávnění.
Mohu v OpenCode použít jako poskytovatele modelu Workers AI?
Ano. OpenCode podporuje 75+ poskytovatelů modelů, včetně Cloudflare Workers AI. Model nastavíte v .opencode.jsonc.
Je OpenCode open source?
Ano. OpenCode je zcela open source a je dostupný na github.com/anomalyco/opencode.
Řešení potíží
Připojení k serveru MCP selhává
Ověřte konfiguraci MCP v .opencode.jsonc používá "type": "remote"
se správnou URL adresou. Spusťte opencode mcp list a zkontrolujte připojené servery.
Zastaralé informace o produktech Cloudflare
Povolte Server Cloudflare docs MCP aby agent mohl za běhu načítat
aktuální dokumentaci. Pokud nechcete používat MCP server, nasměrujte
agenta přímo na developers.cloudflare.com/llms.txt pro
katalog všech produktů, nebo developers.cloudflare.com/<product>/llms.txt
pro index specifický pro daný produkt.
Vytváření agentů na Cloudflare
Cloudflare není jen cíl pro nasazení agentů, je to kompletní stack pro vytváření vlastních.
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íceNasaďte vzdálený server MCP na Workers s OAuth, trvalým stavem (durable state) a streamovatelným HTTP transportem.
Zjistit víceSpouš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íceNačítejte uživatelský kód na vyžádání do izolovaných Workers. Zabezpečený sandbox, na kterém Code Mode stojí.
Zjistit víceDalší agenti
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ávodCodex
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ávodCursor
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ávodGitHub 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ávodWindsurf
Agentní IDE s kontextem Cascade a Flows pro vícekrokové úlohy. Vytváří ho společnost Cognition.
Zobrazit návodVisual Studio Code
Bezplatný open source editor kódu s nativní podporou klienta Model Context Protocol (MCP) a integrací Copilot Chat. Vytvořeno společností Microsoft.
Zobrazit návodBionic
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