API de Jira: incidencias, proyectos y flujos con agentes de IA
La API REST de Jira Cloud permite crear, buscar y actualizar incidencias, mover tarjetas entre estados, comentar y administrar proyectos. La usan equipos de ingeniería, producto y servicios para integrar Jira con otros sistemas. El acceso es por la cuenta de Atlassian, con un token de API o una aplicación OAuth.
Qué ofrece la API de Jira
Incidencias
Crear, editar, buscar y eliminar incidencias, con campos personalizados y archivos adjuntos.
Búsqueda con JQL
Consultar incidencias con el lenguaje de consulta de Jira, por proyecto, estado, responsable o fecha.
Transiciones y flujos
Mover incidencias entre estados respetando el workflow configurado.
Comentarios y registros de trabajo
Añadir comentarios y registrar las horas trabajadas.
Proyectos, sprints y tableros
Consultar proyectos y, mediante la API de software, sprints y boards.
Webhooks
Recibir eventos de creación y actualización de incidencias.
Cómo acceder a la API de Jira
- Con las credenciales de tu empresaEn Jira Cloud se usa un token de API de la cuenta de Atlassian (junto con el correo) o una aplicación OAuth 2.0 con ámbitos. En Jira Data Center, un token de acceso personal.
- Jira Cloud aplica límites de solicitudes: el agente usa búsquedas con JQL en lugar de leer incidencia por incidencia.
- Usa un usuario de integración, no la cuenta de una persona, para que la auditoría quede clara.
- Los cambios masivos (transiciones, eliminaciones) pasan por aprobación.
Documentación oficial: developer.atlassian.com/cloud/jira/platform/rest/v3
Qué hace un agente de iTeam con la API de Jira
Ticket bien escrito desde el inicio
El agente recibe el reporte en Teams, pregunta lo que falta (pasos, entorno, captura) y abre la incidencia ya con la plantilla del equipo.
Resumen del sprint para la dirección
El viernes, el agente lee el sprint con JQL y escribe lo que se entregó, lo que se retrasó y por qué.
Duplicadas detectadas
Antes de abrir una incidencia nueva, el agente busca casos parecidos y sugiere vincularlos en lugar de duplicar.
Seguimiento de incidencias paradas
Las incidencias sin movimiento desde hace días reciben un comentario del agente que menciona al responsable, con el contexto.
De la credencial al agente trabajando, con aprobación
Crea el acceso en Atlassian
Crea un usuario de integración en Jira con permiso solo en los proyectos necesarios y genera el token de API (o registra una aplicación OAuth).
Registra la credencial en la bóveda de iTeam
La credencial de Jira queda en la bóveda de iTeam, fuera de prompts y hojas de cálculo. Cada agente recibe solo las acciones que necesita (buscar con JQL, comentar, crear una incidencia), y lo que escribe datos pasa por aprobación.
Prueba con aprobación humana
Antes de habilitarlo, pide al agente que abra una incidencia en un proyecto de prueba. Durante las primeras semanas, las acciones de escritura requieren aprobación y todo queda en la auditoría.
Equipos de IA listos que usan Jira
Preguntas sobre la API de Jira
¿La API de Jira es gratuita?
La API está incluida en los planes de Jira, también en el gratuito, dentro de los límites de uso de Atlassian. El costo es el de la licencia de los usuarios.
¿Necesito programar para usar la API de Jira con iTeam?
No necesariamente. La herramienta HTTP de iTeam aprende los endpoints de la API de Jira a partir de la documentación, y el equipo de implantación configura las credenciales, los permisos y el proceso. Tu equipo valida el resultado.
¿Jira tiene un servidor MCP?
Atlassian ofrece un servidor MCP remoto para Jira y Confluence. iTeam puede usarlo o llamar directamente a la API REST, según los permisos que la empresa quiera habilitar.
