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

> Conecta GitHub a Myrmex instalando la Myrmex GitHub App en tu organización.

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

Conecta **GitHub** para que los agentes de Myrmex puedan clonar repositorios, abrir pull requests y ejecutar auditorías de seguridad en los repositorios de tu organización. Myrmex se conecta a través de la **Myrmex GitHub App**: la instalas en tu organización y eliges exactamente a qué repositorios puede acceder. Los agentes operan la API de GitHub en vivo, leyendo y actuando bajo demanda, sin almacenar nada del lado de Myrmex.

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Leer repositorios" icon="code-branch">
    Clona e inspecciona código y configuración bajo demanda.
  </Card>

  <Card title="Abrir pull requests" icon="code-pull-request">
    Propón correcciones y cambios como pull requests, con aprobación.
  </Card>

  <Card title="Auditorías de seguridad" icon="shield-halved">
    Audita repositorios en busca de problemas; incorpora los hallazgos a una revisión de [Security Posture](/es/documentation/security-posture/overview).
  </Card>

  <Card title="Acceso acotado" icon="lock">
    El acceso se limita a los repositorios que seleccionas al instalar la App.
  </Card>
</CardGroup>

## Antes de comenzar

* Una **organización de GitHub** (o cuenta) donde puedas instalar apps: debes ser propietario, o que un propietario apruebe la solicitud.
* La lista de **repositorios** a los que Myrmex debe acceder (todos, o un subconjunto).

## Paso 1 — Instalar la Myrmex GitHub App

GitHub usa una instalación de App en lugar de un token creado manualmente.

<Steps>
  <Step title="Empieza desde Myrmex">
    En Myrmex, elige **Add Integration → GitHub**. Se te redirige a GitHub.
  </Step>

  <Step title="Elige dónde instalar">
    Selecciona la organización (o cuenta) en la que instalar la **Myrmex GitHub App**.
  </Step>

  <Step title="Selecciona los repositorios">
    Elige **All repositories** o **Only select repositories**, luego revisa los permisos solicitados.
  </Step>

  <Step title="Instala y autoriza">
    Haz clic en **Install & Authorize**. GitHub te devuelve a Myrmex.
  </Step>
</Steps>

<Note>
  Si no eres propietario de la organización, GitHub registra tu solicitud para que un propietario pueda aprobar la instalación.
</Note>

## Paso 2 — Agregar la integración en Myrmex

Como la instalación ocurre en GitHub, Myrmex captura los detalles de la conexión automáticamente cuando regresas:

| Field               | Descripción                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| **Name**            | Un nombre único para esta conexión de GitHub.                                                  |
| **Organization**    | La organización o el login de la cuenta donde se instaló la App: se establece automáticamente. |
| **Installation ID** | La referencia de la instalación de la GitHub App: se establece automáticamente.                |

## Conectar

Guarda para finalizar. La organización aparecerá en **Environment → Integrations**. Para cambiar más adelante a qué repositorios puede acceder Myrmex, gestiona la **Myrmex GitHub App** desde la configuración de tu organización de GitHub. ¿Nuevo en las integraciones? Consulta la [visión general de Integraciones](/es/documentation/integrations/overview).