Watchgoose

Watchgoose MCP

Watchgoose MCP 可将支持 MCP 的 AI 客户端连接到 Watchgoose Management API。你可以查看 cron 和定期任务的监控情况；只有在明确启用写入后，才能更改检查项。

托管连接器

对于支持 OAuth 2.1 和 Dynamic Client Registration 的客户端，请使用托管的 Streamable HTTP 端点：

https://mcp.watchgoose.com/mcp

可用平台

Watchgoose 已收录于 Claude 连接器目录。

Watchgoose 已 收录于 ChatGPT 的 GPT 和 Codex 插件目录。

Watchgoose 已 收录于官方 MCP Registry。

watchgoose-mcp package 可在 npm 上获取。

在 Claude 中，打开 Settings > Connectors，并将端点添加为自定义连接器。对于 Claude Code，请运行：

claude mcp add --transport http --scope user watchgoose https://mcp.watchgoose.com/mcp

浏览器授权流程会将每个连接限制为一个项目，并默认采用只读访问权限。有关工具和隐私 边界，请参阅 Watchgoose MCP 文档。

要求

• Node.js 20 或更高版本
• 项目级 Watchgoose API 密钥，路径为 Project settings → API Access → Create (read-only)

如果只需要检查状态和状态历史记录，请使用 hcr_ 只读密钥。如果还需要 ping、集成或更改检查项，请使用 hcw_ 读写密钥。

Claude Desktop

将此条目添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

Claude Code

claude mcp add --env WATCHGOOSE_API_KEY=hcr_your_project_key \
  --transport stdio --scope user watchgoose -- npx -y watchgoose-mcp

运行 claude mcp get watchgoose 检查连接。

Cursor

在项目中创建 .cursor/mcp.json，或将相同条目添加到用户 MCP 配置中：

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

VS Code

创建 .vscode/mcp.json：

{
  "servers": {
    "watchgoose": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

运行 MCP: List Servers 并启动 watchgoose。

Cline

Cline 通过 OAuth 连接到托管端点，因此无需 API 密钥。打开 MCP Servers > Configure MCP Servers，并将此条目添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "watchgoose": {
      "type": "streamableHttp",
      "url": "https://mcp.watchgoose.com/mcp"
    }
  }
}

请保持 "type": "streamableHttp" 不变；否则 Cline 会退回到 SSE，导致连接失败。当 Cline 提示你进行身份验证时，请在浏览器中登录 Watchgoose， 选择一个项目；除非你希望 Cline 更改检查项，否则请保持只读访问权限。若要改用项目 API 密钥，请将上方 Cursor 部分中的 npx 条目添加到同一文件中。

环境

变量	必需	默认值	说明
WATCHGOOSE_API_KEY	是	-	项目范围的 hcr_ 只读密钥、hcw_ 读写密钥，或旧版 32 字符密钥。
WATCHGOOSE_API_URL	否	https://watchgoose.com/api/v3	管理 API 基础 URL。除回环开发主机外，必须使用 HTTPS。密钥会发送到此主机，因此只能使用你信任的 URL。
WATCHGOOSE_ENABLE_WRITES	否	false	若密钥具有读写权限，设置为 true 即可开放变更工具。
WATCHGOOSE_API_KEY_ACCESS	仅限旧版密钥	-	对于不带前缀的 32 字符密钥，必须设为 read-only 或 read-write。

服务会在本地识别密钥前缀，绝不会通过探测 API 来判断访问权限。设置 WATCHGOOSE_ENABLE_WRITES=true 无法为只读密钥授予额外权限。

工具

检查项通过稳定的 40 字符 unique_key 值寻址。UUID、ping URL 和集成 UUID 仅在服务内部使用，不会显示给 AI 客户端。

