← Nastavení agentů / agent-setup / visual-studio-code
Podrobný návod k Visual Studio Code
Tento návod propojí Visual Studio Code přímo s Cloudflare API pomocí Server Cloudflare MCP ↗. Nakonec dokážete vytvořit záznam DNS pouhým napsáním věty, aniž byste opustili editor.
Server Cloudflare MCP na mcp.cloudflare.com zpřístupňuje Cloudflare API každému agentovi, který podporuje MCP. Agent Copilot ve Visual Studio Code se k němu připojí a volání API pak spouštíte přirozeným jazykem.
Zkrácenou verzi najdete v Rychlý start s Visual Studio Code.
Než začnete
- Visual Studio Code, plně aktuální. Nesoulad verzí mezi editorem a rozšířením Copilot je nejčastější příčinou chyb v režimu agenta.
- GitHub Copilot. Funguje jakýkoli účet GitHub a bezplatná úroveň stačí.
- Účet Cloudflare, u kterého vám nevadí na něj nasměrovat agenta. Použijte demo účet, důvod bude zřejmý v kroku autorizace.
Připojte Visual Studio Code k rozhraní Cloudflare API
-
Ověřte verzi Visual Studio Code
Otevřete Visual Studio Code a vyberte Help > O službě. Ověřte, že používáte aktuální verzi (build). Pokud se zobrazí Aktualizovat se v horní liště zobrazí tlačítko, klikněte na něj a před pokračováním nechte Visual Studio Code restartovat.
-
Přihlaste se do Copilot
Vyberte ikonu Copilot ve Status Bar a poté vyberte Použít AI funkce, poté se přihlaste pomocí účtu GitHub. Visual Studio Code otevře prohlížeč k autorizaci.
-
Ověření v Copilotu
Podle pokynů na stránkách v prohlížeči se ověřte u GitHubu.
-
Vytvořte složku a otevřete ji
Vytvořte pro tento projekt prázdnou složku a poté ji otevřete ve Visual Studio Code pomocí Soubor > Open Folder. Například
~/cloudflare-api-mcp/.
-
Vytvořte konfigurační soubor
Uvnitř složky vytvořte jeden soubor:
.vscode/mcp.json. Typování.vscode/mcp.jsonv Exploreru vytvoří složku a soubor zároveň.
Vložte následující do souboru a uložte ho:
{ "servers": { "cloudflare-api": { "type": "http", "url": "https://mcp.cloudflare.com/mcp" } } } -
Spusťte server
Po uložení souboru se Spustit se odkaz zobrazí na
cloudflare-apidefinici serveru. Vypadá to jako komentář, ve skutečnosti je to ale tlačítko (jde o CodeLens ↗). Vyberte ji a poté potvrďte výzvu k ověření. V prohlížeči se otevře autorizační stránka Cloudflare.
-
Výběr šablony přístupu
Na stránce autorizace určujete, k čemu bude mít agent přístup. V tomto příkladu je vybráno Plný přístup k úpravě záznamů DNS. Můžete také začít s Pouze čtení nebo vytvořte Custom sadu oprávnění. Omezte udělení na jeden účet a poté zkontrolujte, co přesně udělujete.
Než provedete autorizaci, měli byste vědět dvě věci. Plný přístup umožňuje agentovi vytvářet a mazat skutečné prostředky, a proto patří na demo účet. Udělené oprávnění můžete kdykoli zrušit v dashboardu v sekci My Profile > Access Management > Připojené aplikace, což je zároveň stránka, kterou navštivte, pokud se opakovaná autorizace chová neočekávaně.
-
Ověřte oprávnění a autorizujte se
Zkontrolujte seznam oprávnění a poté vyberte Autorizovat aby Cloudflare API mohlo pracovat s vaším účtem.
-
Otevřete Copilot Chat
Pokud je Copilot minimalizovaný, otevřete jej pomocí Zobrazit > Chat.
-
Ověřte, že server běží
Server se nyní zobrazuje jako spuštěný. CodeLens zobrazuje Running | 3 tools. Tři nástroje jsou v pořádku, nejde o vadnou instalaci: server používá princip vyhledej a spusť místo registrace tisíců jednotlivých koncových bodů.
-
Vypište své zóny
V Copilot Chat nastavte režim na Agent, a poté ho požádejte, aby vypsal vaše zóny. Agent si před spuštěním volání vyžádá váš souhlas a vrátí aktuální seznam všech domén v účtu.
List zones in my accountRan Cloudflare API Code Executor - Zones returned: 1 - Zone: cloudflaredemo.net — id: <ZONE_ID> — status: active -
Vytvořte záznam DNS
Požádejte agenta, aby vytvořil záznam DNS AAAA a zapnul proxy Cloudflare. Tento příklad směřuje
test.cloudflaredemo.netna100::, rezervovanou zástupnou adresu z rozsahu IPv6 discard prefix0100::/64(RFC 6666 ↗). Protože záznam prochází přes proxy, Cloudflare zachytí požadavky dříve, než dorazí na tuto adresu. Schvalte volání nástroje (Always Allow), a agent nahlásí, že záznam byl vytvořen.
Create a AAAA record for test.cloudflaredemo.net pointing to 100:: and enable the proxy.Ran Cloudflare API Code Executor - Record created: test.cloudflaredemo.net - Type: AAAA - Value: 100:: - Proxied: true - Record ID: <RECORD_ID>Nespoléhejte pouze na hlášení agenta. Otevřete dashboard a zkontrolujte zónu.
-
Ověřte šíření DNS
Požádejte server Cloudflare MCP, aby ověřil, že se záznam propagoval.
Verify DNS propagation for test.cloudflaredemo.netRan: dig @1.1.1.1 test.cloudflaredemo.net AAAA +short - Result: DNS resolves to Cloudflare IPv6 addresses (proxy active). - Resolvers returning AAAA: 1.1.1.1, 8.8.8.8, 9.9.9.9 - 2606:4700::6812:2f3 - 2606:4700::6812:3f3 -
Odstraňte záznam DNS
Záznam můžete smazat stejně snadno, jako jste ho vytvořili.
Delete test.cloudflaredemo.netRan Cloudflare API Code Executor Deleted the DNS record for test.cloudflaredemo.net.
Nyní máte AI agenta s právy pro čtení i zápis ke službám Cloudflare v účtu, ovládaného zcela z Visual Studio Code.
Související zdroje
- Rychlý start s Visual Studio Code tedy stručný návod k nastavení, tipy, časté dotazy (FAQ) a řešení problémů.
- Server Cloudflare MCP ↗ tedy MCP servery pro konkrétní produkty.
- Cloudflare API tedy úplná referenční dokumentace REST API.