Solución de problemas

La mayoría de los problemas de MCP tienen una de estas tres causas: la URL del servidor es incorrecta, la cuenta con la que se inició sesión no es la correcta o la organización no es la correcta. Compruébalas antes de cambiar la configuración del cliente.

URL del servidor incorrecta

Comprueba que el cliente usa https://app.autonomyqa.com/api/mcp, terminada en /api/mcp.

Clave de API rechazada

MCP no acepta claves de API de organización (aut_…). Quita cualquier cabecera Authorization o clave de la configuración MCP del cliente y deja que inicie sesión a través del navegador. Las claves de API son para la API HTTP.

Bucle de inicio de sesión o enlace caducado

El enlace de inicio de sesión de un cliente funciona una sola vez y solo durante unos minutos. Si la página dice "This link has expired", vuelve a iniciar la conexión desde el cliente. Si el bucle continúa, cierra la sesión de Autonomy QA en el navegador, elimina la conexión en el cliente y vuelve a conectarte.

Organización incorrecta o ausente

Cada conexión llega a una organización: la que elegiste al autorizarla. Para llegar a otra, vuelve a conectar el cliente y elige esa organización. Si la página indica que tu cuenta todavía no pertenece a ninguna organización, crea una en Autonomy QA o pide que te inviten, y vuelve a conectarte.

Proyectos que no aparecen

El asistente de un miembro solo llega a los proyectos que ese miembro puede abrir. Si autonomy_project_list no muestra un proyecto, pide a un administrador de la organización que te dé acceso y vuelve a intentarlo. Los propietarios y administradores llegan a todos los proyectos.

Errores de permisos

Una herramienta que devuelve FORBIDDEN: This operation requires the <scope> scope. se llamó sin ese permiso. Cuando el cliente vuelva a conectarse, aprueba el permiso que pide. Si la pantalla de consentimiento no lo muestra, el cliente no lo solicitó; revisa la configuración del cliente.

Proyecto o entorno equivocado

Las ejecuciones usan entornos del mismo proyecto que el caso de prueba. Si una ejecución no encuentra su entorno, lista los entornos del proyecto con autonomy_environment_list y usa uno de sus slugs.

Caché del cliente

Algunos clientes guardan en caché su inicio de sesión. Si el flujo del navegador se completa pero las herramientas siguen sin funcionar, elimina el servidor de Autonomy del cliente, reinicia el cliente y vuelve a añadir el servidor.