# Integración con Jira Cloud > Instala la aplicación de Probara en Jira, conecta un sitio de Jira a tu organización y vincula proyectos. 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](https://docs.probara.net/es/guides/integrations/jira-defects/) | Crear y vincular incidencias, y qué se sincroniza en cada sentido | | [Trazabilidad con Jira](https://docs.probara.net/es/guides/integrations/jira-traceability/) | Vincular casos de prueba a incidencias de Jira y crear informes de trazabilidad | | [El panel de Probara en Jira](https://docs.probara.net/es/guides/integrations/jira-panel/) | 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://.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 1. **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. 2. **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. 3. **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. 4. **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**. 5. **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](https://docs.probara.net/es/guides/integrations/jira-panel/#qué-pueden-ver-los-usuarios-de-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: 1. Abre la **Configuración del proyecto** y selecciona la pestaña **Jira**. (La pestaña solo se muestra a propietarios y administradores.) 2. Selecciona **Añadir proyecto de Jira**. Si la organización tiene varios sitios activos, elige el **Sitio de Jira**. 3. Busca el **Proyecto de Jira** por nombre o clave y selecciónalo. 4. Elige el **Tipo de incidencia** en el que se convierten tus defectos en Jira (por ejemplo, **Bug** o **Error**). No se ofrecen subtareas. 5. 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: 1. 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). 2. 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**. 3. 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](https://docs.probara.net/es/guides/integrations/jira-panel/#qué-pueden-ver-los-usuarios-de-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](https://docs.probara.net/es/guides/workspace/activity/). 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](https://docs.probara.net/es/developers/authentication/) o a través de [Probara MCP](https://docs.probara.net/es/developers/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](https://docs.probara.net/es/guides/integrations/jira-traceability/#automatizar). Todas las rutas y códigos de error están en la [referencia de la API](https://docs.probara.net/es/developers/api-reference/), en **Integrations**, y todas las herramientas en la [referencia de herramientas MCP](https://docs.probara.net/es/developers/mcp-tools/).