Hooklistener

Hooklistener MCP サーバー

AI コーディングエージェントがエンドツーエンドで Webhook をテストできるホスト型 MCP サーバーです。公開 Webhook URL を作成し、Webhook の到着を待ち、署名を検証して、localhost に再送できます。同じサーバーで、メール受信トレイ、WebSocket／Socket.IO／MQTT／SSE エンドポイント、localhost トンネル、稼働時間モニターにも対応しています。

• エンドポイント： https://app.hooklistener.com/api/mcp
• トランスポート： Streamable HTTP。インストールやローカルでの実行は不要です。
• 認証： PKCE と動的クライアント登録に対応した OAuth 2.1 を使用します。クライアントは full_access または read_only を要求します。OAuth に対応していないクライアントでは、Hooklistener API キー（hklst_…）を Bearer トークンとして使用することもできます。
• ツール： 7 つのツールセットに、合計 67 個あります。新しいワークスペースでは 26 個が表示されます（すべての Webhook ツールと、その他の各製品を開始するツール）。その製品を使うと、対応するツールセットが表示されます。すべて表示するには、x-hooklistener-toolsets: all を送信してください。
• プラン： Free を含むすべてのプランで利用できます。

このリポジトリには、セットアップ手順と MCP Registry のエントリー（server.json）が含まれています。サーバー自体は Hooklistener が運用しています。

クライアントを接続する

Claude Code

claude mcp add --transport http hooklistener https://app.hooklistener.com/api/mcp

次に、Claude Code で /mcp を実行し、hooklistener を選択してブラウザーでサインインします。詳細ガイド

Codex

codex mcp add hooklistener \
  --url https://app.hooklistener.com/api/mcp \
  --oauth-resource https://app.hooklistener.com/api/mcp
codex mcp login hooklistener --scopes full_access   # or read_only

詳細ガイド

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "hooklistener": { "url": "https://app.hooklistener.com/api/mcp" }
  }
}

詳細ガイド

VS Code（GitHub Copilot）

.vscode/mcp.json：

{
  "servers": {
    "hooklistener": { "type": "http", "url": "https://app.hooklistener.com/api/mcp" }
  }
}

詳細ガイド

Claude.ai と Claude Desktop

「Customize」→「Connectors」→「+」→「Add custom connector」の順に選択し、https://app.hooklistener.com/api/mcp を貼り付けて、「Add」→「Connect」を選択します。詳細ガイド

Cline

Cline はリモートサーバー向けの Bearer トークンヘッダーをドキュメント化しているため、Hooklistener API キーを使用します（有料プランで利用可能。Organization Settings → API Keys で作成できます）。cline_mcp_settings.json に次のように記述します。

{
  "mcpServers": {
    "hooklistener": {
      "type": "streamableHttp",
      "url": "https://app.hooklistener.com/api/mcp",
      "headers": { "Authorization": "Bearer hklst_your_api_key" }
    }
  }
}

サーバーのインストールをエージェントに任せる場合は、llms-install.md を参照してください。

その他のクライアント

手順ガイド：ChatGPT · Gemini CLI · Windsurf · Zed · OpenCode · Grok (xAI API)

Streamable HTTP に対応する MCP クライアントであれば、上記のエンドポイントを使って接続できます。

エージェントでできること

カテゴリ	例
エンドポイントのデバッグ	create_endpoint、get_endpoint、list_endpoint_anomalies、set_endpoint_alerts
キャプチャしたリクエスト	wait_for_request、list_requests（一覧表示または検索）、get_request、diagnose_request、investigate_request_retries
検証、比較、再送	verify_request_signature（Stripe、GitHub、Slack）、validate_request（JSON Schema）、diff_requests、replay_request（再送または転送。本文を編集して再署名できます）
モックレスポンス	create_response_rule、test_response_rules
リクエストスレッド	set_thread_rule、list_request_threads
再送ケースとスイート	save_request_case、run_endpoint_cases、wait_for_case_run
リアルタイムエンドポイント	create_realtime_endpoint（WebSocket、Socket.IO、MQTT、SSE）、wait_for_realtime_message、send_realtime_message
メール受信トレイ	create_inbox、wait_for_email、get_email
localhost トンネル	plan_tunnel_action、replay_tunnel_capture
稼働時間モニター	create_monitor、get_monitor_status
シークレットとタスク	create_secret、cancel_task

すべてのツールにはタイトルと、読み取り専用／破壊的操作の注釈があります。完全なリファレンス：docs.hooklistener.com/mcp/available-tools

プロンプトの例

• 「Stripe 用の Hooklistener エンドポイントを作成し、テスト用のチェックアウトを実行して、checkout.session.completed を待ってください。」
• 「Stripe のシークレットを使ってこの webhook の署名を検証し、再署名したうえで http://localhost:3000/webhooks に再送してください。」
• 「受信トレイを作成し、ステージング環境でそのアドレスを使って登録して、メールに届いた確認コードを教えてください。」
• 「直近の 3 件の webhook を再生用スイートとして保存し、修正後に localhost に対して実行してください。」

安全性

• 読み取り専用アクセス： read_only スコープをリクエストすると、エージェントはトラフィックの検索、待機、差分確認、検証、診断ができますが、作成、編集、削除、再生、転送、送信はできません。
• 削除は 2 段階です： dry_run でプレビューしてから、確定します。
• 再生と転送： 冪等性キーが必要なため、再試行された呼び出しで webhook が二重に送信されることはありません。
• 認証情報はマスクされます： ツールの結果では、ヘッダー、Cookie、クエリ文字列、JSON 本文に含まれる一般的なシークレットがマスクされます。
• データは組織ごとに分離され、ヨーロッパでホストされています。

まだアカウントをお持ちでない場合

エージェントはアカウントなしで一時的な webhook URL を作成でき、ユーザーは後からその URL を取得できます。app.hooklistener.com/llms.txt をご覧ください。

リンク

• ウェブサイト：https://www.hooklistener.com/mcp
• ドキュメント：https://docs.hooklistener.com/mcp/overview
• webhook MCP サーバーの比較：https://www.hooklistener.com/compare/webhook-mcp-servers
• プライバシー：https://www.hooklistener.com/privacy
• サポート：[email protected]