Cognition

Windsurf + Cloudflare

エージェント型 IDE です。Cascade コンテキストと、複数ステップ作業向けの Flows があります。Cognition 製です。

IDEスタンドアロン

Cloudflare SkillsCloudflare Code Mode API MCPCloudflare ドメイン固有 MCPWindsurf のドキュメント

クイックスタート

Windsurf をダウンロードする

Windsurf のダウンロードページ ↗ から、macOS、Windows、Linux 向けの Windsurf をダウンロードします。

Cloudflare Skills をインストールする

npx skills add https://github.com/cloudflare/skills

Cloudflare MCP サーバーを設定する

Cloudflare API サーバーと docs サーバーを ~/.codeium/windsurf/mcp_config.json に追加します。ドメイン固有の MCP サーバーは mcp-server-cloudflare ↗ を参照してください。Cloudflare API MCP サーバー全体（Code Mode）は cloudflare/mcp ↗ を参照してください。

{
  "mcpServers": {
    "cloudflare": { "serverUrl": "https://mcp.cloudflare.com/mcp" },
    "cloudflare-docs": { "serverUrl": "https://docs.mcp.cloudflare.com/mcp" },
    "cloudflare-bindings": { "serverUrl": "https://bindings.mcp.cloudflare.com/mcp" },
    "cloudflare-builds": { "serverUrl": "https://builds.mcp.cloudflare.com/mcp" },
    "cloudflare-observability": { "serverUrl": "https://observability.mcp.cloudflare.com/mcp" }
  }
}

プロンプトを試す

Cascade を開き、次のようなプロンプトを試します。

Workers の分析をデータウェアハウスへ流す Logpush ジョブを作ってください。

Cloudflare プラットフォームへのアクセス

各セクションを開くと、詳しく読めます。

Cloudflare Skills

Cloudflare の仕組みをエージェントに教える、持続するプラットフォームコンテキストです。

Skills は、エージェントが必要なときに読み込む手順です。 cloudflare/skills バンドルはプラットフォームの各層をカバーします。そのため、毎回説明しなくても、エージェントはあなたの作法を把握します。

agents-sdkBuild, debug, or review Cloudflare Agents SDK applications using the agents package.
cloudflareDiscover and choose Cloudflare products for apps, APIs, AI agents, storage, networking, and security. Use for architecture and product selection, including when the user describes a need without naming a Cloudflare product; then find the relevant skill or documentation.
cloudflare-email-serviceImplement or troubleshoot Cloudflare Email Sending and Email Routing integrations and their delivery configuration.
cloudflare-oneDesign, configure, troubleshoot, or review Cloudflare One Zero Trust and SASE deployments. Use cloudflare-one-migrations for migration planning from other vendors.
cloudflare-one-migrationsAssess and plan migrations from existing VPN, SWG, or SASE platforms to Cloudflare One, including policy mapping, parity gaps, and rollout.
durable-objectsBuild, debug, or review Cloudflare Durable Objects code for persistent state and coordination.
nextjs-on-cloudflareBuild, migrate, and deploy Next.js apps on Cloudflare Workers with vinext. Use when starting a Next.js project on Cloudflare, moving an existing app to Workers, choosing between vinext and OpenNext, or setting up vinext for Workers. For setup, migration, or deployment, install vinext's upstream skills with `npx skills add cloudflare/vinext` if missing, then read and follow the applicable skill and docs.
sandbox-migrate-to-nextMigrate Cloudflare Sandbox apps from stable @cloudflare/sandbox to @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-next for apps already on the preview.
sandbox-nextBuild or maintain Cloudflare Sandbox apps on @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-migrate-to-next when porting a stable app.
sandbox-stableBuild or maintain Cloudflare Sandbox apps on the stable @cloudflare/sandbox package. Use sandbox-next for preview apps and sandbox-migrate-to-next for stable-to-preview migrations.
turnstile-spinSet up, repair, or migrate to Cloudflare Turnstile bot verification in an existing frontend and backend, including server-side Siteverify.
web-perfAudit, diagnose, or optimize website loading and interaction performance, Core Web Vitals, and Lighthouse performance scores.
workers-best-practicesCloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers.
wranglerRun or troubleshoot Wrangler CLI commands and configure Worker projects for local development, deployment, and Cloudflare resource management.

MCP サーバー

Cloudflare API、ドキュメント、可観測性へのライブアクセスです。

MCP サーバーは、実行時に Cloudflare を呼ぶ型付きツールを提供します。選択肢は 2 つです。Code Mode — Cloudflare API 全体をカバーする 1 台のサーバー（約 1,000 トークンで 2,500 以上のエンドポイント）— か、 cloudflare/mcp-server-cloudflare リポジトリでホストされる、領域に特化したサーバー群です。カタログ全体は Cloudflare 向け MCP サーバーのドキュメントにもあります。

