> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acrity.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar proveedores

> Guía pública para conectar GitHub, GitLab, Azure DevOps, Bitbucket, Jira, Linear y ClickUp a Acrity.

Los proveedores se conectan a través de la Consola mediante Aplicaciones conectadas, Credenciales, Conectores y la página de detalle de cada repositorio. El camino recomendado es usar Aplicaciones conectadas siempre que el proveedor ofrezca una, porque la Consola puede hacer seguimiento de la autorización, el estado y la reautorización por ti.

Conectar una Aplicación conectada es una transferencia de autorización, no un registro de aplicación. Acrity publica y gestiona la aplicación del proveedor (la GitHub App, la aplicación OAuth de GitLab o Bitbucket, el registro de aplicación de Azure DevOps, etc.) en cada despliegue. Nunca creas una aplicación, configuras una URL de callback ni concedes permisos de API individuales por tu cuenta. Inicias sesión en el proveedor, eliges la cuenta u organización, seleccionas los repositorios que la aplicación puede alcanzar y apruebas.

## Elige un método de conexión

La mayoría de los proveedores se conectan mediante una Aplicación conectada. Usa una credencial manual o un conector local solo cuando una Aplicación conectada no encaje.

```mermaid theme={null}
flowchart TD
    A[¿Cómo debe Acrity conectarse con el proveedor?] --> B{¿El proveedor ofrece<br/>una Aplicación conectada oficial?}
    B -->|Sí| C[Aplicación conectada oficial<br/>Consola &gt; Aplicaciones conectadas]
    B -->|No| D{¿El VCS es privado o self-hosted<br/>sin acceso entrante público?}
    D -->|Sí| E[Conector local<br/>Consola &gt; Conectores]
    D -->|No| F[Credencial manual<br/>Consola &gt; Credenciales]
```

| Método               | Cuándo conviene                                                                                                       | Dónde                             |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| Aplicación conectada | El proveedor ofrece una aplicación oficial u OAuth. Preferida para la autorización y la reautorización centralizadas. | Consola > Aplicaciones conectadas |
| Credencial manual    | El caso de uso necesita un token, una contraseña o una contraseña de aplicación específicos.                          | Consola > Credenciales            |
| Conector local       | El VCS es privado, self-hosted o debe alcanzarse desde tu propia red.                                                 | Consola > Conectores              |

<Note>
  Credenciales y Conectores requieren un administrador del Workspace (los administradores de plataforma también tienen acceso). Los roles son conjuntos fijos de capacidades definidos por Acrity, por lo que ningún otro rol puede crearlos ni gestionarlos. Consulta [Credenciales](/es/console/credentials) y [Conectores](/es/console/connectors).
</Note>

## Conecta un proveedor

Elige el proveedor a continuación. En todos los casos el flujo es el mismo: abre Aplicaciones conectadas, se te redirige al proveedor, eliges la cuenta u organización, seleccionas los repositorios y apruebas. Acrity gestiona por ti la aplicación del proveedor subyacente.

