Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

Visual Studio Code 詳細ウォークスルー

最終更新 Markdown で表示Agent セットアップ

このウォークスルーでは、Cloudflare MCP サーバーを使って Visual Studio Code を Cloudflare API に直接接続します。最後には、エディターを離れずに、一文を入力するだけで DNS レコードを作成できるようになります。

mcp.cloudflare.com の Cloudflare MCP サーバーは、MCP 対応のエージェントへ Cloudflare API を公開します。Visual Studio Code の Copilot エージェントがこれに接続し、自然言語から API 呼び出しを実行します。

簡潔な手順は、Visual Studio Code クイックスタートを参照してください。

始める前に

  • Visual Studio Code を最新にしてください。エディターと Copilot 拡張のバージョン不一致は、エージェントモードのエラーで最も多い原因です。
  • GitHub Copilot。任意の GitHub アカウントで利用でき、無料プランで十分です。
  • エージェントに接続してもよい Cloudflare アカウント。デモ用アカウントを使ってください。理由は認可の手順で明らかになります。

Visual Studio Code を Cloudflare API に接続する

  1. Visual Studio Code のバージョンを確認する

    Visual Studio Code を開き、ヘルプ > バージョン情報 を選びます。現行ビルドであることを確認します。タイトルバーに 更新 ボタンが出ている場合は、それを選んで Visual Studio Code の再起動が終わるまで待ってから続けます。

    インストール済みバージョンを確認する「バージョン情報」ダイアログを表示した Visual Studio Code のヘルプメニュー
  2. Copilot にサインインする

    ステータスバーの Copilot アイコンを選び、AI 機能を使用 を選んでから、GitHub アカウントでサインインします。Visual Studio Code がブラウザーを開いて認可します。

    AI 機能を有効にし、GitHub でサインインするよう求める Visual Studio Code のプロンプト
  3. Copilot を認証する

    ブラウザーの案内に従って GitHub に認証します。

    GitHub Copilot を認可するための GitHub サインインページ
  4. フォルダーを作成して開く

    このプロジェクト用の空フォルダーを作成し、ファイル > フォルダーを開く で Visual Studio Code で開きます。例: ~/cloudflare-api-mcp/

    空のプロジェクトフォルダーを選んでいる Visual Studio Code の「フォルダーを開く」ダイアログ
  5. 設定ファイルを作成する

    フォルダー内に .vscode/mcp.json を1つ作成します。エクスプローラーで .vscode/mcp.json と入力すると、フォルダーとファイルが同時に作れます。

    .vscode/mcp.json 設定ファイルを作成している Visual Studio Code のエクスプローラー

    次の内容をファイルに貼り付けて保存します。

    {
      "servers": {
        "cloudflare-api": {
          "type": "http",
          "url": "https://mcp.cloudflare.com/mcp"
        }
      }
    }
  6. サーバーを起動する

    ファイルを保存すると、cloudflare-api のサーバー定義の上に Start リンクが表示されます。コメントのように見えますが、ボタンです(CodeLens)。それを選び、認証プロンプトを許可します。ブラウザーが Cloudflare の認可ページを開きます。

    mcp.json 内の Cloudflare MCP サーバー定義に表示された Start CodeLens
  7. アクセス用テンプレートを選ぶ

    認可ページで、エージェントがアクセスできる範囲を決めます。この例では、DNS レコードを変更するために フルアクセス を選びます。読み取り専用 から始めることも、カスタム の権限セットを作ることもできます。付与範囲を1つのアカウントに限定し、付与する内容を確認してください。

    アクセステンプレートとアカウント範囲のオプションを表示する Cloudflare MCP の認可ページ

    認可する前に、次の2点を把握してください。フルアクセス ではエージェントが実際のリソースを作成・削除できるため、デモ用アカウントで行うべきです。付与はダッシュボードの マイプロファイル > アクセス管理 > 接続済みアプリケーション からいつでも取り消せます。再認可の挙動がおかしいときも、このページを確認します。

  8. 権限を確認して認可する

    権限の一覧を確認し、認可 を選んで Cloudflare API がアカウントと連携できるようにします。

    認可前に要求されている権限グループを一覧表示する Cloudflare MCP の認可ページ 現在のセッションで Cloudflare MCP サーバーを許可する Visual Studio Code Copilot のプロンプト
  9. Copilot Chat を開く

    Copilot が最小化されている場合は、表示 > チャット で開きます。

    Copilot Chat パネルを開く Visual Studio Code の表示メニュー
  10. サーバーが稼働していることを確認する

    サーバーは稼働中と表示されます。CodeLens は Running | 3 tools です。ツールが3つであるのは正常で、インストールの不具合ではありません。サーバーは何千もの個別エンドポイントを登録するのではなく、検索して実行するパターンを使います。

    ツールが3つの状態で稼働している Cloudflare MCP サーバーを示す Visual Studio Code の CodeLens
  11. ゾーンを一覧する

    Copilot Chat でモードを Agent にし、ゾーンの一覧を依頼します。エージェントは呼び出しの前に承認を求め、アカウント内のすべてのドメインのライブ一覧を返します。

    アカウント内の Cloudflare ゾーン一覧を返す Copilot Chat
    List zones in my account
    Ran Cloudflare API Code Executor
    
    - Zones returned: 1
    - Zone: cloudflaredemo.net — id: <ZONE_ID> — status: active
  12. DNS レコードを作成する

    エージェントに DNS AAAA レコードの作成と Cloudflare プロキシの有効化を依頼します。この例では、test.cloudflaredemo.net100:: に向けます。100:: は IPv6 discard プレフィックス 0100::/64RFC 6666)の予約済みプレースホルダーアドレスです。レコードはプロキシされるため、Cloudflare はこのアドレスに届く前にリクエストを受け取ります。ツール呼び出しを承認し(Always Allow)、エージェントがレコード作成を報告します。

    Cloudflare MCP サーバー経由でプロキシ済み AAAA DNS レコードを作成する Copilot Chat
    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>

    エージェントの報告だけに頼らないでください。ダッシュボードを開いてゾーンを確認します。

    新しい AAAA レコードの存在を確認する Cloudflare ダッシュボードの DNS レコードページ
  13. DNS の伝播を確認する

    Cloudflare MCP サーバーに、レコードが伝播したことを確認するよう依頼します。

    パブリックリゾルバー間で DNS の伝播を確認する Copilot Chat
    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. DNS レコードを削除する

    作成したときと同様に、レコードを削除できます。

    Cloudflare MCP サーバー経由でテスト用 DNS レコードを削除する Copilot Chat
    Delete test.cloudflaredemo.net
    Ran Cloudflare API Code Executor
    
    Deleted the DNS record for test.cloudflaredemo.net.

これで、Visual Studio Code からだけで、アカウント内の Cloudflare サービスに対する読み取りと書き込みができる AI エージェントを利用できます。

関連リソース

役に立ちましたか?