Support Inbox Agent

support-inbox-agent

カスタマーサポートの受信トレイの一次対応を行う Claude Code スキルです。新しい会話を読み、分類し、エラートラッカーとコードベースで実際の問題を調査してから、メールクライアントに返信の下書きを作成します。人間が確認して送信するためのものです。

送信は一切行いません。常に下書きのみです。

SiteSpeak の自社サポート受信トレイで、毎朝午前6時に実行している本番スキルから抜き出したものです。

詳しい記事はこちら：Claude Code と MCP でカスタマーサポートの一次対応を自動化する

仕組み

1つの Markdown ファイル（SKILL.md）でワークフローを説明します。スケジュール設定された claude -p の実行が、4つの MCP サーバーを使ってこれを実行します。

役割	サーバーの例	用途
サポート受信トレイ	SiteSpeak	スレッドの一覧表示、会話の読み取り、リードの取得、アーカイブ
エラートラッカー	Sentry	バグ報告を実際の本番環境のエラーと照合
アプリモニター（任意）	Nightwatch	同様の確認を行う第2の情報源
メールクライアント	Superhuman	既存スレッドの検索、下書きの作成

どれもご自身の環境に合わせて置き換えられます。このスキルはベンダー名ではなくツール名を基準に記述されています。ツール名のプレースホルダーは SKILL.md の冒頭に記載されています。

各実行では、次の処理を行います。

1. 受信トレイの未解決スレッドを一覧表示し、前回の実行以降に動きのあったものを残します（JSON の状態ファイルにより、実行を冪等にします）
2. 訪問者自身のメッセージを読み、スレッドを「緊急／見込み客／ノイズ」に分類します
3. 下書きの作成前に調査します。バグ報告についてはエラートラッカーと関連コードを確認し、操作方法の回答についてはドキュメントで正しさを検証します
4. そのメールアドレスからの既存スレッドがないかメールを検索します（ボットとのチャット後、数分でサポートにメールする人もいます）。その結果に応じてスキップするか、既存スレッド内で返信します
5. メールクライアントに下書きを作成します
6. スレッドをアーカイブし、処理結果を状態ファイルに記録します
7. スレッドごとに1行で要約し、下書きへのリンクを表示します

重要な2つのルール

SKILL.md からの引用です。原文のまま残す価値があります。

推測してはいけません。下書き内のすべての主張は、このセッション中に検証するか、下書きから除外してください。

送信ツールは絶対に呼び出してはいけません。常に下書きのみです。

1つ目のルールにより、確信に満ちた誤情報が顧客へのメールに含まれるのを防ぎます。2つ目のルールにより、返信が顧客に届くのは、人間が送信ボタンを押した場合だけになります。

要件

• Claude Code（または MCP サーバーとスキルファイルを読み込む任意のエージェント CLI）
• MCP サーバーを備えたサポートツール
• 下書きに対応した MCP サーバーを備えるメールクライアントまたはメール API
• 任意：調査手順で使用するエラートラッカーの MCP サーバー
• スケジューラー：launchd（macOS）または cron（Linux）。例は examples/ を参照してください

クイックスタート（SiteSpeak）

SKILL.md のツール名の例は SiteSpeak MCP の実際の名称なので、この方法では変更は不要です。

1. Claude Code で /plugin marketplace add sitespeakai/sitespeak-claude-plugin を実行します
2. 続けて /plugin install sitespeak-chatbot-manager@sitespeak-plugins を実行し、API トークンで認証します
3. SKILL.md を ~/.claude/skills/support-inbox-agent/SKILL.md にコピーし、冒頭のプレースホルダーを入力します（チャットボット ID はダッシュボードの URL にあります）
4. メールクライアントの MCP サーバーを接続し、必要に応じてエラートラッカーの MCP サーバーも接続します
5. 手動でテストします：claude -p "/support-inbox-agent"
6. スケジュールを設定します：examples/run.sh と examples/launchd.plist を参照してください

別のサポートツールを使う場合

スレッドの一覧表示、会話の読み取り、訪問者のメールアドレスの取得、スレッドのアーカイブができるサポート MCP であれば、どれでも使えます。上記の手順で SKILL.md をコピーし、ツール名の例を各ベンダーに対応する名前に置き換えて、同じプレースホルダーを入力してください。

どちらの場合も、まずはトリアージのみで始めて（下書き作成の手順は削除してください）、1週間分の出力を確認してから下書き作成を許可してください。送信は今後もずっと手動で行ってください。

状態

state/processed.json は、訪問者 ID を { processed_at, action, reason?, draft_id? } に対応付けます。下書きしたスレッドとスキップしたスレッドの両方が記録されるため、再実行しても二重に処理されたり、下書きが重複して作成されたりすることはありません。処理済みの訪問者が再びメッセージを送信した場合、このスキルは 2 つ目の下書きを作成する代わりに、既存の下書きを更新します。

ライセンス

MIT