内容
# nahook-mcp
官方 **模型上下文协议** 服务器，适用于 [Nahook](https://nahook.com) — 通过 Claude Desktop、Cursor、Cline 等任何其他与 MCP 兼容的 AI 助手驱动 webhook 投递、端点和事件触发。
> MCP 服务器作为 [`nahook` CLI](https://github.com/getnahook/nahook-cli) 的子命令提供。单个二进制文件、一个凭证文件、一个安装路径。
[](https://glama.ai/mcp/servers/getnahook/nahook-mcp)
## 功能
安装并认证后，您的 AI 助手可以：
- **检查** 端点、投递和每次尝试的日志，以调试失败的 webhook。
- **重试** 失败或死信的投递。
- **触发** 事件，并将它们分发到每个已订阅的端点。
- **发送** webhook 直接到单个端点。
- **管理** 端点（创建、更新、暂停、恢复）— 按设计，永不删除。
写入操作会使用 MCP `destructiveHint`/`readOnlyHint` 注解标记，以便 MCP 客户端在修改状态之前为每个调用显示人工审批提示。
## 安装
MCP 服务器是 `nahook` CLI 的子命令。安装 CLI，然后将其添加到您的 AI 客户端。
### 1. 安装 CLI
**macOS / Linux（Homebrew）：**
```sh
brew install getnahook/tap/nahook
```
**Linux / macOS（安装脚本）：**
```sh
curl -fsSL https://cli.nahook.com/install.sh | sh
```
其他安装选项请参见 [getnahook/nahook-cli](https://github.com/getnahook/nahook-cli)。
### 2. 登录一次
```sh
nahook login
```
这将打开您的浏览器，引导您完成设备授权认证，并将凭证写入 `~/.nahook/config.toml`。
### 3. 将 MCP 服务器连接到您的 AI 客户端
**Claude Desktop & Claude Code CLI：**
```sh
claude mcp add nahook -- nahook mcp serve
```
**Cursor** — 编辑 `~/.cursor/mcp.json`：
```json
{
"mcpServers": {
"nahook": {
"command": "nahook",
"args": ["mcp", "serve"]
}
}
}
```
**Cline（VS Code）** — Cline → 设置 → MCP 服务器 → 添加：
```json
{
"nahook": {
"command": "nahook",
"args": ["mcp", "serve"]
}
}
```
**Zed** — 添加到 `settings.json`：
```json
{
"assistant": {
"mcp_servers": {
"nahook": {
"command": "nahook",
"args": ["mcp", "serve"]
}
}
}
}
```
其他与 MCP 兼容的客户端（Continue、Windsurf、Goose 等）遵循相同的 `command + args` 格式。
## 工具
| 工具 | 功能 |
|------|--------------|
| `whoami` | 本地配置健康检查 — 工作区、区域、令牌 ID、过期时间。 |
| `list_endpoints` | 列出当前工作区中的所有端点。 |
| `get_endpoint` | 通过 `ep_xxx` 获取一个端点。 |
| `create_endpoint` | 创建一个新端点。默认为工作区的默认环境；也接受 `production` 等_slug。 |
| `update_endpoint` | 部分修补 — 暂停/恢复、更改 URL、更新描述。 |
| `list_environments` | 列出工作区中的所有环境。 |
| `list_deliveries` | 分页浏览端点的投递，按最新优先。 |
| `get_delivery` | 通过 `del_xxx` 获取一个投递。传递 `include_payload: true` 以获取原始 webhook 正文 — 对调试至关重要。 |
| `list_attempts` | 列出针对投递的每次尝试（有助于调试失败）。 |
| `retry_delivery` | 重新排队失败或死信的投递。 |
| `trigger_event` | 按类型触发事件 — 后端将其分发到每个订阅者。 |
| `send_to_endpoint` | 直接向一个端点发送 webhook。 |
## 认证模型
MCP 服务器使用两个独立的凭证：
- **CLI 登录令牌** (`nhc_…`) — 由 `nahook login` 编写。支持读取工具和端点/投递/环境的管理操作。
- **摄取密钥** (`nhk_…`) — 您的 SDK 使用的相同密钥。支持 `trigger_event` 和 `send_to_endpoint`。通过在 MCP 客户端的环境中设置 `NAHOOK_INGESTION_KEY=nhk_...`，或在 `~/.nahook/config.toml` 中添加 `ingestion_key = "nhk_..."` 来设置。如果未配置写入工具，服务器将大声报错。
权限针对您的 **工作区角色** 对每个请求进行评估 — MCP 令牌具有与您在仪表盘上相同的权限，不多不少。
## 代码位置
MCP 服务器实现是 [`nahook` CLI 源代码树](https://github.com/getnahook/nahook-cli/tree/main/internal/commands/mcp) 的一部分。该仓库作为一个可发现性界面 — README、MCP 目录条目和包装元数据存在。没有单独的 codebase 需要维护。
如果您想提交错误、请求工具或贡献：请在 [getnahook/nahook-cli](https://github.com/getnahook/nahook-cli/issues) 上打开问题。
## 许可证
[MIT](./LICENSE) — 与 CLI 相同。
