webhooks.cc

@webhooks-cc/mcp

webhooks.cc 用の MCP サーバーです。コーディングエージェントが、エンドポイントの作成、署名付きテスト Webhook の送信、キャプチャの確認、試行の比較、署名の検証、MCP リソースを通じた最近の Webhook コンテキストの取得など、Webhook テストのワークフローに直接アクセスできるようにします。

Claude Code、Cursor、VS Code、Codex、Windsurf、Claude Desktop で動作します。

インストール

このサーバーは、環境変数から WHK_API_KEY を読み込みます。次の環境変数にも対応しています。

• カスタム API ベース URL 用の WHK_BASE_URL
• カスタム受信先ベース URL 用の WHK_WEBHOOK_URL

Claude Code プラグイン

このプラグインは、Claude にいつサーバーを使うかを伝える Webhook テスト用スキルとともにサーバーをインストールします。

/plugin install webhooks-cc --marketplace kroqdotdev/webhooks-cc

ほかのエージェントでは、npx skills add kroqdotdev/webhooks-cc を実行すると同じスキルをインストールできます。エージェントスキルをご覧ください。

ワンクリック

• Cursor：Cursor に追加
• VS Code：VS Code に追加

CLI

# Claude Code
claude mcp add -s user --transport stdio webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp

# OpenAI Codex
codex mcp add webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp

# Cursor
npx @webhooks-cc/mcp setup cursor --api-key whcc_...

# VS Code
npx @webhooks-cc/mcp setup vscode --api-key whcc_...

# Windsurf
npx @webhooks-cc/mcp setup windsurf --api-key whcc_...

# Claude Desktop
npx @webhooks-cc/mcp setup claude-desktop --api-key whcc_...

手動設定

{
  "mcpServers": {
    "webhooks-cc": {
      "command": "npx",
      "args": ["-y", "@webhooks-cc/mcp"],
      "env": {
        "WHK_API_KEY": "whcc_..."
      }
    }
  }
}

API キーは webhooks.cc/account/api-keys で取得できます。

提供する機能

API キーを使うと、39 個のツール、3 個のプロンプト、3 種類のリソースインターフェースを利用できます。API キーがない場合は、11 個のサンドボックスツールを利用できます。

エンドポイントツール

• create_endpoint
• list_endpoints
• get_endpoint
• update_endpoint
• delete_endpoint
• create_endpoints
• delete_endpoints

リクエストツール

• list_requests
• search_requests
• count_requests
• get_request
• wait_for_request
• wait_for_requests
• replay_request
• compare_requests
• generate_payload_schema（キャプチャしたボディから TypeScript、Zod、Pydantic、または JSON Schema を生成）
• extract_from_request
• verify_signature
• clear_requests

メールツール

アカウント上のすべてのエンドポイントは、{slug}@mailhooks.cc（および {slug}+{tag}@mailhooks.cc）宛てのメールを受信します。エンドポイントの所有者が無効にしていない限り、これらのツールでメールを読み取れます。一度だけ使用できるコードとメインリンクは、あらかじめ抽出されています。

• list_emails
• get_email
• wait_for_email
• send_test_email

リクエストツールとリソースからもメールを取得できます（kind でフィルタリング）。ただし、生のメッセージと HTML 部分は含まれず、テキストは 8,000 文字で切り詰められます。get_email では HTML を取得できます。

転送ツール

キャプチャしたすべての HTTP リクエストとメールを、受信時のまま URL、Slack チャンネル、または Discord チャンネルに転送します。署名付き JSON またはチャットメッセージとして送信し、再試行とログ記録を行います（所有者のみ）。

• configure_forwarding（URL、オン／オフ、種類、形式、カスタムヘッダー、パス、再試行、順序、送信時刻のフィールド）
• get_forwarding_secret（whsec_ シークレットを返します。rotate: true を指定するとシークレットを置き換えます）
• test_forwarding
• list_deliveries（配信件数を含む配信ログ、または特定のリクエストに対するすべての試行）
• redeliver（1 件のリクエスト、またはエンドポイントの配信に失敗したすべてのリクエスト）

送信およびテストツール

• send_webhook
• send_to
• preview_webhook
• test_webhook_flow

チームツール

• list_teams
• list_team_members
• share_endpoint
• unshare_endpoint

