Hooklistener

Hooklistener MCP 服务

托管式 MCP 服务，可让 AI 编码 Agent 端到端测试 Webhook：创建公开 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 令牌。
• 工具： 共 67 个，分为 7 个工具集。新工作区会列出其中 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" }
    }
  }
}

为你安装此服务的 Agent 可参考 llms-install.md。

其他客户端

分步指南：ChatGPT · Gemini CLI · Windsurf · Zed · OpenCode · Grok（xAI API）

任何支持 Streamable HTTP 的 MCP 客户端都可以通过上述端点连接。

Agent 可以做什么

类别	示例
调试端点	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。"
• "创建一个收件箱，用它在预发布环境注册，并告诉我邮件中的验证码。"
• "将最近的三个 webhook 保存为回放套件，并在我修复后针对 localhost 运行。"

安全

• 只读访问： 请求 read_only 范围后，Agent 可以搜索、等待、比较差异、验证和诊断流量，但无法创建、编辑、删除、重放、转发或发送任何内容。
• 删除分两步进行： 先使用 dry_run 预览，再确认。
• 重放和转发需要幂等键，因此重试调用不会重复发送 webhook。
• 凭据会在工具结果中屏蔽： 包括标头、Cookie、查询字符串和 JSON 请求体中的常见密钥。
• 数据仅限你的组织访问，并托管在欧洲。

还没有账号？

Agent 无需账号即可创建临时 webhook 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]