> ## 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 provedores

> Guia público para conectar GitHub, GitLab, Azure DevOps, Bitbucket, Jira, Linear e ClickUp à Acrity.

Os provedores são conectados pelo Console usando Aplicativos conectados, Credenciais, Conectores e a página de detalhes de cada repositório. O caminho recomendado é usar Aplicativos conectados sempre que o provedor oferecer um, porque o Console consegue acompanhar autorização, status e reautorização para você.

Conectar um Aplicativo conectado é um repasse de autorização, não um registro de app. A Acrity publica e gerencia o app do provedor (o GitHub App, o app OAuth do GitLab ou do Bitbucket, o app registration do Azure DevOps e assim por diante) por deployment. Você nunca cria um app, configura uma callback URL nem concede permissões de API individuais por conta própria. Você entra no provedor, escolhe a conta ou organização, seleciona os repositórios que o app pode acessar e aprova.

## Escolha do método de conexão

A maioria dos provedores conecta por um Aplicativo conectado. Use uma credencial manual ou um conector local apenas quando um Aplicativo conectado não for adequado.

```mermaid theme={null}
flowchart TD
    A[Como a Acrity deve acessar o provedor?] --> B{O provedor oferece<br/>um Aplicativo conectado oficial?}
    B -->|Sim| C[Aplicativo conectado oficial<br/>Console &gt; Aplicativos conectados]
    B -->|Não| D{O VCS é privado ou self-hosted<br/>sem acesso público de entrada?}
    D -->|Sim| E[Conector local<br/>Console &gt; Conectores]
    D -->|Não| F[Credencial manual<br/>Console &gt; Credenciais]
```

| Método               | Melhor quando                                                                                         | Onde                             |
| -------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------- |
| Aplicativo conectado | O provedor oferece um app oficial ou OAuth. Preferido para autorização e reautorização centralizadas. | Console > Aplicativos conectados |
| Credencial manual    | O caso de uso precisa de um token, senha ou app password específico.                                  | Console > Credenciais            |
| Conector local       | O VCS é privado, self-hosted ou precisa ser acessado a partir da sua própria rede.                    | Console > Conectores             |

<Note>
  Credenciais e Conectores exigem um Admin de workspace. Os perfis são conjuntos fixos de capacidades definidos pela Acrity, portanto nenhum outro perfil pode criá-los ou gerenciá-los. Veja [Credenciais](/pt-BR/console/credentials) e [Conectores](/pt-BR/console/connectors).
</Note>

## Conectar um provedor

Escolha o provedor abaixo. Em todos os casos o fluxo é o mesmo: abra Aplicativos conectados, seja redirecionado ao provedor, escolha a conta ou organização, selecione os repositórios e aprove. A Acrity gerencia o app do provedor por você.

