コンテンツへスキップ

MCP サーバー ​

Pocket Alert は Model Context Protocol に対応しているため、AI エージェントは通常のツール呼び出しとして、プッシュ通知の送信、メッセージ履歴の読み取り、配信統計の確認を行えます。

実際の使い方はこうです。エージェントが長時間のジョブを開始し、予測できないタイミングで完了したら、ターミナルを確認しに行かなくてもスマホに通知を送ります。

https://mcp.pocketalert.app/mcp

接続方法 ​

認証はベアラートークンで行います。API キーの API キーを Authorization: Bearer <token> の形式で送信します。

json
{
  "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"
      }
    }
  }
}
json
{
  "mcpServers": {
    "pocketalert": {
      "type": "http",
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

設定後にクライアントを再起動し、ツール一覧を表示するよう依頼してください。pocketalert が表示されていれば接続できています。

利用可能なツール ​

ツール機能
list_applicationsアプリケーションの一覧を取得
get_applicationTID を指定して 1 件のアプリケーションを取得
list_devices登録済みデバイスの一覧を取得
get_deviceTID を指定して 1 件のデバイスを取得
list_messagesメッセージ履歴を読み取り
get_messageTID を指定して 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 キーを発行してください。そうすれば、エージェントのアクセスを取り消しても、他への影響はありません。

関連ページ ​

Pocket Alert ドキュメント