Gatewerk

@gatewerk/mcp

Gatewerk MCP 服务让 AI Agent 能够在 Claude Desktop、Claude Code、Cursor、Windsurf 或任何 Model Context Protocol 客户端中读取和决定审核。它将 Gatewerk 的审核／模板／反馈／审计／链／备注 API 暴露为 MCP 工具，并受限于 API 密钥所携带的权限。

Gatewerk 是一个面向 AI Agent 的开源、可自托管审核层。为人类完成的工作应由人类决定。

快速开始

npx @gatewerk/mcp init

init 命令会提示你输入 Gatewerk URL、API 密钥，以及（可选的）审核者邮箱，然后输出一段配置，供你粘贴到 MCP 客户端的设置中。

你也可以手动编写配置：

{
  "mcpServers": {
    "gatewerk": {
      "command": "npx",
      "args": ["-y", "@gatewerk/[email protected]"],
      "env": {
        "GATEWERK_URL": "https://api.gatewerk.com",
        "GATEWERK_API_KEY": "gwk_...",
        "GATEWERK_REVIEWER": "[email protected]"
      }
    }
  }
}

GATEWERK_REVIEWER 是可选项——设置后，通过 MCP 服务作出的决定会归属到该审核者。否则将使用 API 密钥的身份。

可用工具

工具会根据 API 密钥附带的作用域自动筛选。只有 reviews:read 权限的密钥不会看到 gatewerk_decide_review。

审核

• gatewerk_create_review — 提交新的审核请求（作用域：reviews:create）
• gatewerk_list_reviews — 按筛选条件列出审核（作用域：reviews:read）
• gatewerk_get_review — 获取审核及其模板元数据（作用域：reviews:read）
• gatewerk_decide_review — 批准／拒绝／编辑／重试审核［已弃用；建议使用 gatewerk_take_review_action］（作用域：reviews:decide）
• gatewerk_take_review_action — 对审核执行可配置的操作；支持内置操作 ID 和模板专属操作 ID（作用域：reviews:decide）
• gatewerk_list_review_actions — 查看审核模板上可用的操作（作用域：reviews:read）

模板

• gatewerk_list_templates — 列出模板（作用域：templates:read）
• gatewerk_create_template — 定义模板（作用域：templates:write）
• gatewerk_update_template — 修改模板（作用域：templates:write）
• gatewerk_delete_template — 删除模板（作用域：templates:write）

链

• gatewerk_start_chain_run — 根据定义启动多步审核链（作用域：templates:write）
• gatewerk_get_chain_run — 按 ID 获取链运行及步骤（作用域：reviews:read）
• gatewerk_get_chain_for_review — 获取审核的链上下文（作用域：reviews:read）

备注

• gatewerk_create_note — 发布备注，可选关联一个或多个审核／模板／链运行（作用域：notes:write）
• gatewerk_list_notes — 按筛选条件列出备注（作者、标签、目标、共享／私有）（作用域：notes:read）

查询与统计

• gatewerk_query_feedback — 查询过往决定以供学习（作用域：feedback:read）
• gatewerk_query_audit — 查询审计记录（作用域：audit:read）
• gatewerk_get_stats — 审核指标与每日趋势（作用域：stats:read）

身份验证

你需要一个具有相应作用域的 Gatewerk API 密钥。请在以下位置生成：

• 云端：https://app.gatewerk.com → 设置 → API 密钥
• 可自托管：Gatewerk 实例的 /settings/api-keys 页面

常见的作用域组合：

• agent（读取自己的审核并创建新审核）：reviews:create、feedback:read
• reviewer（处理收件箱）：reviews:read、reviews:decide、templates:read、notes:read、notes:write
• admin（全部功能）：所有作用域

环境变量

变量	必需	描述
GATEWERK_API_KEY	是	API 密钥（gwk_...）
GATEWERK_URL	否	Gatewerk 基础 URL（默认为 http://localhost:3100）
GATEWERK_REVIEWER	否	用于标记决定归属的审核者邮箱

链接

• 网站：https://gatewerk.com
• 应用：https://app.gatewerk.com
• 源码：https://github.com/gatewerk/gatewerk
• 文档：https://gatewerk.com/docs
• 许可证：Apache-2.0（MCP SDK 软件包；服务端采用 AGPL-3.0-only）