Acciones disponibles
Las 23 herramientas MCP para proyectos, casos de prueba, planes de pruebas, ejecuciones, entornos e incidencias.
Autonomy MCP tiene 23 herramientas, una por cada operación de la API HTTP, con los mismos argumentos, resultados y reglas. El nombre de una herramienta es autonomy_ más el nombre de la operación con los puntos sustituidos por guiones bajos: run.get es autonomy_run_get.
Proyectos
| Herramienta | Para qué sirve |
|---|---|
autonomy_project_list | Lista los proyectos a los que tienes acceso. Empieza por aquí para obtener el projectId que usan las demás herramientas. |
autonomy_project_get | Obtiene un proyecto, con su conocimiento del producto. |
Casos de prueba
| Herramienta | Para qué sirve |
|---|---|
autonomy_test_case_list | Lista los casos de prueba, del más reciente al más antiguo. Filtra por projectId, platform o una búsqueda por nombre (query). Úsala antes de crear un caso para reutilizar la cobertura existente. |
autonomy_test_case_get | Obtiene un caso de prueba con sus pasos y sus adjuntos. |
autonomy_test_case_create | Crea un caso de prueba en un proyecto a partir de pasos escritos como resultados esperados. |
autonomy_test_case_update_steps | Sustituye la lista completa de pasos de un caso de prueba. Siempre necesita confirm: true. |
autonomy_test_case_archive | Archiva un caso de prueba. Se conservan sus ejecuciones y sus resultados. |
Cada paso es un resultado esperado en palabras sencillas (text), con un id estable y attachments opcionales: account, inbox, phone, file, screenshot o data. Los adjuntos son datos de prueba salvo que exact sea true. Un adjunto data puede llevar un value (incluido {{env.NAME}}) o un intent, como «Una contraseña segura», para que el agente elija uno. Con secret: true, el valor es de solo escritura. Consulta Pasos como resultados esperados para ver todos los campos y límites.
Planes de pruebas
| Herramienta | Para qué sirve |
|---|---|
autonomy_test_plan_list | Lista los planes de pruebas. Filtra por projectId o una búsqueda por nombre (query). |
autonomy_test_plan_get | Obtiene un plan de pruebas con sus casos de prueba en orden. |
autonomy_test_plan_create | Crea un plan de pruebas en un proyecto, opcionalmente con sus primeros casos de prueba. |
autonomy_test_plan_set_members | Sustituye los casos de prueba de un plan de pruebas. Necesita confirm: true cuando se quitarían casos. |
Ejecuciones
| Herramienta | Para qué sirve |
|---|---|
autonomy_run_trigger | Pone en cola ejecuciones de un caso de prueba o de un plan de pruebas, en un entorno guardado o contra objetivos nuevos. Responde al momento. |
autonomy_run_list | Lista las ejecuciones recientes, de la más nueva a la más antigua. Filtra por projectId, testCaseId, status, environmentSlug o branch. Consúltala antes de lanzar trabajo duplicado. |
autonomy_run_get | Obtiene el resultado de una ejecución, el resultado de cada paso y lo que creó. Espera un cambio con cursor y waitMs. |
autonomy_run_step_actions | Lista todo lo que hizo el agente para alcanzar el resultado esperado de cada paso, incluido el Final check. Los valores que guardaste como secretos se enmascaran. |
autonomy_run_evidence | Obtiene el resultado esperado, el resultado, la explicación y el Final check de cada paso, con enlaces de corta duración a capturas y vídeo. |
Entornos
| Herramienta | Para qué sirve |
|---|---|
autonomy_environment_list | Lista los entornos con sus objetivos de plataforma. Se muestran los nombres de los valores, nunca los valores. |
autonomy_environment_get | Obtiene un entorno por su slug. |
autonomy_environment_upsert | Crea un entorno en un proyecto o actualiza uno por su slug. Actualizar necesita confirm: true. |
Incidencias
| Herramienta | Para qué sirve |
|---|---|
autonomy_issue_list | Lista las incidencias, de la más reciente a la más antigua. Filtra por projectId, environmentSlug, status, kind o runId para ver las incidencias de una ejecución. |
autonomy_issue_create | Registra un Bug o un Risk en el entorno donde se detectó, citando ejecuciones con runIds. |
autonomy_issue_comment | Añade un comentario en texto plano a una incidencia. |
autonomy_issue_set_status | Cambia una incidencia a abierta, resuelta o ignorada. |
Una incidencia nunca cambia el resultado de una ejecución ni de un paso.
Entradas adicionales en MCP
Todas las herramientas aceptan además:
response_format:"markdown"(el valor predeterminado) o"json". Ambos llegan con el mismo resultado estructurado; solo cambia el texto que lee el asistente. Un texto muy largo se corta a los 24 000 caracteres; usa filtros más precisos o unlimitmenor.idempotencyKey(herramientas que cambian algo): opcional en MCP. Si el cliente no lo envía, Autonomy genera uno nuevo en cada llamada, así que una llamada reintentada no se reconoce como repetición y puede hacer el trabajo dos veces. Pasa tu propia clave cuando un reintento no deba repetir el cambio, como enautonomy_run_trigger.
Los errores llegan como un error de herramienta con el texto <CODE>: <message>, con los mismos códigos de error que la API HTTP.
Confirmar sustituciones
Autonomy no hace una segunda pregunta dentro de MCP. Las herramientas que sustituirían algo necesitan confirm: true:
autonomy_test_case_update_steps, siempre, porque sustituye la lista completa de pasos.autonomy_test_plan_set_members, cuando se quitarían casos de prueba.autonomy_environment_upsert, cuando el slug existe y se envían campos u objetivos.
Sin confirmación no se escribe nada. La herramienta devuelve INVALID_ARGUMENT con confirmRequired: true y un resumen wouldChange. Lee el resumen, enséñaselo a la persona si es relevante y solo entonces vuelve a llamar con confirm: true. No añadas la confirmación por inercia.
Seguir una ejecución
- Iníciala. Llama a
autonomy_run_triggercon untestCaseId(otestPlanId) y unenvironmentSlugotargets. Guarda losrunIds. - Espera. Llama a
autonomy_run_getcon elrunId. Guarda elcursor. Mientrasnextseawait, vuelve a llamar con esecursorywaitMs: 25000.timedOut: truesolo significa que no cambió nada durante la espera: vuelve a llamar. - Mira lo que hizo el agente. Llama a
autonomy_run_step_actions, constepIndexpara centrarte en un paso. Mientras la ejecución está en curso, vuelve a leer desde el principio cada vez que cambierunCursor. - Lee la evidencia. Cuando la ejecución termine, y sobre todo cuando
nextseaevidence, llama aautonomy_run_evidence. Cada paso tiene su resultado esperado, su resultado, su explicación, su Final check y sus enlaces a medios. Los enlaces caducan a los 15 minutos; vuelve a llamar a la herramienta para obtener otros nuevos. - Revisa las incidencias. Llama a
autonomy_issue_listcon elrunIdpara ver las incidencias que encontró o mostró la ejecución. Se mantienen separadas del resultado.
next es un consejo, no la autoridad. Decide según status y los pasos. Una ejecución termina como passed, failed, couldnt_start o cancelled. La explicación de un paso fallido indica si no se alcanzó el resultado esperado o si el agente no pudo demostrar que se alcanzó; léela antes de tratar el fallo como un bug. Un paso con failureCategory: "runner" falló por Autonomy, no por la app. Consulta Ejecuciones y evidencia para ver todos los campos.
Objetivos de ejecución
autonomy_run_trigger acepta platforms entre web, api, ios y android. Usa environmentSlug cuando el objetivo esté guardado, o targets para un despliegue o una compilación nuevos, pero no ambos.
| Plataforma | Campos del objetivo |
|---|---|
| Web | targets.web.baseUrl |
| API | targets.api.baseUrl, targets.api.runtimeValues opcional |
| iOS (próximamente) | targets.ios.bundleId, más targets.ios.artifactUrl o un targets.ios.storageId escaneado |
| Android | targets.android.packageName, más targets.android.artifactUrl o un targets.android.storageId escaneado |
Añade branch, pr y deployment.commitSha para vincular las ejecuciones a una pull request o a un commit.
Permisos OAuth
| Permiso | Herramientas |
|---|---|
autonomy:read | Todas las herramientas de listado y de obtención, autonomy_run_step_actions, autonomy_run_evidence |
autonomy:test_cases:write | autonomy_test_case_create, autonomy_test_case_update_steps, autonomy_test_case_archive |
autonomy:test_plans:write | autonomy_test_plan_create, autonomy_test_plan_set_members |
autonomy:runs:write | autonomy_run_trigger |
autonomy:environments:write | autonomy_environment_upsert |
autonomy:issues:write | autonomy_issue_create, autonomy_issue_comment, autonomy_issue_set_status |
Consulta Acceso a la organización para ver cómo aparece cada permiso en la pantalla de consentimiento.
Recetas para agentes
Comprobar la cobertura existente
Use Autonomy MCP to find the project for this repository, then list its relevant test cases, test plans and recent runs.
If a run already exists for this branch or PR, summarize its status before starting anything new.Ejecutar en la previsualización de una PR
Use Autonomy MCP to run the relevant test case against this preview URL.
Pass the branch, PR number and commit SHA, and your own idempotencyKey. Wait for the run to finish, then summarize each step's result and explanation.Diagnosticar una ejecución que no se superó
Fetch the Autonomy run, its Step Actions and its evidence before proposing a fix.
Cite the step, its explanation, the Final check and a media link that support your conclusion.
List any issues the run found.¿No lo encontraste?
Primera ejecución de MCP
Encuentra tu proyecto, escribe un caso de prueba con pasos como resultados esperados, ejecútalo, síguelo y lee sus Step Actions y sus incidencias.
Solución de problemas
Resuelve problemas de URL del servidor, inicio de sesión, organización, permisos y proyectos que no aparecen en Autonomy MCP.