# 受け取る エージェントの作業が終わったとき にプッシュ通知

> AI エージェントや LLM の実行が完了したとき、承認が必要なとき、失敗したときにプッシュ通知でお知らせ。Pocket Alert は MCP の create_message ツールと、スマホに届くシンプルな HTTP POST に対応しています。

<!-- source: https://pocketalert.app/ja/use-cases/ai-agent-alerts -->

最終更新日:2026-08-11

長時間動作する LLM エージェントは、付きっきりで見ている必要はありません。作業が完了したとき、承認待ちで止まったとき、エラーで壊れたときに、スマホが振動して知らせます。だから安心して席を離れられます。

## 手を離しても通知が届く、3 つのステップ

1. **MCP か HTTP を選ぶ** — API キーを作成するか、コードを使わない方法として、お使いのクライアントに Pocket Alert MCP サーバーを追加します。
2. **完了時に送信** — create_message を呼び出すか、LangChain のコールバックやエージェントツールから title と message を POST します。
3. **席を離れる** — 失敗や承認依頼用に、エージェントごとに個別のアプリケーションを用意します。これで、エージェントが作業している間もデスクを離れられます。

## 無人で動くエージェントのために

経路は 2 つですが結果は同じです。エージェントが MCP ツールを呼ぶか、POST を 1 回送ると、スマホが振動します。

- **MCP サーバーを内蔵** — Claude Code、Claude Desktop、Cursor などの MCP クライアントは、create_message ツールを呼び出してプッシュ通知を送信します。
- **シンプルな HTTP にも対応** — MCP クライアントがない場合でも、メッセージ API への認証付き POST を 1 回行えば、どのエージェントやスクリプトからでも同じことができます。
- **Stop フックに対応** — Stop フックから通知を送れば、確認を忘れていても、エージェントの実行が終わったタイミングで通知されます。
- **メッセージにステータスを表示** — エージェントの状態と結果テキストをメッセージに含められるので、「承認が必要」という内容がひと目で分かります。
- **エージェントごとのチャネル** — エージェントやプロジェクトごとに個別のアプリケーションを作ると、リファクタリング用ボットと cron ジョブをそれぞれ別のチャネルで管理できます。
- **1 秒以内の配信** — プッシュ通知は 1 秒以内に届くので、長時間のジョブが終わったときや入力待ちで止まったときに、すぐに知らせてもらえます。

## エージェントをスマホに接続する

### 1. API キーを取得する

[API Keys](https://pocketalert.app/ja/account/apikeys) ページでキーを作成します。エージェントは `Token` ヘッダーでこのキーを送信します。

### 2. LangChain のコールバックから POST する（Python）

```
import requests
from langchain.callbacks.base import BaseCallbackHandler

class PocketAlert(BaseCallbackHandler):
    def on_agent_finish(self, finish, **kwargs):
        requests.post(
            "https://api.pocketalert.app/v1/messages",
            headers={"Token": "YOUR_API_KEY"},
            json={"title": "Agent finished", "message": finish.return_values["output"][:200]},
        )

agent.invoke({"input": task}, config={"callbacks": [PocketAlert()]})
```

### 3. エージェントが呼び出す OpenAI ツールとして実装する（Node）

```
async function notifyHuman({ title, message }) {
  await fetch("https://api.pocketalert.app/v1/messages", {
    method: "POST",
    headers: { Token: "YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({ title, message, level: "high" }),
  });
}
```

`notifyHuman` を関数／ツールとして公開すると、承認が必要になったときやエラーが発生したときに、エージェントがこれを呼び出せます。

### 4. コードを使わず MCP で行う

お使いのクライアントが MCP に対応している場合（Claude Code、Claude Desktop、Cursor など）、Pocket Alert MCP サーバーを追加すると、エージェントが `create_message` ツールを呼び出せます。手元でコードを書く必要はありません。

ターゲティング、アプリケーション、その他の MCP ツールについては、[ドキュメント](https://info.pocketalert.app/getting-started.html)をご覧ください。

## よくある質問

### エージェントからプッシュ通知を送るにはどうすればよいですか？

方法は 2 つあります。Claude Code、Claude Desktop、Cursor などの MCP クライアントは create_message ツールを呼び出し、プッシュ通知がスマホに届きます。それ以外の場合は、メッセージ API に対して HTTP POST を 1 回送るだけです。実行終了時の Stop フックがよく使われるトリガーです。

### コードを書かずに MCP で送るにはどうすればよいですか？

お使いのクライアントに Pocket Alert MCP サーバーを追加し、title と message を指定して create_message を呼び出してください。コードも curl も不要です。エージェントがファイルやスクリーンショットを送る場合は、create_message_with_attachment も使えます。

### 失敗と完了を一目で見分けられますか？

エージェントごとに個別のアプリケーションを用意すると、リファクタリング用ボットからの「承認が必要」と、夜間パイプラインからの「タスク完了」が別々のチャネルに届きます。承認依頼や失敗が一目で分かるように、タイトルを工夫してください。

### プロジェクトごとのエージェントを分けて管理するにはどうすればよいですか？

エージェントやプロジェクトごとに個別のアプリケーションを用意してください。リファクタリング用ボットと夜間データパイプラインからの通知は別々のチャネルに届くので、本文を読まなくても、どのジョブから通知されたかが分かります。

### スマホを確認する価値があるほど速いですか？

配信は 1 秒以内に完了します。コーディングエージェントが 15 分間作業している間にコーヒーを淹れに行っても、席に戻る前に通知が届きます。

### 完了通知は静かに、失敗通知は目立たせるにはどうすればよいですか？

メッセージごとに重要度を指定できます。「タスク完了」のような定型の通知は silent に設定すると、音や振動は鳴りませんが履歴には残ります。失敗や承認依頼は high に設定すると、iPhone の集中モードを突破する時間重視の通知として届きます。MCP の create_message ツールにも同じ level フィールドがあるため、エージェントがメッセージごとに音量を選べます。
