MCP 工具参考

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

这里的权限如何运作

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

值	含义
Account	账户上任何有效的令牌。铸造令牌和席位的工具还额外需要一个账户主凭据（一个仪表盘会话或个人访问令牌）；一个团队令牌无法铸造令牌或席位。
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 服务器：通过任一传输连接一个代理。
权限与范围：上表所用的 read / create / edit / manage 模型。
交互式 API 参考：每个工具背后那个操作的确切模式。

MCP 工具参考

本页内容