Integración con Jira Cloud

La integración con Jira Cloud conecta un sitio de Jira Cloud con tu organización de Probara. Una vez conectado el sitio y vinculado un proyecto, tu equipo puede crear incidencias de Jira a partir de defectos de Probara, vincular incidencias que ya existen y mantener sincronizados el estado, la prioridad y los comentarios en ambos sentidos. Los casos de prueba se pueden vincular a historias y épicas de Jira para la trazabilidad, y un panel Probara en cada incidencia de Jira muestra dentro de Jira los casos, resultados y defectos vinculados.

Esta guía cubre la configuración: instalar la aplicación, conectar un sitio, elegir los proyectos de Jira que Probara puede usar y vincularlos a tus proyectos de Probara, uno a uno o con una vinculación predeterminada de la organización. Para el día a día:

Guía	Trata
Incidencias de Jira desde defectos	Crear y vincular incidencias, y qué se sincroniza en cada sentido
Trazabilidad con Jira	Vincular casos de prueba a incidencias de Jira y crear informes de trazabilidad
El panel de Probara en Jira	Qué ven los usuarios de Jira en una incidencia y cómo vincular casos desde Jira

Antes de empezar

Necesitas	Por qué
Un plan de pago (Pro o Enterprise, o una prueba Pro)	Las integraciones no forman parte del plan Free. En Free, el diálogo de Jira muestra Ver planes en lugar de Instalar.
Un administrador del sitio de Jira	Solo un administrador del sitio de Jira puede instalar la aplicación e iniciar la conexión en Jira.
Un propietario o administrador de Probara	Solo los propietarios y administradores de la organización pueden aprobar la conexión y vincular proyectos.
Un sitio de Jira Cloud (`https://<tu-sitio>.atlassian.net`)	Jira Data Center y Jira Server no son compatibles.

El administrador de Jira y el de Probara pueden ser la misma persona. La conexión exige ambos lados a propósito: nadie puede asociar tu sitio de Jira a una organización de Probara, ni tu organización de Probara a un sitio de Jira, desde un solo lado.

Conectar un sitio de Jira

Abre la aplicación de Jira en Probara. En Espacio de trabajo › Integraciones, selecciona la tarjeta Jira Cloud. El diálogo muestra lo que puede hacer la aplicación y los tres pasos de conexión.
Instala la aplicación en Jira. Selecciona Instalar. Se abre en una pestaña nueva la página de instalación de Probara for Jira, donde un administrador del sitio de Jira completa la instalación. Si Instalar aparece deshabilitado con el mensaje «El enlace de instalación aún no está disponible en este entorno.», la aplicación todavía no está publicada para tu entorno: contacta con el soporte de Probara.
Inicia la conexión desde Jira. En Jira, abre Apps › Probara (Aplicaciones › Probara si usas Jira en español), la página de administración de la aplicación, y selecciona Connect with Probara. Esa página de Jira está solo en inglés. Jira comprueba que eres administrador del sitio y abre Probara en una pestaña nueva. La página de Jira pasa a Waiting for approval in Probara… y se actualiza sola.
Apruébala en Probara. Inicia sesión si se te pide. Si perteneces a varias organizaciones, elige la que quieres conectar en Espacio de trabajo que se conectará; esto también cambia tu espacio de trabajo activo. Probara pregunta «¿Conectar tu-sitio.atlassian.net con tu organización?» y muestra cuándo caduca el enlace. Selecciona Conectar.
Comprueba ambos lados. Probara muestra Jira está conectado; la página de Jira muestra Connected to tu organización. El sitio aparece en Sitios conectados dentro del diálogo de Jira, con el estado Activo.

El enlace de conexión es válido durante 10 minutos y funciona una sola vez. Si caduca, la página de Jira muestra The connection link expired: selecciona Start again para obtener uno nuevo. Empezar de nuevo también anula cualquier enlace anterior.

Más de un sitio de Jira

Una organización puede conectar varios sitios de Jira: repite los pasos desde cada sitio. Un sitio de Jira se conecta a una sola organización de Probara a la vez. Si el sitio ya está conectado a otra, Probara responde «Este sitio de Jira ya está conectado a otro espacio de trabajo.»; desconéctalo allí primero.

Elegir qué proyectos de Jira puede usar Probara

Cada sitio conectado tiene una lista de Proyectos de Jira permitidos. Probara no lee, no vincula a tus proyectos, no crea incidencias ni vincula incidencias de un proyecto de Jira que no esté en la lista, y solo busca en los proyectos permitidos.

