Cloudflareのエラーの知らせ、Claude Codeに直接届く

Cloudflareは10月30日、指標の急増やDDoS攻撃などの知らせを、SlackやメールだけでなくClaude Code、Cursor、Devinにも直接送れるようになったと開発者向けの公式Xアカウントで知らせた。中身は、Workersで起きたエラーをまとめる「Issues」の機能に付いた「自動化（Automations）」で、決めた条件に当たったエラーを、選んだ送り先へ渡す。送り先にコーディングエージェントを選ぶと、エラーの要約と調べるための情報がエージェントに届き、エージェントはつないだリポジトリを読んで、コードとテストの直しを出す。

条件は2種類、送り先は4種類

Cloudflareの開発者向けの説明書によると、知らせを出す条件は2つある。1つは、同じエラーの回数が決めた数を超えた時に1回だけ動くもの。超えた後は毎回は動かない。もう1つは、しばらく出ていなかったエラーが、決めた期間の後にまた出た時に動くものだ。

送り先は、コーディングエージェント、汎用のWebhook、チャット、障害対応の道具の4種類。設定はダッシュボードのIssuesのページか、CloudflareのCLI（コマンドの名前はcf）で行う。条件と送り先を選び、「有効」にして作れば終わる。条件を待たずに、エラーの画面から送り先を選んで手で送ることもできる。

3つのエージェントに対応

コーディングエージェントの送り先として最初から用意されているのは、Claude Code、Cursor、Devinの3つだ。Claude Codeでは、Claude CodeのRoutineのIDと認証のトークンを入れる。Cursorでは、Cursorのクラウドのエージェントの自動化のWebhookのURLを入れる。Devinでは、認証のトークンと組織のIDが要る。3つ以外のエージェントを使う人は、汎用のWebhookで自分の受け口に送ればよい。

説明書は、送り先にエラーを渡しても、そのエージェントがCloudflareのアカウントを調べる権限までは得ないと書く。関係するログやトレースまでエージェントに読ませたい時は、CloudflareのAPIのMCPサーバーを別につなぐ。エージェントが出した直しは、人が見てから反映する。送りが失敗した時、Cloudflareは3回まで渡し直す。

Claude Codeの予定タスク

Claude Code側で受けるのは、Claude Codeの説明書で「予定タスク」と呼ぶ機能で、前の名前がRoutineだ。決まった指示文を保存しておき、時刻やGitHubの出来事、外からのAPIの呼び出しで起こす。Cloudflareが使うのはこのAPIの呼び出しの口で、使えるのはPro、Max、Ultra、Team、Enterpriseのプランになる。APIの口を足すと、認証のトークンが一度だけ画面に出るので、その場で写してCloudflareの設定に入れる。

予定タスクはAnthropicのクラウドで動き、走るたびに選んだGitHubのリポジトリを複製し、直しは「claude/」で始まるブランチに置く。説明書自身も、監視の道具がエラーの回数の線を超えた時にAPIを呼び、Claudeがスタックトレースと最近のコミットを突き合わせ、直しの案を下書きのプルリクエストで出す使い方を例に挙げている。当番の人は、白紙から調べ始めるのではなく、そのプルリクエストを見ればよいという。指示文には、何を調べ、何ができたら終わりかを、自分で読んで分かる形で書いておく必要がある。

送る前に、渡す中身を確かめる

エラーの情報には、エラーの文、スタックトレース、リクエストの情報、ログ、アプリの文脈が入りうる。説明書は、送り先の権限と扱いの決まりを先に確かめ、秘密の値やトークンをログに入れないよう求めている。送り先のURLやWebhookの鍵、トークンは、認証情報として扱う必要がある。

編集部の見方

小さなチームで夜中のエラーに気づくのは、たいてい朝になってからだ。知らせがエージェントに届き、起きた時には調べた結果と直しの案がそろっていれば、最初の1時間が短くなる。ただ、エラーの情報には利用者のデータが混じりやすい。まずは回数の条件を高めにして1つの送り先で試し、何がエージェントに渡るかを確かめてから広げるのが無難だ。