AIエージェントにCloudflareの設定を任せたくても、ドキュメントをコピー&ペーストして渡す手間がボトルネックになっていないでしょうか。Cloudflareが公式ドキュメントサイトに追加した「Docs for agents」は、AIコーディングエージェントがドキュメントを直接取得・検索・操作できる仕組みです。

この記事でわかること

  • Docs for agentsが解決する課題
  • llms.txt・Markdown変換・MCPサーバーなど4つの主要機能
  • Claude Code・Cursor・GitHub Copilotなど6ツールへの導入方法
  • ワンステップで全機能を接続するクイックセットアップ

なぜAIエージェントに専用のドキュメント形式が必要なのか

https://developers.cloudflare.com/docs-for-agents/

AIエージェントがWebページを読むとき、HTML内のナビゲーション、広告、JavaScriptがノイズになります。コンテキストウィンドウ（AIが一度に処理できるテキスト量）には上限があるため、不要な情報がトークンを消費すると、肝心の設定手順や仕様が入りきりません。

Cloudflareのドキュメントは製品ごとに数百ページあります。人間はサイドバーや検索で目的のページに辿り着けますが、AIエージェントには同じ導線が使えません。Docs for agentsは、AIが効率よく読める形式でドキュメントを提供し、さらにAPIやログへのアクセス手段まで一括で揃えます。

llms.txt標準への対応

Docs for agentsの土台になっているのが、llms.txt標準です。2024年9月にAnswer.AIのJeremy Howard氏が提案した仕様で、Webサイトのルートに/llms.txtというMarkdownファイルを置き、サイト構造とドキュメントの場所をAIに伝えます。robots.txtがクローラー向けのアクセス制御を担うように、llms.txtはLLM向けの案内図として機能します。

Cloudflareは以下のエンドポイントを公開しています。

  • /llms.txt — 製品カテゴリ別のページ一覧
  • /llms-full.txt — 全ドキュメントの本文を1ファイルにまとめたもの
  • /workers/llms.txt のような製品別エンドポイント — 特定製品のドキュメントだけが必要な場合に使う

製品パスを変えれば、Workers・R2・D1・Workers AIなど、どの製品のドキュメントでも同じ形式で取得できます。

Markdown変換で全ページがAI対応に

llms.txtは目次の役割ですが、個別ページの本文もAIが読みやすい形で取得できます。3つの方法が用意されています。

1つ目は、URLの末尾に/index.mdを追加する方法です。たとえば https://developers.cloudflare.com/workers/get-started/index.md にアクセスすると、そのページのMarkdown版が返ります。

2つ目は、HTTPリクエストにAccept: text/markdownヘッダを付ける方法です。レスポンスにはx-markdown-tokensヘッダが含ま���、そのドキュメントの推定トークン数がわかります。コンテキストウィンドウの残り容量と照らし合わせて、読み込むかどうかを判断できます。

3つ目は、ドキュメントページ上の「Copy as Markdown」ボタンです。これは人間がAIに手動でコピーして渡す場合に使います。

MCPサーバーとエージェントスキル

Docs for agentsはドキュメントの提供だけで終わりません。MCP（Model Context Protocol）サーバーを通じて、AIエージェントがCloudflareのAPIを直接呼び出せます。

MCPサーバーは2種類あります。Code Modeは、Cloudflare API全体（2,500以上のエンドポイント）をカバーする単一のサーバーです。DNSレコードの作成、Workersのデプロイ、ログの検索など、複数の製品にまたがる操作が必要な場合に使います。もう一つはドメイン別サーバーで、ドキュメント検索・オブザーバビリティ・DNS分析など、特定の領域だけに絞ったサーバーです。

エージェントスキルは、タスクに特化した構造化された指示です。たとえば「Cloudflare Workerをデプロイする手順」や「WAFルールを設定する方法」といった知識をAIエージェントに教えます。Workers・ストレージ・AI・ネットワーク・セキュリティなど主要製品をカバーするスキルが、GitHubのCloudflare Skillsリポジトリで公開されています。

対応エージェントと導入手順

https://developers.cloudflare.com/agent-setup/

現時点で公式にセットアップガイドが用意されているエージェントは6つです。

Claude CodeはAnthropicのターミナルベースのエージェントで、コードベースの理解・コマンド実行・Git操作に対応します。CodexはOpenAIのオープンソースターミナルエージェントで、サンドボックス環境でファイル操作やWeb閲覧が可能です。CursorはVS Codeベースのエディタで、複数ファイルの同時編集やバックグラウンドエージェントを備えます。GitHub Copilotはエディタ拡張とCLIの両方でエージェントモードを使えます。OpenCodeは75以上のLLMに対応するオープンソースのターミナルエージェントです。WindsurfはCascadeコンテキストエンジンとFlowsによる自動化が特徴のIDEです。

6ツールすべてがスキルとMCPに対応しています。

クイックセットアップ

最も手軽な導入方法は、任意のAIコーディングエージェントに以下のURLを読み込ませることです。

https://developers.cloudflare.com/agent-setup/prompt.md

このプロンプトを貼り付けるだけで、スキルのインストールとMCPサーバーの登録が一括で実行されます。エージェントごとの個別設定は、/agent-setup/配下の各ガイドに詳しくまとめられています。

ドキュメントをAI対応にする流れは加速している

Cloudflareの動きは、ドキュメントの消費者が人間だけではなくなった現実を映しています。llms.txt標準はまだ公式な業界標準にはなっていませんが、Cloudflareのように大規模なプラットフォームが全面採用したことで、他のサービスにも波及する可能性があります。AIエージェントを使って開発している方は、Cloudflareのドキュメントをエージェントに直接接続するだけで、手動のコピー作業から解放されます。