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

# GitHub

> Conecte o GitHub ao Myrmex instalando o Myrmex GitHub App na sua organização.

import { Note, Steps, Step, CardGroup, Card } from '@mintlify/components';

Conecte o **GitHub** para que os agentes do Myrmex possam clonar repositórios, abrir pull requests e executar auditorias de segurança nos repositórios da sua organização. O Myrmex conecta através do **Myrmex GitHub App** — você o instala na sua org e escolhe exatamente quais repositórios ele pode acessar. Os agentes operam a API do GitHub ao vivo, lendo e atuando sob demanda, sem armazenar nada do lado do Myrmex.

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Ler repositórios" icon="code-branch">
    Clone e inspecione código e configuração sob demanda.
  </Card>

  <Card title="Abrir pull requests" icon="code-pull-request">
    Proponha correções e alterações como pull requests — com aprovação.
  </Card>

  <Card title="Auditorias de segurança" icon="shield-halved">
    Audite repositórios em busca de problemas; leve as descobertas para uma revisão de [Security Posture](/pt/documentation/security-posture/overview).
  </Card>

  <Card title="Acesso restrito" icon="lock">
    O acesso é limitado aos repositórios que você seleciona ao instalar o App.
  </Card>
</CardGroup>

## Antes de Começar

* Uma **organização do GitHub** (ou conta) onde você possa instalar apps — você precisa ser owner, ou ter um owner que aprove a solicitação.
* A lista de **repositórios** que o Myrmex deve acessar (todos, ou um subconjunto).

## Passo 1 — Instale o Myrmex GitHub App

O GitHub usa a instalação de um App em vez de um token criado manualmente.

<Steps>
  <Step title="Comece pelo Myrmex">
    No Myrmex, escolha **Add Integration → GitHub**. Você é redirecionado para o GitHub.
  </Step>

  <Step title="Escolha onde instalar">
    Selecione a organização (ou conta) na qual instalar o **Myrmex GitHub App**.
  </Step>

  <Step title="Selecione os repositórios">
    Escolha **All repositories** ou **Only select repositories**, depois revise as permissões solicitadas.
  </Step>

  <Step title="Instale e autorize">
    Clique em **Install & Authorize**. O GitHub envia você de volta ao Myrmex.
  </Step>
</Steps>

<Note>
  Se você não for owner da organização, o GitHub registra sua solicitação para que um owner possa aprovar a instalação.
</Note>

## Passo 2 — Adicione a Integração no Myrmex

Como a instalação acontece no GitHub, o Myrmex captura os detalhes da conexão automaticamente quando você retorna:

| Field               | Descrição                                                                    |
| ------------------- | ---------------------------------------------------------------------------- |
| **Name**            | Um nome único para esta conexão do GitHub.                                   |
| **Organization**    | O login da org ou conta onde o App foi instalado — definido automaticamente. |
| **Installation ID** | A referência da instalação do GitHub App — definida automaticamente.         |

## Conectar

Salve para concluir. A organização aparece em **Environment → Integrations**. Para alterar depois quais repositórios o Myrmex pode alcançar, gerencie o **Myrmex GitHub App** nas configurações da sua organização no GitHub. Novo em integrações? Veja a [visão geral de Integrações](/pt/documentation/integrations/overview).