# MCP サーバー

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

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

```
https://mcp.pocketalert.app/mcp
```

## 接続方法

認証はベアラートークンで行います。[API キー](https://pocketalert.app/account/apikeys)の API キーを `Authorization: Bearer <token>` の形式で送信します。

**Claude Desktop / Claude Code**

```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"
      }
    }
  }
}
```

**Native HTTP transport**

```json
{
  "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` パラメーターを受け付けます。そのため、エージェントは送信する通知を [重要度の高いアラート](https://info.pocketalert.app/features/priority-levels.md)にしたり、[承認用のアクションボタン](https://info.pocketalert.app/features/action-buttons.md)を付けたりできます。

## 設定しておくと便利な使い方

**長時間のジョブ。** マイグレーション、学習の実行、バッチ取り込みなどが完了したときに、エージェントが通知で知らせます。ターミナルを何度も確認する必要はありません。

**人の承認を挟むワークフロー。** エージェントに `create_message` を使わせ、取り返しのつかない操作を実行する前に `http` 型のアクションボタンを 2 つ送信させます。ロック画面から承認すると、エージェントが処理を続けます。

**自身の履歴の確認。** `list_messages` を呼び出せるエージェントであれば、転送作業をしなくても「夜中に何が壊れた？」といった質問に答えられます。

> **Warning: キーはスコープを絞る**
>
> MCP サーバーは、モデルに渡す権限そのものです。本番環境のスクリプトで使っている API キーを流用せず、MCP 専用の API キーを発行してください。そうすれば、エージェントのアクセスを取り消しても、他への影響はありません。

## 関連ページ

- [重要度](https://info.pocketalert.app/features/priority-levels.md) — `level` が配信されるアラートにどう影響するか
- [アクションボタン](https://info.pocketalert.app/features/action-buttons.md) — 通知からの承認ワークフロー
- [メッセージを作成](https://info.pocketalert.app/api/messages/create.md) — `create_message` に相当する REST API
