Automatización
Referencia de herramientas MCP
Estas son las herramientas que el servidor 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, así que el permiso que una herramienta necesita es el permiso que esa operación necesita; el 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.
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 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); 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.
| 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 |
| 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) |
| 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). | read |
caputchin_update_troop_security | Fija el techo de forzar-juego para el equipo. | manage |
| 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). | read |
caputchin_update_site_security | Conmuta el gate de exigir-juego por clave. | edit |
caputchin_list_site_sessions | Sesiones de verificación recientes de una clave. | read |
| 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 |
| 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 |
| 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 |
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) |
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) |
