Claude Code×Sentryで、障害の一次調査と報告を速くする｜エラーの読み取り、原因の仮説、顧客への第一報と、人が決める線

この記事は、Claude Code×Sentryで、顧客サイトの障害の一次調査と第一報を速くし、保守の工程として組み込む方法を扱います。

「エラーが出ています」の連絡から、半日が消えていないか

「お問い合わせフォームで、エラーが出たとお客様から連絡がありました」

ここから、ログを探し、再現を試し、原因の見当をつけ、顧客に返事を書く。
慣れたエンジニアでも、最初の連絡を出すまでに時間がかかります。

顧客が待っているのは、修正の完了より先に「状況が分かっている」という連絡です。
一次調査と第一報が速い会社は、同じ障害でも信頼を落としません。

障害の一次調査とは、エラーの記録から「何が・いつから・どれくらい」起きているかを確かめ、原因の仮説と次の手を決めるまでの工程である

黒字化の外科医です。SentryとClaude Codeで、障害の一次調査を短くする手順を解剖します。

この工程を仕組みにする理由は、三つあります。

第一に、Sentryには、エラーがまとまって残っているから。
Sentryのアラートは、条件に合ったときに通知を送り、チケットを作り、Webhookを呼ぶといった動作ができます（Sentry公式ドキュメント、2026年11月2日確認）。

第二に、Claude CodeからSentryの情報を読めるから。
Sentryは、MCPサーバーを公開しています。Claude Codeでは、claude mcp add --transport http sentry https://mcp.sentry.dev/mcp で追加し、/mcp からブラウザでSentryにログインして使います。接続はすべてOAuthで、組織やプロジェクトに範囲を絞った接続先も用意されています（Sentry公式ドキュメント・Claude Code公式ドキュメント、2026年11月2日確認）。

第三に、エラーの記録とコードを、同じ場所で突き合わせられるから。
Sentryの手引きでは、課題の一覧、スタックトレース、関連するログ、Seerによる原因の分析を読み、リポジトリの該当箇所を探して修正案を出す流れが紹介されています。同じ手引きは、差分を確かめてから受け入れること、Seerの見立てをスタックトレースとコードの知識で確かめることを求めています（Sentry公式ドキュメント、2026年11月2日確認）。

Sentryの情報をAIに渡す前に、顧客と決めること

Sentryの手引きは、MCPで取得したSentryのデータが、Claudeとの会話の一部になると書いています（Sentry公式ドキュメント、2026年11月2日確認）。
つまり、エラーに含まれる情報が、AIの処理に流れます。

• 顧客のSentryを使うなら、誰の名義のアカウントで、どこまでの権限でつなぐかを決める
• 接続は、可能な範囲で顧客のプロジェクトに絞る
• エラーに個人情報が入らない設定になっているかを確かめる（Sentryには、初期設定で有効なサーバー側のデータの除去機能があります）
• AIに情報を渡すことを、契約に書き、顧客の同意を取る

なお私は弁護士ではありません。実務の指針として読み、個別の判断は専門家や公的な窓口に確認してください。

▶ Claude CodeのMCPで社内ツールをつなぐ前に──信頼できるサーバーか、どこまで許すか、どの情報が流れるかの点検表

今すぐ試せる：Sentryのエラーから一次調査メモを作るプロンプト

Sentryの〔プロジェクト名〕で、直近〔24時間〕に増えたエラーを調べ、一次調査メモを作ってください。

【やること】
1. 件数が多い順に、上位〔3件〕の課題を挙げる。
2. 各課題について、最初に起きた日時、件数、影響を受けた利用者の数を書く。
3. 最新のイベントのスタックトレースから、関係しそうなファイルと行を、このリポジトリで探す。
4. 原因の仮説を、確からしい順に2つまで書く。根拠のないものは「推測」と書く。
5. 顧客への第一報に入れる事実だけを、3行で書く。

【やらないこと】
・コードの修正、コミット、本番への反映
・Sentryの課題の状態の変更

一次調査工場：通知から第一報までの型

一次調査の手順

① 通知を受ける（Sentryのアラート／顧客からの連絡）
② Claude Codeで一次調査メモを作る（上のプロンプト）
③ 人が確かめる
　□ 件数と期間は、Sentryの画面と合っているか
　□ 仮説は、スタックトレースとコードで説明がつくか
　□ 影響の範囲（どの画面、どの利用者）は言い過ぎていないか
④ 第一報を送る（人が送る）
⑤ 修正の方針と見積もりを決める（人が決める）

顧客への第一報の文例

〇〇様

〇〇の〇〇です。〔お問い合わせフォーム〕のエラーについて、現時点の状況をご報告します。

・確認した事実：〔〇月〇日〇時ごろから、送信時のエラーが〇件記録されています〕
・影響の範囲：〔フォームの送信。ほかのページは表示できています〕
・現在の対応：原因を調べています。次のご報告は〔〇時ごろ〕にお送りします。

原因が分かり次第、修正の方針とあわせてご連絡します。

原因の仮説は、第一報には書きません。確かめる前の仮説を書くと、外れたときに信頼を落とします。

時間の計算例

（例）時間単価8,000円で計算

一次調査と第一報：1件90分 → 40分（Claude Codeで下調べ）
月4件の障害の場合：短くなる時間 50分 × 4件 ＝ 200分
200分 ÷ 60 × 8,000円 ≒ 26,700円分の時間

（数字はすべて例です。自社の障害の記録で測ってください）

障害の対応で、AIに任せるのは「調べる・考える・書く」までです。この線引きは、こちらで扱っています。

▶ サイトの障害対応、AIで速くするのは「調べる・考える・書く」まで──ログの読み取り、原因の仮説、お客様への報告文の作り方と、AIに任せてはいけない4つの判断

構造的なリスク

逆説を指摘しておきます。

一次調査が速くなると、「すぐ直せるはず」と顧客の期待が上がります。
保守の契約に、一次調査の範囲と、修正は別の見積もりになることを、先に書いておいてください。

もう一つは、AIの仮説を、事実のように扱う危うさです。
仮説は、人がコードと記録で確かめるまで、仮説のままです。

よくあるQ&A

Q. 顧客がSentryを使っていない。

導入から提案できます。ただし、エラーに何を送るか、誰がアカウントを持つか、費用は誰が払うかを、先に決めてください。

Q. 修正まで、AIに任せてよいか。

修正案を出させるのはかまいません。差分を人が読み、検証環境で確かめてから反映します。

Q. 一次調査は、月額に含めるべきか。

月の件数と時間に上限を決めて含めるのがおすすめです。上限を超えた分と修正は、都度のお見積りにします。

最後に

障害で顧客が待っているのは、まず「状況が分かっている」という連絡です。

エラーの記録をAIで読み、事実だけを先に伝え、判断を人に残した会社だけが、障害の日にも信頼を積み上げられるのです。

これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。

#Web制作会社 #ClaudeCode #Sentry #障害対応 #保守契約 #MCP #制作会社経営 #中小企業 #エラー監視 #AI活用