コードモード：1,000トークンでエージェントにAPI全体を提供

Code Mode: 1,000トークンでエージェントにAPI全体を提供する ![](https://blog.cloudflare.com/cdn-cgi/image/format=auto,dpr=3,width=64,height=64,gravity=face,fit=crop,zoom=0.5/https://cf-assets.www.cloudflare.com/zkvhlag99gkb/3tQWp2cSHTttrxFseVLgH9/e468b31725cc9f8c61dae5e87b8da6a0/91c78ad4-3d50-4256-872b-ec4398e8f7f1_224x224.png) Matt Carey Model Context Protocol (MCP)は、AIエージェントが外部ツールを使用するための標準的な方法となっています。しかし、その中核には緊張関係があります。エージェントは有用な作業を行うために多くのツールを必要としますが、追加されるツールはすべてモデルのコンテキストウィンドウを埋め、実際のタスクに使える余地を減らしてしまうのです。 Code Modeは、エージェントがツールを使用する際のコンテキストウィンドウの使用量を削減するために私たちが初めて導入した技術です。すべての操作を個別のツールとして記述する代わりに、モデルに型付けされたSDKに対してコードを書かせ、そのコードをDynamic Worker Loader内で安全に実行させるのです。コードはコンパクトな計画として機能します。モデルはツール操作を探索し、複数の呼び出しを組み合わせ、必要なデータだけを返すことができます。Anthropicも彼らのCode Execution with MCPの投稿で同じパターンを独自に探究しました。 本日、私たちはCode Modeを使用した、Cloudflare API全体（DNSやZero TrustからWorkers、R2まで）向けの新しいMCPサーバーを発表します。search()とexecute()のわずか2つのツールだけで、このサーバーはMCP経由でCloudflare API全体へのアクセスを提供可能であり、約1,000トークンしか消費しません。APIエンドポイントの数に関わらず、このフットプリントは固定されたままです。 Cloudflare APIのような大規模なAPIでは、Code Modeは使用される入力トークン数を99.9%削減します。Code Modeなしの同等のMCPサーバーは117万トークンを消費するでしょう。これは、最も先進的な基盤モデルのコンテキストウィンドウ全体よりも多い量です。 tiktokenで測定した、Code modeによる節約効果とネイティブMCPの比較 この新しいCloudflare MCPサーバーは本日からご利用いただけます。また、Cloudflare Agents SDKに新しいCode Mode SDKをオープンソース化しますので、ご自身のMCPサーバーやAIエージェントでも同じアプローチを使用できます。 サーバーサイドのCode Mode この新しいMCPサーバーはCode Modeをサーバーサイドで適用します。何千ものツールの代わりに、サーバーはわずか2つをエクスポートします：search() [ { "name": "search", "description": "Cloudflare OpenAPI仕様を検索します。すべての$refは事前にインライン解決されています。", "inputSchema": { "type": "object", "properties": { "code": { "type": "string", "description": "OpenAPI仕様を検索するJavaScript非同期アロー関数" } }, "required": ["code"] } }, { "name": "execute", "description": "Cloudflare APIに対してJavaScriptコードを実行します。", "inputSchema": { "type": "object", "properties": { "code": { "type": "string", "description": "実行するJavaScript非同期アロー関数" } }, "required": ["code"] } } ] 何ができるかを発見するために、エージェントはsearch()を呼び出します。 エージェントが実行する準備ができたら、execute()を呼び出します。 両方のツールは、生成されたコードをDynamic Worker isolate内で実行します。これは軽量なV8サンドボックスであり、ファイルシステムはなく、環境変数はプロンプトインジェクションを通じて漏洩することはなく、外部フェッチはデフォルトで無効化されています。アウトバウンドリクエストは、必要に応じてアウトバウンドフェッチハンドラーで明示的に制御できます。 例：オリジンをDDoS攻撃から保護する ユーザーがエージェントに「私のオリジンをDDoS攻撃から保護して」と指示したとします。エージェントの最初のステップは、ドキュメントを参照することです。Cloudflare Docs MCP Serverを呼び出したり、Cloudflare Skillを使用したり、ウェブを直接検索したりするかもしれません。ドキュメントから、オリジンの前にCloudflare WAFとDDoS保護ルールを配置することを学びます。 ステップ1：適切なエンドポイントを検索する 検索 async () => { const results = []; for (const [path, methods] of Object.entries(spec.paths)) { if (path.includes('/zones/') && (path.includes('firewall/waf') || path.includes('rulesets'))) { for (const [method, op] of Object.entries(methods)) { results.push({ method: method.toUpperCase(), path, summary: op.summary }); } } } return results; } サーバーはこのコードをWorkers isolateで実行し、以下を返します： [ { "method": "GET", "path": "/zones/{zone_id}/firewall/waf/packages", "summary": "WAFパッケージを一覧表示" }, { "method": "PATCH", "path": "/zones/{zone_id}/firewall/waf/packages/{package_id}", "summary": "WAFパッケージを更新" }, { "method": "GET", "path": "/zones/{zone_id}/firewall/waf/packages/{package_id}/rules", "summary": "WAFルールを一覧表示" }, { "method": "PATCH", "path": "/zones/{zone_id}/firewall/waf/packages/{package_id}/rules/{rule_id}", "summary": "WAFルールを更新" }, { "method": "GET", "path": "/zones/{zone_id}/rulesets", "summary": "ゾーンルールセットを一覧表示" }, { "method": "POST", "path": "/zones/{zone_id}/rulesets", "summary": "ゾーンルールセットを作成" }, { "method": "GET", "path": "/zones/{zone_id}/rulesets/phases/{ruleset_phase}/entrypoint", "summary": "ゾーンエントリーポイントルールセットを取得" }, { "method": "PUT", "path": "/zones/{zone_id}/rulesets/phases/{ruleset_phase}/entrypoint", "summary": "ゾーンエントリーポイントルールセットを更新" }, { "method": "POST", "path": "/zones/{zone_id}/rulesets/{ruleset_id}/rules", "summary": "ゾーンルールセットルールを作成" }, { "method": "PATCH", "path": "/zones/{zone_id}/rulesets/{ruleset_id}/rules/{rule_id}", "summary": "ゾーンルールセットルールを更新" } ] Cloudflare API仕様全体には2,500以上のエンドポイントがあります。モデルはそれを、必要なWAFとルールセットのエンドポイントに絞り込みました。仕様のいかなる部分もコンテキストウィンドウに入ることはありませんでした。 モデルはまた、特定のエンドポイントのスキーマを呼び出す前に詳細に調べることもできます。ここでは、ゾーンルールセットで利用可能なフェーズを調べています： async () => { const op = spec.paths['/zones/{zone_id}/rulesets']?.get; const items = op?.responses?.['200']?.content?.['application/json']?.schema; // スキーマを辿ってフェーズの列挙型を見つける const props = items?.allOf?.[1]?.properties?.result?.items?.allOf?.[1]?.properties; return { phases: props?.phase?.enum }; } { "phases": [ "ddos_l4", "ddos_l7", "http_request_firewall_custom", "http_request_firewall_managed", "http_response_firewall_managed", "http_ratelimit", "http_request_redirect", "http_request_transform", "magic_transit", "magic_transit_managed" ] } エージェントは、必要な正確なフェーズがddos_l7とhttp_request_firewall_managedであることを知りました。 ステップ2：APIに対してアクションを実行する エージェントはexecute()の使用に切り替え、cloudflare.request()を使用してAPIを呼び出します。 async () => { const response = await cloudflare.request({ method: "GET", path: `/zones/${zoneId}/rulesets` }); return response.result.map(rs => ({ name: rs.name, phase: rs.phase, kind: rs.kind })); } [ { "name": "DDoS L7", "phase": "ddos_l7", "kind": "managed" }, { "name": "Cloudflare Managed","phase": "http_request_firewall_managed", "kind": "managed" }, { "name": "Custom rules", "phase": "http_request_firewall_custom", "kind": "zone" } ] エージェントは、管理されたDDoSとWAFのルールセットが既に存在することを確認します。これで、単一の実行内で、それらのルールを検査し、感度レベルを更新するために呼び出しを連鎖させることができます： async () => { // 現在のDDoS L7エントリーポイントルールセットを取得 const ddos = await cloudflare.request({ method: "GET", path: `/zones/${zoneId}/rulesets/phases/ddos_l7/entrypoint` }); // WAF管理ルールセットを取得 const waf = await cloudflare.request({ method: "GET", path: `/zones/${zoneId}/rulesets/phases/http_request_firewall_managed/entrypoint` }); } この操作全体、仕様の検索とスキーマの検査から、ルールセットの一覧表示、DDoSとWAFの設定の取得まで、わずか4回のツール呼び出しで完了しました。 Cloudflare MCPサーバー 私たちは個別の製品向けのMCPサーバーから始めました。DNSを管理するエージェントが欲しいですか？DNS MCPサーバーを追加してください。Workersのログが欲しいですか？Workers Observability MCPサーバーを追加してください。各サーバーは、API操作に対応する固定されたツールセットをエクスポートしていました。これはツールセットが小さい場合は機能しましたが、Cloudflare APIには2,500以上のエンドポイントがあります。手動でメンテナンスされるサーバーのコレクションでは追いつけません。 Cloudflare MCPサーバーはこれを簡素化します。2つのツール、約1,000トークンで、API内のすべてのエンドポイントをカバーします。新しい製品を追加するときも、同じsearch()とexecute()ツールが自動的にそれらを公開します。 私たちのMCPサーバーは最新のMCP仕様に基づいて構築されています。OAuth 2.1に準拠しており、Workers OAuth Providerを使用してトークンをダウンスコープし、

コードモード：1,000トークンでエージェントにAPI全体を提供

背景や根拠まで確認しますか？

関連記事

調べる

選ぶ

サイト