AIO Tests MCP Server

Un servidor MCP de código abierto para AIO Tests — gestión de pruebas para Jira.

Conecta Claude, Claude Code, Cursor, VS Code, Windsurf o cualquier otro cliente MCP a tus casos de prueba de Jira. Búscalos y léelos, inspecciona el esquema de campos de un proyecto, navega por el árbol de carpetas y crea o actualiza casos — Clásicos y BDD — en conversación natural.

Funciona con Jira Cloud y Jira Server / Data Center. Autohospedado, por lo que tus credenciales y datos de prueba nunca salen de tu infraestructura.

uvx aio-tests-mcp-server

Aún no está en PyPI. El comando uvx de arriba estará disponible con la primera versión. Hasta entonces, usa Ejecutar desde el código fuente — solo requiere dos comandos.

Por qué existe esto. El servidor MCP oficial de AIO Tests es un servicio cerrado y alojado remotamente con una URL específica de inquilino y soporte solo para Cloud. Este es autohospedable y auditable — puedes leer cada línea, hacer un fork y ejecutarlo dentro de tu propia red. Es, hasta donde sé, el único servidor MCP de AIO Tests que soporta Jira Server / Data Center, y tiene un modo de solo lectura para que puedas apuntar una IA a una instancia de producción de forma segura.

Herramientas

Diez herramientas, todas limitadas a un proyecto de Jira.

Los campos de búsqueda aceptan nombres o IDs. Puedes decir "Critical" en lugar de 4, o /Regression/Checkout en lugar de un ID de carpeta — los valores se resuelven contra la configuración del proyecto, por lo que el modelo trabaja con el mismo vocabulario que ves en la interfaz de AIO Tests.

Las actualizaciones conservan el formato. Las actualizaciones de casos hacen un viaje de ida y vuelta del documento con texto enriquecido habilitado, por lo que el formato de los campos que no tocaste sobrevive, y la entrada de texto plano se escapa para coincidir.

Related MCP server: jira-aio-mcp-server

Inicio rápido

1. Obtén un token de acceso

Jira Cloud — en Jira, abre AIO Tests → icono (?) → API Access Token y genera uno. El token identifica tu inquilino, por lo que no se necesita URL.

Jira Server/Data Center — la API de AIO Tests se sirve desde tu URL base de Jira y reutiliza tus credenciales de Jira (un token de acceso personal, o nombre de usuario + contraseña).

2. Añádelo a tu cliente MCP

{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_API_TOKEN": "your_aio_access_token"
      }
    }
  }
}

{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_ENABLED": "true",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_personal_access_token"
      }
    }
  }
}

El mismo JSON de arriba, en el archivo de configuración MCP del cliente (~/.cursor/mcp.json para Cursor, .vscode/mcp.json para VS Code). Cursor también acepta un mcp.json local al proyecto.

En Claude Code puedes añadirlo con un solo comando:

claude mcp add aio-tests --env AIO_API_TOKEN=your_token -- uvx aio-tests-mcp-server

3. Pide algo

"Busca en PROJ casos de prueba publicados etiquetados con smoke en /Regression/Checkout, y muéstrame los pasos del primero."

"Lee PROJ-142 y escribe casos de prueba BDD que cubran los criterios de aceptación."

Configuración

Cada ajuste es una variable de entorno; consulta .env.example para la lista completa. Los esenciales:

También se admiten ajustes de proxy (AIO_HTTP_PROXY, AIO_HTTPS_PROXY, AIO_SOCKS_PROXY, AIO_NO_PROXY), certificados de cliente y cabeceras personalizadas.

Las mismas opciones están disponibles como banderas de CLI:

uvx aio-tests-mcp-server --help

Modo de solo lectura

Si apuntas una IA a un Jira de producción, probablemente quieras que mire, no que toque:

uvx aio-tests-mcp-server --read-only

Las herramientas de escritura se ocultan por completo de la lista de herramientas, por lo que el modelo nunca las ve.

Transporte HTTP

