---
type: reference
title: Referencia de herramientas MCP
summary: Cada herramienta MCP de Caputchin, qué hace, y el permiso que su token debe tener, agrupadas por área.
---

Estas son las herramientas que el [servidor MCP](/docs/automation/mcp) expone, tanto en su forma local como en la alojada. Cada una hace de proxy de una sola operación de la [API de gestión](/docs/automation/management-api), así que el permiso que una herramienta necesita es el permiso que esa operación necesita; el [token](/docs/automation/management-api#mint-an-access-token) del agente debe tenerlo. El catálogo y las descripciones vienen del propio servidor; para el esquema exacto de petición y respuesta de la operación detrás de una herramienta, mira la [referencia interactiva de la API](/docs/api-reference).

## Cómo funcionan los permisos aquí

Una herramienta corre solo si el token detrás de ella tiene permitido realizar la operación subyacente. La columna **Permiso** usa estos valores, que mapean al modelo de [permisos y alcance](/docs/troops/permissions) del equipo:

| Valor | Significa |
|---|---|
| **Account** | Cualquier token válido en la cuenta. Las herramientas que acuñan tokens y asientos requieren además una credencial maestra de cuenta (una sesión del dashboard o el [personal access token](/docs/account-management/personal-access-token)); un token de equipo no puede acuñar tokens ni asientos. |
| **read** | El permiso `read`. Las herramientas acotadas a un sitio requieren además que la clave de sitio esté en el alcance del token. |
| **create** | El permiso `create` en el equipo (crear una clave de sitio en él). |
| **edit** | El permiso `edit`, acotado a la clave de sitio a la que apunta la herramienta. |
| **manage** | El permiso `manage`: administración del equipo (miembros, tokens, ajustes de todo el equipo). |

Unas pocas herramientas también necesitan un nivel de plan, anotado en la descripción: el white-label es **Apex**, la personalización de idioma y skin de juego es **Alpha y superior**, y los audit logs son **Apex**.

## Cuenta y salud

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_ping` | Chequeo de salud; devuelve el id de cuenta resuelto cuando el token es válido. | Account |
| `caputchin_get_account` | La cuenta autenticada (id, correo, plan). | Account |
| `caputchin_me_billing` | Resumen de facturación (plan, estado, periodo). | Account |
| `caputchin_get_seats` | Uso de asientos de la cuenta (usados, total, desglose). | Account |

## Tokens y asientos

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_list_tokens` | Lista los tokens de la cuenta; nunca devuelve secretos. | Account |
| `caputchin_create_token` | Acuña un token (`type` equipo o account); valor devuelto una vez. | Account (maestro) |
| `caputchin_rotate_token` | Rota el secreto de un token; valor nuevo devuelto una vez. | Account (maestro) |
| `caputchin_revoke_token` | Revoca un token; efectivo de inmediato. | Account (maestro) |
| `caputchin_invite_seat_user` | Invita a un usuario a un equipo (consciente de asientos); consume un asiento si es nuevo. | Account (maestro) |
| `caputchin_remove_seat_user` | Quita a un usuario de cada equipo de la cuenta. | Account (maestro) |
| `caputchin_mint_seat_pat` | Acuña y adjunta un token de equipo en una llamada; valor devuelto una vez. | Account (maestro) |
| `caputchin_attach_seat_pat` | Adjunta un token de equipo existente a otro equipo. | Account (maestro) |
| `caputchin_revoke_seat_pat` | Revoca un token de equipo en toda la cuenta. | Account (maestro) |

## Equipos

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_list_troops` | Lista los equipos de la cuenta. | Account |
| `caputchin_get_troop` | Un equipo por id. | read |
| `caputchin_create_troop` | Crea un equipo compartido. | Account |
| `caputchin_rename_troop` | Renombra un equipo. | manage |
| `caputchin_delete_troop` | Elimina un equipo; se niega si todavía posee claves de sitio. | manage |
| `caputchin_list_troop_members` | Los miembros de un equipo con sus permisos y alcance. | read |
| `caputchin_add_troop_member` | Añade un usuario por correo con permisos y alcance; puede consumir un asiento. | manage |
| `caputchin_update_troop_member` | Cambia los permisos o el alcance de un miembro. | manage |
| `caputchin_remove_troop_member` | Quita a un miembro; libera su asiento si era el último. | manage |
| `caputchin_list_troop_pats` | Los tokens de equipo adjuntos a un equipo. | read |
| `caputchin_attach_troop_pat` | Adjunta un token de equipo con permisos y alcance; consume un asiento. | manage |
| `caputchin_update_troop_pat` | Cambia los permisos o el alcance de un token adjunto. | manage |
| `caputchin_detach_troop_pat` | Desadjunta un token de equipo; libera su asiento. | manage |
| `caputchin_get_troop_security` | Los ajustes de seguridad de un equipo (el techo de forzar-juego más los valores por defecto de modo Vista previa y Reutilización de verificación). | read |
| `caputchin_update_troop_security` | Fija el techo de forzar-juego y los valores por defecto de todo el equipo de modo Vista previa y Reutilización de verificación. | manage |

## Claves de sitio

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_list_sites` | Todas las claves de sitio de los equipos de la cuenta. | read |
| `caputchin_get_site` | Una clave de sitio por id. | read |
| `caputchin_create_site` | Crea una clave de sitio (en un equipo, o Personal); devuelve el secreto de un solo uso. | create |
| `caputchin_update_site` | Actualiza el nombre o el flag de desactivada de una clave. | edit |
| `caputchin_delete_site` | Elimina una clave; cascada a sesiones y configuración. Irreversible. | edit |
| `caputchin_rotate_site_secret` | Rota el secreto; el viejo se detiene de inmediato; el nuevo devuelto una vez. | edit |
| `caputchin_get_site_cap_config` | La config de proof-of-work de una clave. | read |
| `caputchin_update_site_cap_config` | Actualiza la config de proof-of-work. | edit |
| `caputchin_get_site_security` | Los ajustes de seguridad de una clave (el gate de exigir-juego, el modo Vista previa y la Reutilización de verificación). | read |
| `caputchin_update_site_security` | Conmuta por clave el gate de exigir-juego, el modo Vista previa y la Reutilización de verificación. | edit |
| `caputchin_list_site_sessions` | Sesiones de verificación recientes de una clave. | read |

## Verificación alojada

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_get_hosted_verification` | La config de verificación alojada de una clave. | read |
| `caputchin_set_hosted_verification` | Fija el flag de activación y los destinos. | edit |
| `caputchin_test_hosted_verification` | Dispara una entrega sintética a los destinos configurados. | edit |

## Estadística, entrega y audit logs

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_site_stats` | Estadística de verificación del sitio sobre un rango. | read |
| `caputchin_site_stats_dashboard` | Sumatorio del dashboard de estadística del sitio. | read |
| `caputchin_site_stats_activity` | Serie de actividad de estadística del sitio. | read |
| `caputchin_site_stats_durations` | Percentiles de tiempo de estadística del sitio. | read |
| `caputchin_site_stats_rejections` | Recuentos de rechazo del sitio. | read |
| `caputchin_troop_stats` | Totales de por vida de estadística del equipo. | read |
| `caputchin_troop_stats_dashboard` | Sumatorio del dashboard de estadística del equipo. | read |
| `caputchin_troop_stats_activity` | Serie de actividad de estadística del equipo. | read |
| `caputchin_troop_stats_durations` | Percentiles de tiempo de estadística del equipo. | read |
| `caputchin_troop_stats_rejections` | Recuentos de rechazo del equipo. | read |
| `caputchin_quick_stats_sites` | Instantánea compacta de estadística por sitio en toda la cuenta. | read |
| `caputchin_quick_stats_troops` | Instantánea compacta de estadística por equipo en toda la cuenta. | read |
| `caputchin_site_delivery_dashboard` | Estadística de entrega de verificación alojada de un sitio. Apex. | read |
| `caputchin_troop_delivery_dashboard` | Estadística de entrega de verificación alojada de un equipo. Apex. | read |
| `caputchin_account_audit_logs` | Audit log a nivel de cuenta. Apex. | Account |
| `caputchin_troop_audit_logs` | Audit log del equipo. Apex. | read |
| `caputchin_site_audit_logs` | Audit log de la clave de sitio. Apex. | read |

## Juegos del marketplace

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_list_games` | Lista los juegos del marketplace. | Account |
| `caputchin_search_games` | Busca juegos del marketplace por texto. | Account |
| `caputchin_get_game` | Un juego del marketplace por id. | Account |

## Personalización de juego

Estas apuntan a un alcance (una clave de sitio o un equipo), así que un cambio acotado al sitio necesita `edit` en esa clave y un cambio de todo el equipo necesita `manage`. La personalización de idioma y skin es **Alpha y superior**.

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_list_customized_games` | Los juegos registrados (instalados) de un alcance. | read |
| `caputchin_register_customized_game` | Registra (instala) un juego en un alcance; fija una instantánea. | edit (sitio) o manage (equipo) |
| `caputchin_repin_customized_game` | Re-fija un juego registrado a la última versión. | edit (sitio) o manage (equipo) |
| `caputchin_update_customized_game` | Actualiza los ajustes de un juego registrado (auto-update). | edit (sitio) o manage (equipo) |
| `caputchin_delete_customized_game` | Desinstala un juego registrado de un alcance. | edit (sitio) o manage (equipo) |
| `caputchin_list_game_presets` | Presets de personalización para un alcance y juego. | read |
| `caputchin_set_game_preset` | Crea o actualiza un preset de juego. Alpha+. | edit (sitio) o manage (equipo) |
| `caputchin_delete_game_preset` | Elimina un preset de juego. Alpha+. | edit (sitio) o manage (equipo) |
| `caputchin_set_game_default` | Fija el preset de juego por defecto para un eje. Alpha+. | edit (sitio) o manage (equipo) |
| `caputchin_get_custom_game_schema` | El esquema de campos de un juego a medida para un alcance. | read |
| `caputchin_set_custom_game_schema` | Fija el esquema de campos de un juego a medida. Alpha+. | edit (sitio) o manage (equipo) |
| `caputchin_delete_custom_game_schema` | Elimina el esquema de campos de un juego a medida. Alpha+. | edit (sitio) o manage (equipo) |
| `caputchin_upload_custom_game_run` | Sube el artefacto de ejecución headless de un juego a medida. | edit (sitio) o manage (equipo) |
| `caputchin_get_custom_game_run` | Obtiene la referencia al artefacto de ejecución guardado de un juego a medida. | read |
| `caputchin_delete_custom_game_run` | Elimina el artefacto de ejecución de un juego a medida. | edit (sitio) o manage (equipo) |

## White-label

Hacer white-label del shell del widget es una función de **Apex**. Como con la personalización de juego, un cambio acotado al sitio necesita `edit` y uno de todo el equipo necesita `manage`.

| Herramienta | Hace | Permiso |
|---|---|---|
| `caputchin_list_white_label_presets` | Presets de white-label para un alcance. | read |
| `caputchin_set_white_label_preset` | Crea o actualiza un preset de white-label. Apex. | edit (sitio) o manage (equipo) |
| `caputchin_delete_white_label_preset` | Elimina un preset de white-label. Apex. | edit (sitio) o manage (equipo) |
| `caputchin_set_white_label_default` | Fija el preset de white-label por defecto para un eje. Apex. | edit (sitio) o manage (equipo) |

## Véase también

- [Usa el servidor MCP](/docs/automation/mcp): conectar un agente por cualquiera de los dos transportes.
- [Permisos y alcance](/docs/troops/permissions): el modelo read / create / edit / manage que usa la tabla de arriba.
- [Referencia interactiva de la API](/docs/api-reference): el esquema exacto de la operación detrás de cada herramienta.