Skip to content

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

エージェント向けドキュメント

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

AI エージェント（Cursor、GitHub Copilot、Claude Code などのツール）は、Cloudflare 製品についての質問に答えたり、設定を生成したり、代わりに Cloudflare API を呼び出したりできます。Cloudflare のドキュメントは、エージェント向けの形式、agent skills、MCP サーバーを提供しています。そのため、AI エージェントはドキュメントを参照し、Cloudflare のサービスと直接やり取りできます。

このページでは、利用できる方法とセットアップ手順を説明します。

クイックスタート

次のリソースは、Cloudflare ドキュメントを AI エージェントと使うときの異なる側面を扱っています。自分にいちばん近いものから始めてください。

概念

Agent skills

Agent skills ↗ は、AI ツールが必要に応じて読み込む、作業ごとの構造化された手順です。たとえば、Cloudflare Worker のデプロイ方法や WAF（Web Application Firewall）ルールの設定方法をエージェントに教える skill があります。Skills を使うと、エージェントは本来持っていない Cloudflare 固有の手順を得られます。Cloudflare は Workers、ストレージ、AI、ネットワーキング、セキュリティなどをカバーする skills を Cloudflare Skills リポジトリ ↗ で公開しています。

Skills のインストール方法はエージェントごとに異なります。インストール手順は エージェントのセットアップ を参照してください。

Model Context Protocol（MCP）

Model Context Protocol ↗（MCP）は、AI ツールが外部のツール、データ、サービスに接続する方法を定義するオープン標準です。MCP サーバーは、特定の機能を公開するアプリケーションです。エージェントに接続すると、エージェントはその機能をワークフローの一部として使えます（ドキュメントの検索、DNS レコードの作成、Workers のデプロイなど）。

Cloudflare はマネージドのリモート MCP サーバーを運用しています。作業中のエージェントは、ドキュメント検索、Cloudflare API の呼び出し、ログと分析の照会ができます。

アプローチは 2 つあります。

  • Cloudflare API MCP サーバー：Cloudflare API 全体（2,500 を超えるエンドポイント）をカバーする Code Mode サーバーです。エージェントが複数の Cloudflare 製品に広くアクセスする必要があるときに使います。
  • ドメイン固有のサーバー：ドキュメント、オブザーバビリティ、DNS 分析などに特化したサーバーです。特定の領域だけにアクセスすればよいときに使います。カタログ全体は cloudflare/mcp-server-cloudflare ↗ リポジトリにあります。

各エージェントの セットアップ ガイドのクイックスタートには、MCP サーバーのインストール手順が含まれています。利用できる MCP サーバーの一覧は、Cloudflare 向け MCP サーバー を参照してください。

モデルの柔軟性

AI エージェントは、リクエストを理解し応答を生成するために大規模言語モデル（LLM）を使います。モデルは応答の品質、速度、コストに影響します。選べるモデルの数はエージェントによって異なります。

  • Locked：ベンダー自身のモデルだけが使えます。
  • BYOK（Bring Your Own Key）：好きなモデルプロバイダーの API キーを自分で用意します。
  • Multi-provider：複数のモデルプロバイダーが最初から使えます。

コンテキストの扱い

会話のあいだにプロジェクト情報をどう保持するかで、セッションをまたいでエージェントがどれだけ覚えているかが変わります。

  • Project memory：保存したファイルやメモリを使い、セッションをまたいでコンテキストを覚えます。
  • Indexed codebase：リポジトリの検索可能なインデックスを作り、すばやく参照します。

エージェントをセットアップする

対応する各エージェントには、インストール、skills、MCP サーバーの設定、プロンプト例、ヒント、トラブルシューティングをまとめた専用ガイドがあります。

始める

LLM 向け Markdown ドキュメント

AI ツールは HTML より Markdown のほうが扱いやすいです。Markdown の明示的な構造は HTML タグよりオーバーヘッドが少なく、無駄なトークン（AI モデルが処理するテキストの単位）を減らし、結果もよくなります。

すべてのドキュメントページは、次のいずれかの方法で Markdown として取得できます。Markdown for Agents がこの機能を提供しています。

表示中のページからコピーする

任意のドキュメントページで Copy as Markdown を選ぶと、表示中のページを Markdown としてコピーできます。

URL の末尾に /index.md を付ける

任意のページ URL の末尾に /index.md を追加します。例:

https://developers.cloudflare.com/workers/get-started/index.md

Accept: text/markdown ヘッダーを送る

任意のページに Accept: text/markdown ヘッダーを付けてリクエストすると、サーバーに HTML ではなく Markdown を返すよう伝えます。

curl "https://developers.cloudflare.com/workers/get-started/" \
  --header "Accept: text/markdown"

応答には、Markdown 文書と元の HTML 文書の推定トークン数を示す x-markdown-tokens と x-original-tokens ヘッダーが含まれます。コンテキストウィンドウ（AI モデルが一度に扱えるトークン数の上限）の見積もりに使えます。

サイト全体のエンドポイント

次のエンドポイントは llms.txt 標準 ↗ に従い、ドキュメントを Markdown 形式で提供します。

エンドポイント 説明
/llms.txt 製品カテゴリごとにグループ化したページ一覧。各製品の llms.txt へのリンク付き
/llms-full.txt すべてのドキュメント本文を 1 つのファイルにまとめたもの。オフラインのインデックス作成、一括ベクトル化（類似検索用に内容を数値表現へ変換すること）、または大きなコンテキストを扱えるモデル向け

製品ごとのエンドポイント

各製品には、スコープを絞った独自の llms.txt と llms-full.txt があります。特定製品のドキュメントだけが必要なときに使います。

エンドポイント 説明
/workers/llms.txt Workers ドキュメントのページ一覧
/workers/llms-full.txt Workers ドキュメント全ページの本文

/workers/ は任意の製品パスに置き換えられます。利用できる製品の一覧は /llms.txt を参照してください。

OpenAPI 仕様

OpenAPI 仕様 ↗ は、API の機械可読な説明です。利用できるエンドポイント、各エンドポイントが受け付けるパラメーター、返す応答を列挙します。AI ツールのコンテキストに追加すると、ドキュメントを手で調べなくても Cloudflare サービスへの API 呼び出しを生成できます。

Cloudflare API の完全な OpenAPI 仕様は、AI コーディングツール、API クライアント、コードジェネレーター向けに公開されています。

エンドポイント 説明
cloudflare/api-schemas ↗ Cloudflare API の完全な OpenAPI 仕様（JSON）

API リファレンス全体は Cloudflare API ドキュメント を参照してください。

役に立ちましたか？