Cloudflare

カスタマイズ

実行する前に、次の場所にユーザー設定があるか確認してください。 ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Cloudflare/

このディレクトリが存在する場合は、そこにある PREFERENCES.md、設定、またはリソースを読み込んで適用してください。これらはデフォルトの動作より優先されます。ディレクトリが存在しない場合は、スキルのデフォルト設定を使用してください。

必須：音声通知（何らかの操作を行う前に必須）

このスキルが呼び出されたら、ほかのことをする前に必ずこの通知を送信してください。

1. 音声通知を送信する：

   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the Cloudflare skill to ACTION"}' \
     > /dev/null 2>&1 &
   

2. テキスト通知を出力する：

   Running the **WorkflowName** workflow in the **Cloudflare** skill to ACTION...
   

これは任意ではありません。このスキルが呼び出されたら、直ちにこの curl コマンドを実行してください。

Cloudflare スキル

Cloudflare Workers、Pages、各種サービスをデプロイおよび管理します。相互に補完する 2 つのツールを使用します。

• Code Mode MCP（API 操作に主に使用） — search() + execute() で Workers の照会、KV/R2/D1 の管理、デプロイ状況、DNS、アナリティクスの確認を行います。従来の MCP では 1.17M トークンを使用するのに対し、約 1,069 トークンです。
• Wrangler（デプロイ／開発専用） — wrangler deploy、wrangler dev、wrangler pages deploy を使って、ローカルファイルからデプロイします。

2 つのモードのリファレンス

操作	ツール	理由
Worker のデプロイ	wrangler deploy	ローカルファイルと wrangler.toml が必要です
Pages のデプロイ	wrangler pages deploy	dist/ ディレクトリが必要です
ローカル開発	wrangler dev	ローカルサーバーです
Workers の一覧表示	MCP execute()	API クエリで、ローカルファイルは不要です
デプロイ状況の確認	MCP execute()	API クエリです
KV の読み書き	MCP execute()	API 操作です
DNS の管理	MCP execute()	API 操作です
ログの表示	MCP execute()	API クエリです
R2/D1/Vectorize の確認	MCP execute()	API 操作です
アナリティクスの表示	MCP execute()	API クエリです

ワークフローの振り分け

ワークフローを実行する際は、この通知を直接出力してください。

Running the **WorkflowName** workflow in the **Cloudflare** skill to ACTION...

• Worker または MCP サーバーの作成 → Workflows/Create.md
• デプロイの問題のトラブルシューティング → Workflows/Troubleshoot.md
• Cloudflare の状態の照会（Workers の一覧表示、KV、DNS、アナリティクスの確認） → Workflows/Query.md

Code Mode MCP リファレンス

Cloudflare Code Mode MCP サーバー（https://mcp.cloudflare.com/mcp）は、2 つのツールを通じて Cloudflare API 全体を公開します。

search() — エンドポイントの検索

キーワードで API エンドポイントを検索します。正確なパスがわからない場合に使用します。

// Example: Find all Workers-related endpoints
search("workers scripts")

// Example: Find KV namespace operations
search("KV namespace")

// Example: Find DNS record endpoints
search("DNS records")

execute() — API の呼び出し

任意の Cloudflare API エンドポイントを直接実行します。OAuth を通じて認証を自動的に処理します。

// Example: List all Workers scripts
execute("GET /accounts/{account_id}/workers/scripts")

// Example: Read a KV value
execute("GET /accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name}")

// Example: List DNS records
execute("GET /zones/{zone_id}/dns_records")

MCP 認証

Code Mode MCP は OAuth を通じて認証を処理するため、トークンは不要です。初回使用時に Cloudflare へのログインを求められます。その後、認証情報はキャッシュされます。

クイックリファレンス

• アカウント ID： CF_ACCOUNT_ID 環境変数で設定します
• Worker の URL 形式： https://[worker-name].[your-subdomain].workers.dev

デプロイコマンド

Workers のデプロイ

# Unset tokens that interfere with wrangler login-based auth
(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && wrangler deploy)

Pages のデプロイ

重要：すべての環境トークンには Pages の権限がありません。OAuth を使用するには、必ずそれらの設定を解除してください。

# ALWAYS unset tokens for Pages - OAuth login works, tokens don't
(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && bunx wrangler pages deploy dist --project-name=PROJECT_NAME --commit-dirty=true)

重要な注意事項

• Workers： デプロイ前に CF_API_TOKEN と CLOUDFLARE_API_TOKEN の設定を解除してください。これらは wrangler のログインベースの認証に干渉します。
• Pages： すべてのトークンの設定を解除してください。API トークンには Pages の権限がありません。OAuth ベースの wrangler ログインが機能する唯一の方法です。
• API クエリ： api.cloudflare.com に対する手動の curl や fetch() の代わりに、Code Mode MCP を使用してください。
• Wrangler の用途： デプロイ、開発、Pages のデプロイ、ローカル設定のみです。

例

例 1：Worker をデプロイする

User: "deploy the MCP server to Cloudflare"
-> Invokes CREATE workflow
-> Unsets env tokens, runs wrangler deploy
-> Verifies via MCP execute() that worker is live
-> "Deployed to https://mcp-server.[subdomain].workers.dev"

例 2：Cloudflare の状態を照会する

User: "list all my workers"
-> Invokes QUERY workflow
-> MCP search("workers scripts") to find endpoint
-> MCP execute("GET /accounts/{id}/workers/scripts")
-> Returns list of all deployed workers

例 3：デプロイエラーを修正する

User: "Cloudflare deploy is failing with auth error"
-> Invokes TROUBLESHOOT workflow
-> MCP execute() to check deployment status and logs
-> Identifies token interference
-> "Fixed - tokens were overriding OAuth. Redeployed successfully."

例 4：DNS レコードを確認する

User: "what DNS records does example.com have?"
-> Invokes QUERY workflow
-> MCP search("DNS records") + execute() to list records
-> Returns full DNS record table