AnyHook

anyhook-mcp

AI エージェントが Webhook を確認し、イベントを調査し、配信を再送し、署名付きペイロードをモックし、アプリを作成できる MCP サーバーです。45-second AI handler ワークフロー向けに設計されています。

Apache 2.0 · npm i -g anyhook-mcp

---

すでに AnyHook アカウントをお持ちですか？

何も実行せずに、ホストされたエンドポイントへ接続できます。https://anyhook.net/mcp を Claude Code、claude.ai、Codex、または VS Code に追加して、ブラウザーからサインインしてください。キーを コピーする必要はありません。各アプリの手順はこちらです：https://anyhook.net/mcp。

アカウントをまだお持ちでない場合（ローカルモード）

API キーなしですぐに始められます：

claude mcp add anyhook -- npx -y anyhook-mcp

次に、エージェントに anyhook_quickstart の実行を依頼してください。無料のリレー エンドポイントと API キーがすぐに作成され（サインアップ不要）、この MCP セッションは自動的に接続されます。 すべてのアカウントツール（イベント、再送、アプリ）がすぐに使えます。応答には、 エンドポイントを永続的に保持するための claim_url が含まれます。請求されない場合は、7 日後に期限切れになります。 既存のアカウントではなく、新しいエンドポイントが作成されます。

できること

この MCP サーバーを Claude Desktop／Cursor／Claude Code に追加すると、エージェントは次の操作ができます：

• anyhook_apps_list：AnyHook アカウント内のすべてのアプリと、それぞれの受信 URL を表示します
• anyhook_apps_create：プロンプトから新しいアプリを作成します
• anyhook_connect：Stripe キーまたは GitHub トークンを渡すと、プロバイダーに Webhook が登録され、最初のイベントから署名が検証されます（キーは保存されません）
• anyhook_events：最近のイベントを一覧表示し、アプリ／ステータスで絞り込みます
• anyhook_inspect：単一のイベントのヘッダー、本文、署名ステータスを取得します
• anyhook_replay：保存済みイベントを送信先に再送します（月間クォータの対象外ですが、1 日あたりの再送上限があります。クォータ保留中のイベントは新規イベントとしてカウントされます）
• anyhook_undelivered：送信先に一度も届かなかったイベントを一覧表示します
• anyhook_replay_failed：アプリの失敗したイベントをすべて一括再送します
• anyhook_mock：ローカルのハンドラーをテストするため、署名付きの Stripe／GitHub／Slack ペイロードを生成します
• anyhook_verify：シークレットを使って、受信した署名を検証します
• anyhook_providers：AnyHook がサポートするすべての Webhook プロバイダーを一覧表示します

アプリの受信 URL は Webhook の POST を受け付けるほか、プロバイダーのセットアップ時のハンドシェイクにも自動で応答します。Meta の hub.mode=subscribe を含む GET には、アプリを設定する前でも hub.challenge がそのまま返されるため、 最初に Meta App Dashboard で URL を登録し、その後で接続できます。

2 つのモードがあります：

モード	条件	利用できる機能
remote	ANYHOOK_API_KEY が設定されている	上記のすべてのツールを、AnyHook アカウントに対してライブで利用できます
local	API キーなし	プロバイダーツールキット（mock／verify／providers）と、イベントをシミュレートできるインメモリストアを利用できます。サインアップ前のお試しに便利です。

---

クイックスタート

npm install -g anyhook-mcp
# or run without installing
npx -y anyhook-mcp

API キーは https://anyhook.net/dashboard/settings から取得してください。キーは ahk_live_ で始まります。

---

Claude Desktop にインストールする

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します：

{
  "mcpServers": {
    "anyhook": {
      "command": "npx",
      "args": ["-y", "anyhook-mcp"],
      "env": {
        "ANYHOOK_API_KEY": "ahk_live_xxxxxxxx"
      }
    }
  }
}

Claude Desktop を再起動します。ツールはハンマーアイコンの下に表示されます。

---

Cursor にインストールする