工具	所需访问权限	管理 API 映射
list_checks	只读	GET /checks/
get_check	只读	GET /checks/<unique_key>
list_flips	只读	GET /checks/<unique_key>/flips/
list_pings	读写	解析 unique_key，然后执行 GET /checks/<uuid>/pings/
list_channels	读写	GET /channels/
create_check	读写且启用写入	POST /checks/
update_check	读写且启用写入	解析 unique_key，然后执行 POST /checks/<uuid>
pause_check	读写且启用写入	解析 unique_key，然后执行 POST /checks/<uuid>/pause
resume_check	读写且启用写入	解析 unique_key，然后执行 POST /checks/<uuid>/resume
delete_check	读写且启用写入	解析 unique_key，然后执行 DELETE /checks/<uuid>

集成分配使用完全匹配的集成名称。名称不能为空，且在同一项目中必须唯一。

提供 unique 时，create_check 会执行创建或更新操作：匹配到现有检查项时，会替换其已提供的设置。未提供 schedule 但提供了 timeout，也会将定时检查切换为间隔监控：存储的 schedule 字符串仍会保留，但不再决定检查频率。若要保留定时监控，请提供已确认的 schedule。其他未提供的设置保持不变。 channels: [] 会清除所有警报集成分配。因此，该工具会声明 destructiveHint: true。对于基于完成状态的检查频率，新检查项会等待成功或失败结果；首次失败可能会使其状态降级。可选的启动 ping 可在完成前启动运行时监控。

列表结果最多包含 100 个检查项、100 个 ping、200 个状态变化和 100 个集成。每个序列化工具结果也最多为 24,000 个字符。结果会在省略条目时包含元数据。

安全

• 默认禁用写入，即使使用 hcw_ 密钥也是如此。
• API 密钥仅通过 X-Api-Key 标头发送，绝不会记录或返回。
• 拒绝 API 重定向，防止凭据被转发到其他主机。
• 会从输出中移除检查 UUID、ping 和更新 URL、集成 UUID 以及未知的未来 API 字段。
• Ping 仅保留 type、date、n、scheme、method 和 duration。源 IP 地址、用户代理、运行 ID 和正文 URL 均会移除。
• 绝不会请求 ping 正文。
• 此服务不进行遥测。

请保护包含 API 密钥的客户端配置文件。建议使用专用项目，并选择能够提供所需工具的最低权限密钥。不再使用时，请从 Watchgoose 项目设置中撤销密钥。

请按照 SECURITY.md 中的说明私下报告漏洞。

工作流技能

该仓库包含可移植技能，用于审计定时任务覆盖情况、起草单个任务的设置方案、分诊心跳遗漏、检查现有监控的健康状况，以及根据审计结果、列表或 CSV 提出经批准的仅创建批次。有关本地安装、示例和安全边界，请参阅技能指南。技能不会授予额外权限、自动运行任务，也不会更改现有目录列表。

可安装的监控插件位于 plugins/watchgoose-monitoring/，其中包含一套规范技能目录和远程 MCP 适配器。请加载该子文件夹，而不是仓库根目录；旧的根目录插件／技能路径已被取代，已安装的副本不会自动迁移。npm CLI 和托管端点保持不变。

每个版本也会将该插件发布到 pixeware/watchgoose-plugin 的根目录：

• Gemini CLI：gemini extensions install https://github.com/pixeware/watchgoose-plugin
• Grok Build：grok plugin install pixeware/watchgoose-plugin --trust
• 任何可读取 Agent Skills 的 Agent：npx skills add pixeware/watchgoose-plugin，然后在客户端中添加托管端点

开发

npm install
npm run format:check
npm run lint
npm run typecheck
npm test
npm run publish:dry-run

生产环境集成测试需选择加入，并需要专用的测试项目密钥。它们不会在 CI 中运行。

所有面向用户的发行物共用一个版本号：npm 包、server.json、托管服务、Claude 和可移植插件清单，以及 OpenAI 插件。请同时更新 packages/core/src/constants.ts 中的 WATCHGOOSE_RELEASE_VERSION 和对应清单；如果其中任何一项不一致，tests/skills/release-version.test.ts 就会失败。OpenAI 上传 ZIP 使用 npm run build:openai-plugin 构建。

支持

• 支持： [email protected]
• 文档：watchgoose.com/docs/mcp
• 隐私政策：watchgoose.com/legal/privacy
• 服务条款：watchgoose.com/legal/terms

许可证

MIT

各类徽章