共有されたエンドポイントは、fromTeam とともに list_endpoints にすでに表示され、所有者専用の clear_requests を除くすべてのリクエストツールで使用できます。招待は公開されません。招待を承諾すると、有料シートが割り当てられます。

検出およびアカウントツール

• list_provider_templates
• get_usage（個人プランと、登録している各チームの利用枠）
• describe

APIキーなしの場合：エージェント用サンドボックス

WHK_API_KEY を設定せずに起動すると、代わりにサンドボックス用ツールが登録されます（auth.md）。

• create_endpoint、list_endpoints、get_endpoint、delete_endpoint、list_requests、get_request、wait_for_request、generate_payload_schema：フルツールと同じ名前および引数で、最大3個のエンドポイント、各25件、合計100件のリクエストを24時間保持するサンドボックスで利用できます。最初の create_endpoint で登録されます（数秒のプルーフ・オブ・ワークが必要です）。
• connect_account：エージェントをアカウントに接続するためのリンクと6桁のコードを返します。
• wait_for_connection：人間による接続を待ち、その後、サンドボックス用ツールをそのアカウントのフルツールに置き換えます（notifications/tools/list_changed）。
• about_sandbox：ネットワーク呼び出しを行わずに、制限と接続方法を確認できます。

プロンプト

サーバーは、一般的なワークフロー向けの MCP プロンプトを公開します。

• debug_webhook_delivery
• setup_provider_testing
• compare_webhook_attempts

これらのプロンプトは、それ自体では何も実行しません。複数ステップにわたるエージェントの作業を始めるための、構造化された出発点をクライアントに提供します。

リソース

サーバーは、最近の webhook のコンテキストに関する MCP リソースを公開します。

• webhooks://endpoints
• webhooks://endpoint/{slug}/recent
• webhooks://request/{id}

これらは、クライアントがリソースの参照やプロンプト／リソースの添付に対応している場合に便利です。

プロバイダーのサポート

プロバイダーのテンプレートおよび署名のサポート対象は次のとおりです。

• stripe
• github
• shopify
• twilio
• slack
• paddle
• linear
• sendgrid
• clerk
• discord
• vercel
• gitlab
• typeform
• standard-webhooks
• meta
• lemonsqueezy
• coinbase-commerce
• razorpay
• cal
• intercom
• telegram
• square
• hubspot
• mailgun
• calendly
• mux
• sentry
• bitbucket
• docusign
• adyen
• paypal
• plaid
• resend
• workos

署名検証では、次のプロバイダーもサポートしています。

• sendgrid（IP の許可リスト）と plaid（JWT／JWK の検証には Plaid API の認証情報が必要）を除く、すべてのテンプレートプロバイダー

エージェントからテンプレート、デフォルトのイベント、署名ヘッダー、署名要件を確認するには、list_provider_templates を使用します。

ワークフローの例

一般的なエージェントの処理フロー：

• 一時的なエンドポイントを作成し、プロバイダー署名付き webhook を送信して、キャプチャを待つ
• 全文フィルターを使用して、複数のエンドポイントにわたって保持されたリクエストを検索する
• 2つの webhook の試行を比較し、必要な JSON フィールドだけを抽出する
• 既知のシークレットを使用して、キャプチャした署名を検証する
• test_webhook_flow を実行して、1回のツール呼び出しで作成、送信、キャプチャ、検証、再送、クリーンアップを行う

プログラムからの利用

サーバーを自分で埋め込む場合に備えて、パッケージでは createServer()、registerTools()、registerPrompts()、registerResources() もエクスポートしています。

import { createServer } from "@webhooks-cc/mcp";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = createServer({
  apiKey: process.env.WHK_API_KEY!,
  baseUrl: process.env.WHK_BASE_URL,
  webhookUrl: process.env.WHK_WEBHOOK_URL,
});

await server.connect(new StdioServerTransport());

会話の例

You: Create an ephemeral endpoint for GitHub webhook testing.

Agent: Created endpoint https://go.webhooks.cc/w/abc123 and marked it ephemeral.

You: Preview the signed request for a push event before sending it.

Agent: Here is the exact method, headers, and JSON body that would be sent.

You: Send it, wait for two requests, and compare them.

Agent: Sent the webhook, captured two requests, and here are the header and body differences.

ドキュメント

ドキュメント全文：webhooks.cc/docs/mcp

ライセンス

MIT