<Tabs>
  <Tab title="GitHub">
    Use o GitHub App para conectar contas e organizações do GitHub Cloud.

    <Steps>
      <Step title="Abrir Aplicativos conectados">
        Acesse `Console > Aplicativos conectados` e escolha o GitHub App.
      </Step>

      <Step title="Autorizar no GitHub">
        A Acrity redireciona você para o GitHub. Entre se solicitado.
      </Step>

      <Step title="Escolher a conta ou organização">
        Selecione a conta pessoal ou a organização onde o app deve ser instalado.
      </Step>

      <Step title="Selecionar repositórios">
        Escolha todos os repositórios ou um subconjunto específico que o app pode acessar. Você concede acesso ao app que a Acrity já publica—não há nada para registrar.
      </Step>

      <Step title="Aprovar e retornar">
        Aprove o acesso solicitado. O GitHub retorna você ao Console; confirme que a instalação aparece como ativa e, em seguida, conecte os projetos desejados em `Console > Repositórios`.
      </Step>
    </Steps>

    O GitHub App é registrado e gerenciado pela Acrity por deployment. Você nunca cria o app nem configura uma callback URL.

    <Note>
      Se a Acrity for usada como gate de merge, configure as regras de proteção de branch do GitHub para exigir o check publicado pela Acrity.
    </Note>
  </Tab>

  <Tab title="GitLab">
    Use OAuth do GitLab para o GitLab.com. Para o GitLab self-managed, informe a URL da instância quando solicitado ou use um [conector local](/pt-BR/console/connectors) se a instância estiver em uma rede privada.

    <Steps>
      <Step title="Abrir Aplicativos conectados">
        Acesse `Console > Aplicativos conectados` e escolha o GitLab.
      </Step>

      <Step title="Informar a URL da instância">
        Para o GitLab self-managed, informe a URL base da instância quando solicitado. Pule esta etapa para o GitLab.com.
      </Step>

      <Step title="Autorizar no GitLab">
        A Acrity redireciona você para o GitLab. Entre e confirme o grupo ou namespace correto.
      </Step>

      <Step title="Aprovar e conectar">
        Aprove o acesso solicitado, retorne ao Console e conecte os projetos desejados em `Console > Repositórios`.
      </Step>
    </Steps>

    O app OAuth do GitLab é gerenciado pela Acrity. Você apenas autoriza o acesso e seleciona os projetos.
  </Tab>

  <Tab title="Azure DevOps">
    Conecte organizações do Azure DevOps pelo login da Microsoft.

    <Steps>
      <Step title="Abrir Aplicativos conectados">
        Acesse `Console > Aplicativos conectados` e escolha o Azure DevOps.
      </Step>

      <Step title="Autorizar com a Microsoft">
        A Acrity redireciona você para o login da Microsoft. Entre com uma conta que possa acessar a organização desejada.
      </Step>

      <Step title="Selecionar a organização">
        Escolha a organização do Azure DevOps a conectar.
      </Step>

      <Step title="Aprovar e conectar">
        Aprove o acesso solicitado, retorne ao Console e conecte os repositórios desejados em `Console > Repositórios`.
      </Step>
    </Steps>

    O app registration do Azure DevOps é gerenciado pela Acrity. Você não cria um app registration nem configura uma redirect URI.
  </Tab>

  <Tab title="Bitbucket">
    Conecte workspaces do Bitbucket Cloud por OAuth.

    <Tip>
      O Bitbucket autoriza a conta atualmente logada no seu navegador. Entre no Bitbucket com a conta correta antes de começar.
    </Tip>

    <Steps>
      <Step title="Abrir Aplicativos conectados">
        Acesse `Console > Aplicativos conectados` e escolha o Bitbucket.
      </Step>

      <Step title="Autorizar no Bitbucket">
        A Acrity redireciona você para o Bitbucket. Confirme o workspace correto.
      </Step>

      <Step title="Aprovar e conectar">
        Aprove o acesso solicitado, retorne ao Console e conecte os repositórios desejados em `Console > Repositórios`.
      </Step>
    </Steps>

    O OAuth consumer do Bitbucket é gerenciado pela Acrity. Você apenas autoriza o workspace e seleciona os repositórios.
  </Tab>

  <Tab title="Jira">
    O Jira é uma integração de gestão de trabalho para campos de PM, comentários e vínculo de tarefas.

    <Steps>
      <Step title="Abrir Aplicativos conectados">
        Acesse `Console > Aplicativos conectados` e escolha o Jira.
      </Step>

      <Step title="Autorizar na Atlassian">
        A Acrity redireciona você para a Atlassian. Entre e selecione o site Jira a conectar.
      </Step>

      <Step title="Aprovar e vincular">
        Aprove o acesso solicitado, retorne ao Console e vincule a instalação aos repositórios pela página de detalhes do repositório.
      </Step>
    </Steps>

    O app OAuth do Jira é gerenciado pela Acrity. Bitbucket e Jira são integrações separadas, mesmo quando pertencem à mesma organização Atlassian.
  </Tab>

  <Tab title="Linear">
    O Linear é uma integração de gestão de trabalho para issues e contexto de produto.

    <Steps>
      <Step title="Abrir Aplicativos conectados">
        Acesse `Console > Aplicativos conectados` e escolha o Linear.
      </Step>

      <Step title="Autorizar no Linear">
        A Acrity redireciona você para o Linear. Entre e aprove o acesso solicitado.
      </Step>

      <Step title="Vincular aos repositórios">
        Retorne ao Console e vincule a instalação Linear aos repositórios existentes pelo seletor de PM na página de detalhes do repositório.
      </Step>
    </Steps>

    O app OAuth do Linear é gerenciado pela Acrity.
  </Tab>

  <Tab title="ClickUp">
    O ClickUp é uma integração de gestão de trabalho para tarefas e contexto de produto.

    <Steps>
      <Step title="Abrir Aplicativos conectados">
        Acesse `Console > Aplicativos conectados` e escolha o ClickUp.
      </Step>

      <Step title="Autorizar os workspaces">
        A Acrity redireciona você para o ClickUp. Entre e aprove o acesso aos workspaces necessários.
      </Step>

      <Step title="Vincular aos repositórios">
        Retorne ao Console e vincule a integração aos repositórios.
      </Step>
    </Steps>

    O app OAuth do ClickUp é gerenciado pela Acrity. Você apenas autoriza os workspaces e os vincula aos repositórios.
  </Tab>
</Tabs>

## Checklist de validação

Depois de conectar um provedor:

1. Confirme que a instalação aparece como ativa em `Console > Aplicativos conectados`.
2. Conecte pelo menos um repositório em `Console > Repositórios`.
3. Abra a página de detalhes do repositório e valide credenciais, webhook e prontidão.
4. Se houver uma integração de PM, confirme os campos de tarefa, comentários e o vínculo de projeto.
5. Abra um PR ou MR de teste e acompanhe o primeiro review no dashboard Ops (veja [Fluxo de review](/pt-BR/guides/review-flow)).