Para cambiarla, selecciona Editar proyectos en el sitio, escribe las claves de proyecto separadas por comas (por ejemplo WEB, API) y selecciona Guardar. Las claves no distinguen mayúsculas de minúsculas; un sitio puede permitir hasta 100 proyectos.
Una lista vacía no es una restricción: en ese caso Probara puede usar todos los proyectos que la aplicación ve en Jira, y el sitio muestra Todos los proyectos. Para limitar Probara a proyectos concretos, enuméralos.
La lista también decide qué ven los usuarios de Jira. En las incidencias de un proyecto permitido, el panel de Probara muestra a todos los que pueden ver la incidencia los datos de Probara vinculados a ella; consulta El panel de Probara en Jira.
Quitar un proyecto de la lista no elimina las vinculaciones ni los vínculos existentes; solo impide trabajo nuevo en ese proyecto.

Vincular un proyecto de Jira a un proyecto de Probara

Un proyecto de Probara registra sus defectos en los proyectos de Jira vinculados a él. Puedes vincular en dos niveles:

Nivel	Dónde	Se aplica a
Predeterminada de la organización	Espacio de trabajo › Integraciones › Jira Cloud, Vinculación predeterminada	Cada proyecto que no tiene una vinculación propia
Proyecto	Configuración › Jira del proyecto	Solo a ese proyecto; entonces ignora la predeterminada de la organización

Para vincular un proyecto:

Abre la Configuración del proyecto y selecciona la pestaña Jira. (La pestaña solo se muestra a propietarios y administradores.)
Selecciona Añadir proyecto de Jira. Si la organización tiene varios sitios activos, elige el Sitio de Jira.
Busca el Proyecto de Jira por nombre o clave y selecciónalo.
Elige el Tipo de incidencia en el que se convierten tus defectos en Jira (por ejemplo, Bug o Error). No se ofrecen subtareas.
Revisa las secciones siguientes y selecciona Guardar vinculación.

Un proyecto de Probara puede vincular varios proyectos de Jira, incluso de sitios distintos. Uno de ellos puede ser el predeterminado: aparece preseleccionado al crear una incidencia y es el que se usa cuando alguien registra una incidencia de Jira al reportar un defecto desde una ejecución. La primera vinculación es la predeterminada, salvo que desmarques Usar como proyecto de Jira predeterminado del proyecto; usa Hacer predeterminado en la lista para cambiarlo después.

Definir una vinculación predeterminada para la organización

Si la mayoría de los proyectos registran defectos en el mismo proyecto de Jira, vincúlalo una sola vez para toda la organización:

En Espacio de trabajo › Integraciones, selecciona la tarjeta Jira Cloud. La sección Vinculación predeterminada aparece debajo de Sitios conectados en cuanto hay un sitio conectado, y se mantiene mientras existan vinculaciones predeterminadas para que puedas quitarlas después de desconectar (propietarios y administradores, planes de pago).
Selecciona Añadir proyecto de Jira y completa el mismo diálogo que para un proyecto. Su casilla dice Usar como proyecto de Jira predeterminado de la organización.
Selecciona Guardar vinculación.

Cómo usan los proyectos la predeterminada:

Un proyecto sin vinculación propia la usa de inmediato. Los cambios en la predeterminada se aplican a esos proyectos al instante. Su pestaña Jira la muestra como Heredado de la organización.
La vinculación propia de un proyecto sustituye por completo a la predeterminada. Selecciona Personalizar para este proyecto en una fila heredada (o Añadir proyecto de Jira) y guarda: el proyecto pasa a usar solo sus propias vinculaciones, nunca una mezcla con la predeterminada.
Quitar la última vinculación de un proyecto hace que vuelva a usar la predeterminada de la organización.
Quitar una vinculación predeterminada impide que los proyectos que la usan registren defectos nuevos en ese proyecto de Jira. Las incidencias ya vinculadas conservan su vínculo.

Las secciones siguientes funcionan igual en los dos niveles.

Estado de Jira a Probara

Cuando una incidencia de Jira cambia de estado fija el estado del defecto vinculado según la categoría de estado de Jira:

Categoría de estado de Jira	Estado de Probara predeterminado
Por hacer	Abierto
En curso	En progreso
Listo	Resuelto

En Reglas para estados concretos de Jira puedes dar a un estado de Jira su propio estado de Probara; por ejemplo, llevar el estado «Won’t Do» de Jira a Cerrado. Un estado que queda en Seguir su categoría usa la tabla anterior.

