# MCP

> AI エージェント（Claude Code・Claude Desktop・Cursor など）から Webhook Admin を操作するための、MCP サーバーの接続方法です。

Source: https://webhookadmin.com/docs/mcp/

MCP の URL を追加してブラウザでログインすると、AI エージェントから組織・プロジェクト・API キーの作成、エンドポイントの登録、失敗した配信の再送信、プランの変更まで行えます。

## 接続先

- **URL**: `https://api.webhookadmin.com/mcp`
- **方式**: Streamable HTTP
- **認証**: ブラウザでのログイン（OAuth）

## Claude Code

```bash
claude mcp add --transport http webhook-admin https://api.webhookadmin.com/mcp
```

Claude Code で `/mcp` を開き、webhook-admin の「Authenticate」を選択するとブラウザが開きます。ログインして「許可する」を押すと、利用を開始できます。

## Claude Desktop

Settings › Connectors › Add custom connector に `https://api.webhookadmin.com/mcp` を入力し、「Connect」からブラウザでログインします。

## Cursor

プロジェクトの `.cursor/mcp.json`（すべてのプロジェクトで使う場合は `~/.cursor/mcp.json`）に追加し、Settings › MCP の「Login」からブラウザでログインします。

```
{
  "mcpServers": {
    "webhook-admin": { "url": "https://api.webhookadmin.com/mcp" }
  }
}
```

## ログインと許可

ブラウザでは管理画面と同じ方法（メール・GitHub・Google・パスキー・SSO）でログインし、「Webhook Admin へのアクセスを許可しますか」で「許可する」を押します。許可したアプリはアカウント設定の「接続中のアプリ」に表示され、そこからアクセスを取り消せます。

アカウントは管理画面で作成します。アカウントをお持ちでない場合は、[https://app.webhookadmin.com/signup](https://app.webhookadmin.com/signup) で登録してから MCP の URL を追加してください。

## ツール

| ツール | 説明 | 必要な役割（上位の役割でも可） |
| --- | --- | --- |
| `whoami`・`list_organizations` | ログイン中のユーザーと組織 | — |
| `create_organization` | 組織の作成 | — |
| `list_projects`・`create_project` | プロジェクトの一覧・作成（本番環境とテスト環境が作成されます） | admin |
| `list_environments` | 環境の一覧 | viewer |
| `create_api_key`・`list_api_keys`・`revoke_api_key` | API キーの作成・一覧・失効 | developer |
| `list_members`・`invite_member` | メンバーの一覧・招待 | admin |
| `list_event_types`・`create_event_type` | イベントタイプの一覧・登録 | developer |
| `list_alert_rules`・`create_alert_rule`・`update_alert_conditions` | アラート（Slack・Teams・Chatwork・メール・Webhook）と通知条件 | admin |
| `get_usage`・`get_plan` | 今月の配信数・月間上限・超過分、プラン | viewer |
| `create_checkout`・`change_plan`・`get_billing_portal` | 有料プランの申し込み・プランの変更・請求の管理 | owner |

環境内のツールは、`list_environments` で取得した `environment_id` を指定して呼び出します。参照のみのツールは viewer、それ以外は developer 以上で利用できます。CI や定期実行の処理からは、MCP ではなく API キーで公開 API・SDK を呼び出してください。

| ツール | 説明 | 必要な役割（上位の役割でも可） |
| --- | --- | --- |
| `list_consumers` | 顧客アカウントの一覧 | viewer |
| `create_consumer` | 顧客アカウントの作成 | developer |
| `list_endpoints` | エンドポイントの一覧 | viewer |
| `create_endpoint` | エンドポイントの作成 | developer |
| `update_endpoint` | エンドポイントの更新（一時停止・再開・再送信ポリシー・互換署名・配信順序） | developer |
| `list_messages` | メッセージの一覧（ステータス・イベントタイプ・顧客アカウントで絞り込み。エンドポイントが無いものは `no_endpoint`） | viewer |
| `list_failed_deliveries` | 失敗した配信の一覧 | viewer |
| `retry_delivery` | 配信の再送信 | developer |
| `recover_endpoint` | エンドポイント単位の一括再送信 | developer |
| `get_recovery` | 一括再送信の進捗 | viewer |
| `send_test` | エンドポイントへのテスト送信 | developer |
| `create_portal_link` | 顧客ポータルのリンクの作成 | developer |
| `list_sources`・`list_source_requests` | ソースと受信ログの一覧 | viewer |
| `create_source`・`update_source`・`delete_source` | ソースの作成・更新（一時停止・再開・署名シークレットの登録）・削除 | developer |
| `reprocess_source_request` | 拒否したリクエストの再処理 | developer |

`revoke_api_key` は `confirm: true` を付けるまで実行せず、失効対象のキーを返します。`change_plan` は、変更後の月額料金・本日の請求見込み額と管理画面の URL を返します。プランの変更は、利用者が管理画面で確定します。