<Tabs>
  <Tab title="GitHub">
    Usa la GitHub App para conectar cuentas y organizaciones de GitHub Cloud.

    <Steps>
      <Step title="Abre Aplicaciones conectadas">
        Ve a `Consola > Aplicaciones conectadas` y elige la GitHub App.
      </Step>

      <Step title="Autoriza en GitHub">
        Acrity te redirige a GitHub. Inicia sesión si se te solicita.
      </Step>

      <Step title="Elige la cuenta u organización">
        Selecciona la cuenta personal u organización donde debe instalarse la aplicación.
      </Step>

      <Step title="Selecciona los repositorios">
        Elige todos los repositorios o un subconjunto específico al que la aplicación puede acceder. Concedes acceso a la aplicación que Acrity ya publica: no hay nada que registrar.
      </Step>

      <Step title="Aprueba y vuelve">
        Aprueba el acceso solicitado. GitHub te devuelve a la Consola; confirma que la instalación aparece como activa y luego conecta los proyectos de destino en `Consola > Repositorios`.
      </Step>
    </Steps>

    La GitHub App la registra y gestiona Acrity en cada despliegue. Nunca creas la aplicación ni configuras una URL de callback.

    <Note>
      Si Acrity se usa como gate de merge, configura las reglas de protección de ramas de GitHub para exigir el check publicado por Acrity.
    </Note>
  </Tab>

  <Tab title="GitLab">
    Usa GitLab OAuth para GitLab.com. Para GitLab self-managed, proporciona la URL de la instancia cuando se te solicite, o usa un [conector local](/es/console/connectors) si la instancia está en una red privada.

    <Steps>
      <Step title="Abre Aplicaciones conectadas">
        Ve a `Consola > Aplicaciones conectadas` y elige GitLab.
      </Step>

      <Step title="Introduce la URL de la instancia">
        Para GitLab self-managed, introduce la URL base de la instancia cuando se te solicite. Omite este paso para GitLab.com.
      </Step>

      <Step title="Autoriza en GitLab">
        Acrity te redirige a GitLab. Inicia sesión y confirma el grupo o namespace correcto.
      </Step>

      <Step title="Aprueba y conecta">
        Aprueba el acceso solicitado, vuelve a la Consola y conecta los proyectos de destino en `Consola > Repositorios`.
      </Step>
    </Steps>

    La aplicación OAuth de GitLab la gestiona Acrity. Solo autorizas el acceso y seleccionas los proyectos.
  </Tab>

  <Tab title="Azure DevOps">
    Conecta organizaciones de Azure DevOps mediante el inicio de sesión de Microsoft.

    <Steps>
      <Step title="Abre Aplicaciones conectadas">
        Ve a `Consola > Aplicaciones conectadas` y elige Azure DevOps.
      </Step>

      <Step title="Autoriza con Microsoft">
        Acrity te redirige al inicio de sesión de Microsoft. Inicia sesión con una cuenta que pueda acceder a la organización de destino.
      </Step>

      <Step title="Selecciona la organización">
        Elige la organización de Azure DevOps que quieres conectar.
      </Step>

      <Step title="Aprueba y conecta">
        Aprueba el acceso solicitado, vuelve a la Consola y conecta los repositorios de destino en `Consola > Repositorios`.
      </Step>
    </Steps>

    El registro de aplicación de Azure DevOps lo gestiona Acrity. No creas un registro de aplicación ni configuras una redirect URI.
  </Tab>

  <Tab title="Bitbucket">
    Conecta workspaces de Bitbucket Cloud mediante OAuth.

    <Tip>
      Bitbucket autoriza la cuenta que tiene la sesión iniciada actualmente en tu navegador. Inicia sesión en Bitbucket con la cuenta correcta antes de empezar.
    </Tip>

    <Steps>
      <Step title="Abre Aplicaciones conectadas">
        Ve a `Consola > Aplicaciones conectadas` y elige Bitbucket.
      </Step>

      <Step title="Autoriza en Bitbucket">
        Acrity te redirige a Bitbucket. Confirma el workspace correcto.
      </Step>

      <Step title="Aprueba y conecta">
        Aprueba el acceso solicitado, vuelve a la Consola y conecta los repositorios de destino en `Consola > Repositorios`.
      </Step>
    </Steps>

    El consumer OAuth de Bitbucket lo gestiona Acrity. Solo autorizas el workspace y seleccionas los repositorios.
  </Tab>

  <Tab title="Jira">
    Jira es una integración de gestión de trabajo para campos de PM, comentarios y vinculación de tareas.

    <Steps>
      <Step title="Abre Aplicaciones conectadas">
        Ve a `Consola > Aplicaciones conectadas` y elige Jira.
      </Step>

      <Step title="Autoriza en Atlassian">
        Acrity te redirige a Atlassian. Inicia sesión y selecciona el sitio de Jira que quieres conectar.
      </Step>

      <Step title="Aprueba y vincula">
        Aprueba el acceso solicitado, vuelve a la Consola y vincula la instalación a los repositorios desde la página de detalle del repositorio.
      </Step>
    </Steps>

    La aplicación OAuth de Jira la gestiona Acrity. Bitbucket y Jira son integraciones separadas, incluso cuando pertenecen a la misma organización de Atlassian.
  </Tab>

  <Tab title="Linear">
    Linear es una integración de gestión de trabajo para issues y contexto de producto.

    <Steps>
      <Step title="Abre Aplicaciones conectadas">
        Ve a `Consola > Aplicaciones conectadas` y elige Linear.
      </Step>

      <Step title="Autoriza en Linear">
        Acrity te redirige a Linear. Inicia sesión y aprueba el acceso solicitado.
      </Step>

      <Step title="Vincula a los repositorios">
        Vuelve a la Consola y vincula la instalación de Linear a repositorios existentes mediante el selector de PM en la página de detalle del repositorio.
      </Step>
    </Steps>

    La aplicación OAuth de Linear la gestiona Acrity.
  </Tab>

  <Tab title="ClickUp">
    ClickUp es una integración de gestión de trabajo para tareas y contexto de producto.

    <Steps>
      <Step title="Abre Aplicaciones conectadas">
        Ve a `Consola > Aplicaciones conectadas` y elige ClickUp.
      </Step>

      <Step title="Autoriza los workspaces">
        Acrity te redirige a ClickUp. Inicia sesión y aprueba el acceso para los workspaces necesarios.
      </Step>

      <Step title="Vincula a los repositorios">
        Vuelve a la Consola y vincula la integración a los repositorios.
      </Step>
    </Steps>

    La aplicación OAuth de ClickUp la gestiona Acrity. Solo autorizas los workspaces y los vinculas a los repositorios.
  </Tab>
</Tabs>

## Lista de validación

Después de conectar un proveedor:

1. Confirma que la instalación aparece como activa en `Consola > Aplicaciones conectadas`.
2. Conecta al menos un repositorio en `Consola > Repositorios`.
3. Abre la página de detalle del repositorio y valida las credenciales, el webhook y el readiness.
4. Si hay una integración de PM, confirma los campos de tarea, los comentarios y la vinculación de proyecto.
5. Abre un PR o MR de prueba y haz seguimiento de la primera revisión en el dashboard Ops (consulta [Flujo de revisión](/es/guides/review-flow)).