Code mode APIcode modeBroad access to the full Cloudflare API via code execution, with minimal token overheadhttps://mcp.cloudflare.com/mcp
Code Mode servercode modeBest when you want broad access across Cloudflare's APIs through code executionhttps://mcp.cloudflare.com/mcp
AI Gateway serverSearch your logs, get details about the prompts and responseshttps://ai-gateway.mcp.cloudflare.com/mcp
Audit Logs serverQuery audit logs and generate reports for reviewhttps://auditlogs.mcp.cloudflare.com/mcp
AutoRAG serverSearch and query account AutoRAG instanceshttps://autorag.mcp.cloudflare.com/mcp
Browser Run serverFetch web pages, convert them to markdown and take screenshotshttps://browser.mcp.cloudflare.com/mcp
Cloudflare Blog serverSearch and read posts from the Cloudflare Bloghttps://blog.mcp.cloudflare.com/mcp
Cloudflare One CASB serverQuickly identify any security misconfigurations for SaaS applications to safeguard users & datahttps://casb.mcp.cloudflare.com/mcp
Container serverSpin up a sandbox development environmenthttps://containers.mcp.cloudflare.com/mcp
Demo Day serverDemonstrate a minimal Cloudflare MCP serverhttps://demo-day.mcp.cloudflare.com/mcp
Digital Experience Monitoring serverGet quick insight on critical applications for your organizationhttps://dex.mcp.cloudflare.com/mcp
DNS Analytics serverOptimize DNS performance and debug issues based on current setuphttps://dns-analytics.mcp.cloudflare.com/mcp
Documentation serverGet up-to-date reference information on Cloudflarehttps://docs.mcp.cloudflare.com/mcp
Logpush serverGet quick summaries for Logpush job healthhttps://logs.mcp.cloudflare.com/mcp
Observability serverDebug and get insight into your application's logs and analyticshttps://observability.mcp.cloudflare.com/mcp
Radar serverExplore Cloudflare Radar internet insightshttps://radar.mcp.cloudflare.com/mcp
Workers Bindings serverBuild Workers applications with storage, AI, and compute primitiveshttps://bindings.mcp.cloudflare.com/mcp
Workers Builds serverGet insights and manage your Cloudflare Workers Buildshttps://builds.mcp.cloudflare.com/mcp

Wrangler CLI

ローカル開発、デプロイ、Workers 向けコマンドです。

ローカル開発、デプロイ、製品固有のコマンド（wrangler d1 migrations apply や wrangler tail など）には Wrangler を使います。同梱の wrangler Skill が、いつそれを使うかをエージェントに教えます。

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

エージェント向けに最適化した、トークン効率のよいリファレンスです。

任意の Cloudflare ドキュメント URL に /index.md を付けると、きれいな Markdown 版になります。各トップレベル製品セクションには、1 つのコンテキストウィンドウに収まるページ索引の llms.txt もあります。よく使うものは次のとおりです。

developers.cloudflare.com/llms.txt — すべての Cloudflare 製品のディレクトリです。
developers.cloudflare.com/workers/llms.txt
developers.cloudflare.com/agents/llms.txt
developers.cloudflare.com/r2/llms.txt
developers.cloudflare.com/d1/llms.txt

これらのドキュメントがエージェント向けにどう構成されているかの全体像は、エージェント向けドキュメントガイドを参照してください。

プロンプトの例

EC ストアのオリジン負荷を減らすために、キャッシュルールとキャッシュ TTL を設定してください。

Durable Objects の WebSocket hibernation を使い、アプリにリアルタイム共同編集を追加してください。

Workers AI 上に、ストリーミング応答のあるサーバーレス AI 推論エンドポイントを作ってください。

この Worker を Cloudflare のステージングと本番にデプロイする GitHub Actions を設定してください。

AI Gateway を設定し、OpenAI と Workers AI の間で自動フォールバックとコスト追跡付きでリクエストをルーティングしてください。

ヒント

Cloudflare API MCP サーバーは Code Mode を使います。Cascade は JavaScript を書き、2,500 以上のエンドポイントを約 1,000 トークンで呼び出します。
@ メンションで wrangler.jsonc を Cascade のプロンプトに含めます。Cascade はコード生成時に、現在のバインディングをこのファイルから把握します。
observability MCP サーバーを追加すると、Cascade は IDE を離れずに Workers のログ確認とデプロイのデバッグを自動で行えます。

よくある質問

Windsurf は Cloudflare Skills に対応していますか？

はい。Windsurf は Cascade で Agent Skills に対応しています。 cloudflare/skills ↗ から Cloudflare Skills バンドルをインストールします。Cascade が Skills を検出して読み込む場所は、Windsurf Cascade Skills のドキュメント ↗ を参照してください。

Skills、MCP サーバー、Wrangler CLI のどれを使うべきですか。すべて使うべきですか。

3 つは互いに補完します。Cloudflare Skills は Workers 開発のパターンと慣習を Cascade に教えます。Cloudflare API MCP サーバーはプラットフォーム操作（DNS、WAF、Zero Trust、R2 バケット）を扱います。 Windsurf の統合ターミナル上の Wrangler がローカル開発とデプロイを担当します。 Cascade はこれらを自然に連携させます。

Cascade は Cloudflare にデプロイできますか？

はい。Cascade は統合ターミナルで npx wrangler deploy を実行できます。 MCP サーバーを設定していれば、マネージドデプロイやリソース作成のために Cloudflare API を直接呼び出すこともできます。

トラブルシューティング

MCP サーバーに接続できない

mcp_config.json の設定を確認します。変更後は Windsurf を再起動します。MCP サーバーの URL が /mcp で終わっていることも確認します。

Cloudflare 製品の情報が古い

エージェントが実行時に最新ドキュメントを取得できるよう、Cloudflare docs MCP サーバーを有効にします。MCP サーバーを使わない場合は、developers.cloudflare.com/llms.txt を直接指定すると全製品の一覧を参照できます。製品固有のインデックスは developers.cloudflare.com/<product>/llms.txt です。