MCP サーバー
Pocket Alert は Model Context Protocol に対応しているため、AI エージェントは通常のツール呼び出しとして、プッシュ通知の送信、メッセージ履歴の読み取り、配信統計の確認を行えます。
実際の使い方はこうです。エージェントが長時間のジョブを開始し、予測できないタイミングで完了したら、ターミナルを確認しに行かなくてもスマホに通知を送ります。
https://mcp.pocketalert.app/mcp接続方法
認証はベアラートークンで行います。API キーの API キーを Authorization: Bearer <token> の形式で送信します。
{
"mcpServers": {
"pocketalert": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.pocketalert.app/mcp",
"--header",
"Authorization: Bearer ${POCKETALERT_API_TOKEN}"
],
"env": {
"POCKETALERT_API_TOKEN": "your-api-key"
}
}
}
}{
"mcpServers": {
"pocketalert": {
"type": "http",
"url": "https://mcp.pocketalert.app/mcp",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
}設定後にクライアントを再起動し、ツール一覧を表示するよう依頼してください。pocketalert が表示されていれば接続できています。
利用可能なツール
| ツール | 機能 |
|---|---|
list_applications | アプリケーションの一覧を取得 |
get_application | TID を指定して 1 件のアプリケーションを取得 |
list_devices | 登録済みデバイスの一覧を取得 |
get_device | TID を指定して 1 件のデバイスを取得 |
list_messages | メッセージ履歴を読み取り |
get_message | TID を指定して 1 件のメッセージを取得 |
create_message | プッシュ通知を送信 |
create_message_with_attachment | 画像を添付したプッシュ通知を送信 |
delete_message | メッセージを削除 |
get_message_stats | 配信統計を取得 |
create_message は REST API と同じ level および actions パラメーターを受け付けます。そのため、エージェントは送信する通知を 重要度の高いアラートにしたり、承認用のアクションボタンを付けたりできます。
設定しておくと便利な使い方
長時間のジョブ。 マイグレーション、学習の実行、バッチ取り込みなどが完了したときに、エージェントが通知で知らせます。ターミナルを何度も確認する必要はありません。
人の承認を挟むワークフロー。 エージェントに create_message を使わせ、取り返しのつかない操作を実行する前に http 型のアクションボタンを 2 つ送信させます。ロック画面から承認すると、エージェントが処理を続けます。
自身の履歴の確認。 list_messages を呼び出せるエージェントであれば、転送作業をしなくても「夜中に何が壊れた?」といった質問に答えられます。
キーはスコープを絞る
MCP サーバーは、モデルに渡す権限そのものです。本番環境のスクリプトで使っている API キーを流用せず、MCP 専用の API キーを発行してください。そうすれば、エージェントのアクセスを取り消しても、他への影響はありません。