---
type: reference
title: MCP 工具参考
summary: 每一个 Caputchin MCP 工具、它做什么、以及它的令牌必须持有的权限，按领域分组。
---

这些是 [MCP 服务器](/docs/automation/mcp)（无论本地还是托管形态）所暴露的工具。每一个都代理一个 [管理 API](/docs/automation/management-api) 操作，所以一个工具需要的权限，就是那个操作需要的权限；代理的 [令牌](/docs/automation/management-api#mint-an-access-token) 必须持有它。这份目录和这些描述来自服务器本身；一个工具背后那个操作的确切请求和响应模式，见 [交互式 API 参考](/docs/api-reference)。

## 这里的权限如何运作

只有当一个工具背后的令牌被允许执行底层操作时，这个工具才会运行。**权限** 列用这些值，它们对应团队的 [权限与范围](/docs/troops/permissions) 模型：

| 值 | 含义 |
|---|---|
| **Account** | 账户上任何有效的令牌。铸造令牌和席位的工具还额外需要一个账户主凭据（一个仪表盘会话或 [个人访问令牌](/docs/account-management/personal-access-token)）；一个团队令牌无法铸造令牌或席位。 |
| **read** | `read` 权限。站点限定的工具还需要那个站点密钥在令牌的范围之内。 |
| **create** | 团队上的 `create` 权限（在它里面创建一个站点密钥）。 |
| **edit** | `edit` 权限，限定到工具所针对的那个站点密钥。 |
| **manage** | `manage` 权限：团队管理（成员、令牌、全团队设置）。 |

少数工具还需要一个套餐档位，在描述里注明：白标化是 **Apex**，游戏语言和皮肤自定义是 **Alpha 及以上**，审计日志是 **Apex**。

## 账户与健康

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_ping` | 健康检查；令牌有效时返回解析出的账户 id。 | Account |
| `caputchin_get_account` | 已验证的账户（id、邮箱、套餐）。 | Account |
| `caputchin_me_billing` | 账单摘要（套餐、状态、周期）。 | Account |
| `caputchin_get_seats` | 账户的席位用量（已用、总数、拆解）。 | Account |

## 令牌与席位

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_list_tokens` | 列出账户的令牌；绝不返回密钥。 | Account |
| `caputchin_create_token` | 铸造一个令牌（`type` 为 troop 或 account）；值返回一次。 | Account（master） |
| `caputchin_rotate_token` | 轮换一个令牌的密钥；新值返回一次。 | Account（master） |
| `caputchin_revoke_token` | 吊销一个令牌；立即生效。 | Account（master） |
| `caputchin_invite_seat_user` | 邀请一个用户进一个团队（席位感知）；若是新人则占一个席位。 | Account（master） |
| `caputchin_remove_seat_user` | 把一个用户从账户里的每个团队移除。 | Account（master） |
| `caputchin_mint_seat_pat` | 一个调用里铸造并附上一个团队令牌；值返回一次。 | Account（master） |
| `caputchin_attach_seat_pat` | 把一个现有团队令牌附到另一个团队上。 | Account（master） |
| `caputchin_revoke_seat_pat` | 在整个账户里吊销一个团队令牌。 | Account（master） |

## 团队

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_list_troops` | 列出账户的团队。 | Account |
| `caputchin_get_troop` | 按 id 取一个团队。 | read |
| `caputchin_create_troop` | 创建一个共享团队。 | Account |
| `caputchin_rename_troop` | 重命名一个团队。 | manage |
| `caputchin_delete_troop` | 删除一个团队；若它仍拥有站点密钥则拒绝。 | manage |
| `caputchin_list_troop_members` | 一个团队的成员，带他们的权限和范围。 | read |
| `caputchin_add_troop_member` | 用邮箱添加一个用户，带权限和范围；可能占一个席位。 | manage |
| `caputchin_update_troop_member` | 更改一个成员的权限或范围。 | manage |
| `caputchin_remove_troop_member` | 移除一个成员；若那是他们的最后一席则腾出他们的席位。 | manage |
| `caputchin_list_troop_pats` | 附在一个团队上的团队令牌。 | read |
| `caputchin_attach_troop_pat` | 附上一个团队令牌，带权限和范围；占一个席位。 | manage |
| `caputchin_update_troop_pat` | 更改一个已附令牌的权限或范围。 | manage |
| `caputchin_detach_troop_pat` | 分离一个团队令牌；腾出它的席位。 | manage |
| `caputchin_get_troop_security` | 一个团队的安全设置（强制游戏上限，外加预览模式和验证复用的默认值）。 | read |
| `caputchin_update_troop_security` | 设定强制游戏上限，以及团队级的预览模式和验证复用默认值。 | manage |

## 站点密钥

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_list_sites` | 账户各团队里的所有站点密钥。 | read |
| `caputchin_get_site` | 按 id 取一个站点密钥。 | read |
| `caputchin_create_site` | 创建一个站点密钥（在一个团队里，或个人）；返回那个一次性密钥。 | create |
| `caputchin_update_site` | 更新一个密钥的名称或停用标志。 | edit |
| `caputchin_delete_site` | 删除一个密钥；级联会话和配置。不可逆。 | edit |
| `caputchin_rotate_site_secret` | 轮换密钥；旧的立即停止；新的返回一次。 | edit |
| `caputchin_get_site_cap_config` | 一个密钥的 proof-of-work 配置。 | read |
| `caputchin_update_site_cap_config` | 更新 proof-of-work 配置。 | edit |
| `caputchin_get_site_security` | 一个密钥的安全设置（要求游戏关卡、预览模式和验证复用）。 | read |
| `caputchin_update_site_security` | 切换逐密钥的要求游戏关卡、预览模式和验证复用。 | edit |
| `caputchin_list_site_sessions` | 一个密钥近期的验证会话。 | read |

## 托管验证

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_get_hosted_verification` | 一个密钥的托管验证配置。 | read |
| `caputchin_set_hosted_verification` | 设置启用标志和目标。 | edit |
| `caputchin_test_hosted_verification` | 向已配置的目标发一次合成投递。 | edit |

## 统计、投递与审计日志

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_site_stats` | 一个范围内的站点验证统计。 | read |
| `caputchin_site_stats_dashboard` | 站点统计仪表盘汇总。 | read |
| `caputchin_site_stats_activity` | 站点统计活动序列。 | read |
| `caputchin_site_stats_durations` | 站点统计时序百分位。 | read |
| `caputchin_site_stats_rejections` | 站点拒绝计数。 | read |
| `caputchin_troop_stats` | 团队统计的生命周期总计。 | read |
| `caputchin_troop_stats_dashboard` | 团队统计仪表盘汇总。 | read |
| `caputchin_troop_stats_activity` | 团队统计活动序列。 | read |
| `caputchin_troop_stats_durations` | 团队统计时序百分位。 | read |
| `caputchin_troop_stats_rejections` | 团队拒绝计数。 | read |
| `caputchin_quick_stats_sites` | 跨账户的紧凑逐站点统计快照。 | read |
| `caputchin_quick_stats_troops` | 跨账户的紧凑逐团队统计快照。 | read |
| `caputchin_site_delivery_dashboard` | 一个站点的托管验证投递统计。Apex。 | read |
| `caputchin_troop_delivery_dashboard` | 一个团队的托管验证投递统计。Apex。 | read |
| `caputchin_account_audit_logs` | 账户级审计日志。Apex。 | Account |
| `caputchin_troop_audit_logs` | 团队审计日志。Apex。 | read |
| `caputchin_site_audit_logs` | 站点密钥审计日志。Apex。 | read |

## 应用市场游戏

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_list_games` | 列出应用市场游戏。 | Account |
| `caputchin_search_games` | 按文本搜索应用市场游戏。 | Account |
| `caputchin_get_game` | 按 id 取一个应用市场游戏。 | Account |

## 游戏自定义

这些针对一个范围（一个站点密钥或一个团队），所以一个站点限定的更改需要那个密钥上的 `edit`，而一个全团队的更改需要 `manage`。语言和皮肤自定义是 **Alpha 及以上**。

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_list_customized_games` | 一个范围已注册（已安装）的游戏。 | read |
| `caputchin_register_customized_game` | 在一个范围上注册（安装）一个游戏；固定一份快照。 | edit（site）或 manage（troop） |
| `caputchin_repin_customized_game` | 把一个已注册游戏重新固定到最新版本。 | edit（site）或 manage（troop） |
| `caputchin_update_customized_game` | 更新一个已注册游戏的设置（自动更新）。 | edit（site）或 manage（troop） |
| `caputchin_delete_customized_game` | 从一个范围卸载一个已注册游戏。 | edit（site）或 manage（troop） |
| `caputchin_list_game_presets` | 一个范围和游戏的自定义预设。 | read |
| `caputchin_set_game_preset` | 创建或更新一个游戏预设。Alpha+。 | edit（site）或 manage（troop） |
| `caputchin_delete_game_preset` | 删除一个游戏预设。Alpha+。 | edit（site）或 manage（troop） |
| `caputchin_set_game_default` | 为一个维度设定默认游戏预设。Alpha+。 | edit（site）或 manage（troop） |
| `caputchin_get_custom_game_schema` | 一个范围下一个自定义游戏的字段模式。 | read |
| `caputchin_set_custom_game_schema` | 设置一个自定义游戏的字段模式。Alpha+。 | edit（site）或 manage（troop） |
| `caputchin_delete_custom_game_schema` | 删除一个自定义游戏的字段模式。Alpha+。 | edit（site）或 manage（troop） |
| `caputchin_upload_custom_game_run` | 上传一个自定义游戏的 headless run 工件。 | edit（site）或 manage（troop） |
| `caputchin_get_custom_game_run` | 取一个自定义游戏存储的 run 工件引用。 | read |
| `caputchin_delete_custom_game_run` | 删除一个自定义游戏的 run 工件。 | edit（site）或 manage（troop） |

## 白标

把组件外壳白标化是一个 **Apex** 功能。和游戏自定义一样，一个站点限定的更改需要 `edit`，而一个全团队的更改需要 `manage`。

| 工具 | 做什么 | 权限 |
|---|---|---|
| `caputchin_list_white_label_presets` | 一个范围的白标预设。 | read |
| `caputchin_set_white_label_preset` | 创建或更新一个白标预设。Apex。 | edit（site）或 manage（troop） |
| `caputchin_delete_white_label_preset` | 删除一个白标预设。Apex。 | edit（site）或 manage（troop） |
| `caputchin_set_white_label_default` | 为一个维度设定默认白标预设。Apex。 | edit（site）或 manage（troop） |

## 另见

- [使用 MCP 服务器](/docs/automation/mcp)：通过任一传输连接一个代理。
- [权限与范围](/docs/troops/permissions)：上表所用的 read / create / edit / manage 模型。
- [交互式 API 参考](/docs/api-reference)：每个工具背后那个操作的确切模式。