Estado de Probara a Jira

Cuando un defecto cambia de estado permite elegir, para cada estado de Probara, el estado de Jira al que pasa la incidencia vinculada. Todos los estados empiezan en No cambiar, que nunca mueve la incidencia.

Probara mueve la incidencia a través de tu flujo de trabajo de Jira: usa una transición que lleve al estado elegido desde donde está la incidencia. Si el flujo no ofrece ninguna, la incidencia se queda donde está y el vínculo no se marca como fallido. Los cambios que vinieron de Jira nunca se devuelven.

Prioridad y severidad

Prioridad: elige la prioridad de Jira para cada prioridad de defecto de Probara. Una incidencia nueva recibe la prioridad vinculada, cambiar la prioridad en Probara actualiza la incidencia, y cuando alguien la cambia en Jira, el defecto sigue la misma correspondencia a la inversa. Una prioridad en No asignar no se envía, y una prioridad de Jira sin correspondencia no cambia el defecto.
Severidad: Jira no tiene una severidad propia. Elige uno de tus campos personalizados de selección única de Jira en Campo de Jira para la severidad y asigna cada severidad de Probara a una de sus opciones. A partir de ahí se sincroniza en ambos sentidos, como la prioridad. Déjalo en No sincronizar la severidad para mantener la severidad solo en Probara.

Campos obligatorios de Jira

Si tu proyecto de Jira exige campos en las incidencias nuevas (un componente, un equipo, un campo personalizado), Campos obligatorios de Jira los muestra. Completa los valores que Probara debe enviar en cada incidencia creada con esta vinculación. Los campos que Jira completa por sí mismo si se dejan vacíos aparecen indicados y no necesitan valor. Si Probara no puede completar un tipo de campo, dale un valor predeterminado en Jira.

Probara siempre fija por su cuenta el resumen, la descripción, el proyecto y el tipo de incidencia.

Desconectar o desinstalar

Quieres	Haz esto	Qué ocurre
Dejar de sincronizar desde Probara	En Espacio de trabajo › Integraciones › Jira Cloud, selecciona Desconectar en el sitio y confirma.	El sitio sale de la lista. No se cambia nada en Jira. Los vínculos existentes siguen en tus defectos, pero dejan de actualizarse.
Dejar de sincronizar desde Jira	En Jira, Apps › Probara, selecciona Disconnect y luego Disconnect site.	El mismo resultado. Queda registrado en tu actividad como hecho por el sistema, con la cuenta de Jira.
Quitar la aplicación	Un administrador de Jira desinstala Probara for Jira.	El sitio se desconecta de Probara y Probara descarta las credenciales de la aplicación.

Para volver a conectar, empieza desde Jira con Connect with Probara. Reinstalar la aplicación no vuelve a conectar un sitio por sí solo: un propietario o administrador de Probara debe aprobarlo de nuevo.

Las vinculaciones de un sitio desconectado siguen en la pestaña Jira del proyecto (o en la Vinculación predeterminada de la organización), marcadas como Sitio desconectado, hasta que las quites.

Solución de problemas de la conexión

Ves	Qué significa	Qué hacer
Un sitio marcado como Requiere atención	Probara no puede usar las credenciales del sitio, normalmente porque hace tiempo que no recibe noticias de la aplicación, o porque la aplicación se quitó de Jira sin que Probara se enterara.	Abre Apps › Probara en Jira: cualquier visita entrega a Probara credenciales nuevas, y la aplicación las renueva sola cada hora. Si la aplicación se desinstaló, instálala y vuelve a conectar.
«No se puede acceder a ningún sitio de Jira conectado» en la pestaña Jira de un proyecto	Todos los sitios conectados requieren atención.	Corrige el sitio como se indica arriba.
«Only Jira site administrators can connect or disconnect Probara.» (en Jira)	Tu cuenta de Jira no es administradora del sitio.	Pídeselo a un administrador del sitio de Jira.
«Pide a un propietario o administrador de organización que conecte Jira.»	Tu rol en Probara no puede aprobar conexiones.	Pide a un propietario o administrador que abra el enlace desde Jira.
«Este enlace no es válido o ha caducado. Vuelve a empezar desde Jira.»	El enlace ya se usó, caducó a los 10 minutos o lo reemplazó otro más nuevo.	Selecciona Start again en Jira.
«This Jira site cannot be connected yet.» (en Jira)	La instalación aún no está lista o sus credenciales todavía no se pueden usar.	Espera un minuto y vuelve a intentarlo, o reinstala la aplicación.
«Demasiados intentos. Espera un momento y vuelve a intentarlo.»	Los intentos de conexión tienen un límite por usuario y por sitio.	Espera y vuelve a intentarlo.
«La conexión con Jira está incluida en los planes de pago de Probara.»	Tu organización está en Free.	Cambia de plan y vuelve a empezar desde Jira.