Para despliegues compartidos o contenedorizados, ejecútalo sobre HTTP Streamable en lugar de stdio:

uvx aio-tests-mcp-server --transport streamable-http --port 8000

El servidor expone /mcp y un endpoint /healthz para sondas de Kubernetes.

Uso multiinquilino

Una instancia de servidor puede atender a varios usuarios. Cada cliente envía su propio token de AIO Tests por solicitud, y la solicitud se limita a ese inquilino:

{
  "mcpServers": {
    "aio-tests": {
      "url": "https://aio-mcp.your-company.com/mcp",
      "headers": {
        "X-Aio-Api-Token": "the_users_own_token"
      }
    }
  }
}

Authorization: Token <token> funciona como equivalente a la cabecera X-Aio-Api-Token.

Ejecutar desde el código fuente

git clone https://github.com/AmirhosseinHanifehzadeh/aio-tests-mcp.git
cd aio-tests-mcp
uv sync
cp .env.example .env   # then fill it in
uv run aio-tests-mcp-server

Ejecuta las pruebas:

uv run pytest

Limitaciones

• No se implementan el renombrado, movimiento y eliminación de carpetas. La API pública de AIO Tests no expone ningún endpoint para ellos.

• Los ciclos de prueba y las ejecuciones de prueba aún no están cubiertos. El conjunto de herramientas actual se limita a la gestión de casos de prueba — casos, carpetas, etiquetas y esquema de proyecto. Se aceptan contribuciones.

Preguntas frecuentes

¿Es este el servidor MCP oficial de AIO Tests? No. AIO Tests publica su propio servidor MCP como un servicio alojado — código cerrado, con una URL específica de inquilino y solo Cloud. Esta es una implementación independiente y de código abierto que ejecutas tú mismo. No está afiliada ni respaldada por AIO Tests o Atlassian.

¿Funciona con Jira Data Center o Jira Server? Sí. Establece AIO_ENABLED=true y JIRA_URL, y autentícate con un token de acceso personal de Jira o nombre de usuario y contraseña. En Server/DC, la API de AIO Tests se sirve desde tu URL base de Jira, por lo que reutiliza tus credenciales de Jira. Esta es la razón principal para elegir este servidor sobre las alternativas — los alojados son solo Cloud.

¿Puedo usarlo con Claude Code, Claude Desktop, Cursor o VS Code? Sí — cualquier cliente MCP funciona. Consulta Añádelo a tu cliente MCP para una configuración lista para pegar.

¿Es seguro apuntarlo a Jira de producción? Ejecútalo con --read-only (o READ_ONLY_MODE=true). Las herramientas de escritura se filtran por completo de la lista de herramientas, por lo que el modelo nunca ve que crear o actualizar sea una opción.

¿A dónde van mis credenciales? A ningún lugar excepto a tu propia máquina y a tu instancia de Jira. El servidor se ejecuta localmente sobre stdio por defecto y habla directamente con la API REST de AIO Tests. No hay ningún servicio intermediario.

¿Puede una instancia de servidor atender a todo un equipo? Sí — ejecútalo sobre HTTP y haz que cada cliente envíe su propio token en la cabecera X-Aio-Api-Token. Consulta Uso multiinquilino.

¿Soporta ciclos de prueba, ejecuciones o adjuntos? Aún no. El conjunto de herramientas actual cubre la gestión de casos de prueba — casos, carpetas, etiquetas y esquema de proyecto. Los ciclos y las ejecuciones son el siguiente paso obvio; consulta Limitaciones, y se aceptan incidencias.

Contribuciones

Las incidencias y las solicitudes de extracción son bienvenidas — consulta CONTRIBUTING.md. La suite de pruebas cubre el cliente, la resolución de configuración, cada mixin y cada herramienta; por favor, mantenla en verde y añade casos para el nuevo comportamiento.

Licencia

MIT.

Partes de este proyecto se derivan de mcp-atlassian por @sooperset, también con licencia MIT. Gracias por la base.

Este proyecto no está afiliado ni respaldado por AIO Tests o Atlassian.