無人で動くエージェントのために
経路は 2 つですが結果は同じです。エージェントが MCP ツールを呼ぶか、POST を 1 回送ると、スマホが振動します。
MCP サーバーを内蔵
Claude Code、Claude Desktop、Cursor などの MCP クライアントは、create_message ツールを呼び出してプッシュ通知を送信します。
シンプルな HTTP にも対応
MCP クライアントがない場合でも、メッセージ API への認証付き POST を 1 回行えば、どのエージェントやスクリプトからでも同じことができます。
Stop フックに対応
Stop フックから通知を送れば、確認を忘れていても、エージェントの実行が終わったタイミングで通知されます。
メッセージにステータスを表示
エージェントの状態と結果テキストをメッセージに含められるので、「承認が必要」という内容がひと目で分かります。
エージェントごとのチャネル
エージェントやプロジェクトごとに個別のアプリケーションを作ると、リファクタリング用ボットと cron ジョブをそれぞれ別のチャネルで管理できます。
1 秒以内の配信
プッシュ通知は 1 秒以内に届くので、長時間のジョブが終わったときや入力待ちで止まったときに、すぐに知らせてもらえます。
手を離しても通知が届く、3 つのステップ
MCP か HTTP を選ぶ
API キーを作成するか、コードを使わない方法として、お使いのクライアントに Pocket Alert MCP サーバーを追加します。
完了時に送信
create_message を呼び出すか、LangChain のコールバックやエージェントツールから title と message を POST します。
席を離れる
失敗や承認依頼用に、エージェントごとに個別のアプリケーションを用意します。これで、エージェントが作業している間もデスクを離れられます。
エージェントをスマホに接続する
1. API キーを取得する
API Keys ページでキーを作成します。エージェントは 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 ツールについては、ドキュメントをご覧ください。
よくある質問
方法は 2 つあります。Claude Code、Claude Desktop、Cursor などの MCP クライアントは create_message ツールを呼び出し、プッシュ通知がスマホに届きます。それ以外の場合は、メッセージ API に対して HTTP POST を 1 回送るだけです。実行終了時の Stop フックがよく使われるトリガーです。
お使いのクライアントに Pocket Alert MCP サーバーを追加し、title と message を指定して create_message を呼び出してください。コードも curl も不要です。エージェントがファイルやスクリーンショットを送る場合は、create_message_with_attachment も使えます。
エージェントごとに個別のアプリケーションを用意すると、リファクタリング用ボットからの「承認が必要」と、夜間パイプラインからの「タスク完了」が別々のチャネルに届きます。承認依頼や失敗が一目で分かるように、タイトルを工夫してください。
エージェントやプロジェクトごとに個別のアプリケーションを用意してください。リファクタリング用ボットと夜間データパイプラインからの通知は別々のチャネルに届くので、本文を読まなくても、どのジョブから通知されたかが分かります。
配信は 1 秒以内に完了します。コーディングエージェントが 15 分間作業している間にコーヒーを淹れに行っても、席に戻る前に通知が届きます。
メッセージごとに重要度を指定できます。「タスク完了」のような定型の通知は silent に設定すると、音や振動は鳴りませんが履歴には残ります。失敗や承認依頼は high に設定すると、iPhone の集中モードを突破する時間重視の通知として届きます。MCP の create_message ツールにも同じ level フィールドがあるため、エージェントがメッセージごとに音量を選べます。