INTEGRITY Dokumentace

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

Připojte Visual Studio Code k rozhraní Cloudflare API

  1. 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.

    Nabídka Help ve Visual Studio Code zobrazující dialog About, který slouží k ověření nainstalované verze
  2. 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.

    Výzva Visual Studio Code k zapnutí AI funkcí a přihlášení přes GitHub
  3. Ověření v Copilotu

    Podle pokynů na stránkách v prohlížeči se ověřte u GitHubu.

    přihlašovací stránka GitHub pro autorizaci GitHub Copilot
  4. 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/.

    Dialog Open Folder ve Visual Studio Code s výběrem prázdné složky projektu
  5. Vytvořte konfigurační soubor

    Uvnitř složky vytvořte jeden soubor: .vscode/mcp.json. Typování .vscode/mcp.json v Exploreru vytvoří složku a soubor zároveň.

    Explorer ve Visual Studio Code vytvářející konfigurační soubor .vscode/mcp.json

    Vložte následující do souboru a uložte ho:

    {
      "servers": {
        "cloudflare-api": {
          "type": "http",
          "url": "https://mcp.cloudflare.com/mcp"
        }
      }
    }
  6. Spusťte server

    Po uložení souboru se Spustit se odkaz zobrazí na cloudflare-api definici 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.

    Visual Studio Code zobrazující CodeLens Start u definice serveru Cloudflare MCP v mcp.json
  7. 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.

    Stránka autorizace Cloudflare MCP se šablonami přístupu a možnostmi rozsahu účtu

    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ě.

  8. 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.

    Stránka autorizace Cloudflare MCP se seznamem požadovaných skupin oprávnění před autorizací Výzva Copilot ve Visual Studio Code k povolení serveru Cloudflare MCP v aktuální relaci
  9. Otevřete Copilot Chat

    Pokud je Copilot minimalizovaný, otevřete jej pomocí Zobrazit > Chat.

    Nabídka View ve Visual Studio Code otevírající panel Copilot Chat
  10. 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ů.

    CodeLens ve Visual Studio Code zobrazující spuštěný server Cloudflare MCP se třemi nástroji
  11. 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.

    Copilot Chat vrací seznam zón Cloudflare z účtu
    List zones in my account
    Ran Cloudflare API Code Executor
    
    - Zones returned: 1
    - Zone: cloudflaredemo.net — id: <ZONE_ID> — status: active
  12. 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.net na 100::, rezervovanou zástupnou adresu z rozsahu IPv6 discard prefix 0100::/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.

    Copilot Chat vytváří proxovaný záznam DNS AAAA prostřednictvím MCP serveru Cloudflare
    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.

    Stránka záznamů DNS v dashboardu Cloudflare potvrzující existenci nového záznamu AAAA
  13. Ověřte šíření DNS

    Požádejte server Cloudflare MCP, aby ověřil, že se záznam propagoval.

    Copilot Chat ověřuje šíření DNS napříč veřejnými resolvery
    Verify DNS propagation for test.cloudflaredemo.net
    Ran: 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
  14. Odstraňte záznam DNS

    Záznam můžete smazat stejně snadno, jako jste ho vytvořili.

    Copilot Chat odstraňuje testovací záznam DNS prostřednictvím MCP serveru Cloudflare
    Delete test.cloudflaredemo.net
    Ran 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.