Settings → MCP → Add new MCP server を開きます。または、~/.cursor/mcp.json を編集します：

{
  "mcpServers": {
    "anyhook": {
      "command": "npx",
      "args": ["-y", "anyhook-mcp"],
      "env": {
        "ANYHOOK_API_KEY": "ahk_live_xxxxxxxx"
      }
    }
  }
}

---

Claude Code にインストールする

claude mcp add anyhook -e ANYHOOK_API_KEY=ahk_live_xxxxxxxx -- npx -y anyhook-mcp

または、同じ mcpServers エントリーをプロジェクトの .mcp.json に追加します。

---

リモートエンドポイント（ローカルプロセス不要）

同じサーバーが https://anyhook.net/mcp でホストされています（ストリーミング可能な HTTP、 ステートレス）。Claude Code、claude.ai、Codex、VS Code はブラウザーから OAuth でサインインできるため、 キーをコピーする必要はありません。各アプリの手順は https://anyhook.net/mcp にあります。 それ以外のクライアントは、ダッシュボードで取得したキーを使って Authorization: Bearer ahk_live_... を送信します：

{ "mcpServers": { "anyhook": { "url": "https://anyhook.net/mcp", "headers": { "Authorization": "Bearer ahk_live_..." } } } }

エンドポイントには anyhook_quickstart がありません。このツールはローカルモードでのみ利用できます。

---

ローカル専用モード（アカウント不要）

環境変数を省略します：

{
  "mcpServers": {
    "anyhook": {
      "command": "npx",
      "args": ["-y", "anyhook-mcp"]
    }
  }
}

エージェントは anyhook_mock、anyhook_verify、anyhook_providers、anyhook_simulate、anyhook_events（メモリストアに対して）、anyhook_inspect（メモリストアに対して）を利用できます。ローカル開発中に「署名済みの Stripe payment_intent.succeeded を生成して localhost:3000 に POST して」といったフローで便利です。

---

会話の例

失敗するエンドポイントのトリアージ：

「過去 1 時間の stripe-prod アプリの未配信イベントを表示してから、再送してください。」

エージェントは anyhook_undelivered を呼び出し、続いて各イベントに対して anyhook_replay を呼び出し、応答をその場で表示します。

新しい連携用のアプリを作成：

「replicate-video-jobs という名前の新しい AnyHook アプリを作成し、ソースを generic にして、https://my-app.vercel.app/api/replicate-callback を送信先に設定してください。」

anyhook_apps_create を呼び出し、Replicate に貼り付ける受信 URL を返します。

署名エラーの確認：

「AnyHook が拒否している Stripe からの受信ペイロードです。シークレット whsec_xxx を使って署名を手動で検証してください。」

指定されたヘッダー、ボディ、シークレットを使って anyhook_verify を呼び出し、失敗理由とともに valid: false を返します。

ローカルテスト用の Webhook をモック：

「Stripe の payment_intent.succeeded イベントを生成して、http://localhost:3000/api/webhooks/stripe に POST してください。」

targetUrl を設定して anyhook_mock を呼び出し、送信したリクエストとハンドラーの応答を返します。

---

環境変数

変数	必須	デフォルト	用途
ANYHOOK_API_KEY	リモートモードの場合	-	https://anyhook.net/dashboard/settings から取得した ahk_live_*
ANYHOOK_API_BASE	いいえ	https://anyhook.net	セルフホスト型 AnyHook デプロイ用の上書き設定

---

これが興味深い理由

AI エージェントは、自分たちの Webhook インフラストラクチャを確認できませんでした。連携コードは書けても、本番環境でイベントに問題が起きると、それを確認できず、何が起きたかは人間が伝える必要があります。この MCP サーバーを使えば、Claude / Cursor は実際のイベントログを読み取り、配信を再送し、署名エラーをデバッグし、新しいアプリを立ち上げることもできます。Webhook コードの作成から運用までを一貫して行えるようになります。

---

ライセンス

Apache-2.0 © AnyHook