Seguridad y datos

Credenciales. La única credencial que guarda Probara es el token propio de la aplicación en Jira, que Jira renueva cada hora. Se guarda cifrado (AES-256-GCM) y ligado a su instalación, solo lo usan los servidores de Probara y nunca se envía a tu navegador. Probara solo acepta llamadas de Jira que llevan un token firmado por Atlassian para esta aplicación.
El enlace de conexión. Es aleatorio, de un solo uso y válido durante 10 minutos. Probara solo guarda un hash del enlace, lo quita de la barra de direcciones en cuanto se abre la página, y esa página no envía la cabecera Referer.
Qué guarda Probara sobre tu sitio de Jira: la URL del sitio y el identificador de nube de Jira y, por cada vínculo, la clave, el identificador y la URL de la incidencia, su resumen, estado, prioridad y tipo. Los comentarios escritos en Jira en una incidencia vinculada se copian al defecto con el nombre visible de su autor en Jira; los comentarios restringidos (visibles solo para un grupo o rol de Jira) nunca se copian.
Qué escribe Probara en Jira: las incidencias que creas (con los datos del defecto y, si lo eliges, sus adjuntos); un enlace Probara en cada incidencia vinculada que apunta al defecto o al caso de prueba; una propiedad oculta de la incidencia que indica a la aplicación de qué incidencias debe enviar cambios; y, en los defectos vinculados, los cambios de estado, prioridad y severidad que envía tu vinculación, y los comentarios escritos en Probara. Los comentarios nombran a su autor y a las personas mencionadas solo por nombre y apellido; Probara nunca envía direcciones de correo a Jira.
Qué ven los usuarios de Jira: el panel de Probara en una incidencia muestra los datos de Probara vinculados a ella a todos los que Jira deja ver la incidencia, sin necesidad de una cuenta de Probara. Consulta El panel de Probara en Jira.
Eliminación. Eliminar la organización de Probara elimina sus vinculaciones de proyectos y predeterminadas, sus vínculos con incidencias y los comentarios copiados, incluidos los nombres de autores de Jira. Probara nunca elimina incidencias en Jira.
Auditoría. Conectar, desconectar, cambiar los proyectos permitidos, cambiar la vinculación de un proyecto o la predeterminada, y vincular o desvincular incidencias de Jira en defectos y casos de prueba quedan registrados en Actividad del workspace. Los vínculos hechos desde el panel de Jira aparecen como hechos por el sistema, con la cuenta de Jira.

Automatizar con la API y MCP

Los scripts, los trabajos de CI y los asistentes de IA pueden hacer el trabajo diario con Jira con un token de API o a través de Probara MCP. La configuración se queda a propósito en la aplicación web: conectar un sitio lo entrega a tu organización, y una vinculación decide adónde va cada defecto futuro, así que ninguna de las dos cosas debería poder hacerla un token filtrado.

Funciona con un token de API o MCP	Solo en la aplicación web (sesión iniciada)
Listar, crear, vincular, actualizar y desvincular las incidencias de Jira de un defecto	Conectar un sitio (emparejamiento)
Buscar en los proyectos de Jira que vincula un proyecto	Editar los proyectos permitidos, desconectar un sitio
Listar, vincular y desvincular las incidencias de Jira de un caso de prueba; vincular casos en bloque a una incidencia	Añadir, cambiar y quitar vinculaciones de proyectos y predeterminadas
Crear informes de trazabilidad y leer sus versiones y requisitos	Consultar los proyectos, estados y prioridades de Jira de un sitio para vincularlos
Leer las vinculaciones de un proyecto (propias o heredadas) y los tipos de incidencia y campos de un proyecto de Jira vinculado

Se aplican los mismos roles y el mismo plan que en la aplicación. Las herramientas MCP son list_defect_jira_issues, create_defect_jira_issue, link_defect_jira_issue, unlink_defect_jira_issue, list_test_case_jira_issues, link_test_case_jira_issue, unlink_test_case_jira_issue y search_jira_issues. Las herramientas de trazabilidad se describen en Trazabilidad con Jira. Todas las rutas y códigos de error están en la referencia de la API, en Integrations, y todas las herramientas en la referencia de herramientas MCP.