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

> Collega GitHub a Myrmex installando la Myrmex GitHub App sulla tua organizzazione.

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

Collega **GitHub** in modo che gli agenti di Myrmex possano clonare repository, aprire pull request ed eseguire audit di sicurezza sui repository della tua organizzazione. Myrmex si connette tramite la **Myrmex GitHub App** — la installi sulla tua org e scegli esattamente a quali repository può accedere. Gli agenti operano l'API di GitHub in tempo reale, leggendo e agendo su richiesta, senza che nulla venga memorizzato dalla parte di Myrmex.

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Leggere i repository" icon="code-branch">
    Clona e ispeziona codice e configurazione su richiesta.
  </Card>

  <Card title="Aprire pull request" icon="code-pull-request">
    Proponi correzioni e modifiche come pull request, con approvazione.
  </Card>

  <Card title="Audit di sicurezza" icon="shield-halved">
    Verifica i repository alla ricerca di problemi; inserisci i risultati in una revisione della [Security Posture](/it/documentation/security-posture/overview).
  </Card>

  <Card title="Accesso limitato" icon="lock">
    L'accesso è limitato ai repository che selezioni al momento dell'installazione della App.
  </Card>
</CardGroup>

## Prima di iniziare

* Una **organizzazione GitHub** (o un account) in cui puoi installare app: devi essere un owner, oppure far approvare la richiesta da un owner.
* L'elenco dei **repository** a cui Myrmex deve accedere (tutti, o un sottoinsieme).

## Passaggio 1 — Installa la Myrmex GitHub App

GitHub usa l'installazione di una App invece di un token creato manualmente.

<Steps>
  <Step title="Parti da Myrmex">
    In Myrmex, scegli **Add Integration → GitHub**. Verrai reindirizzato a GitHub.
  </Step>

  <Step title="Scegli dove installare">
    Seleziona l'organizzazione (o l'account) su cui installare la **Myrmex GitHub App**.
  </Step>

  <Step title="Seleziona i repository">
    Scegli **All repositories** oppure **Only select repositories**, quindi rivedi i permessi richiesti.
  </Step>

  <Step title="Installa e autorizza">
    Fai clic su **Install & Authorize**. GitHub ti riporta a Myrmex.
  </Step>
</Steps>

<Note>
  Se non sei un owner dell'organizzazione, GitHub registra la tua richiesta in modo che un owner possa approvare l'installazione.
</Note>

## Passaggio 2 — Aggiungi l'integrazione in Myrmex

Poiché l'installazione avviene su GitHub, Myrmex acquisisce automaticamente i dettagli di connessione quando torni indietro:

| Field               | Description                                                                                   |
| ------------------- | --------------------------------------------------------------------------------------------- |
| **Name**            | Un nome univoco per questa connessione GitHub.                                                |
| **Organization**    | Il login dell'org o dell'account su cui è stata installata la App, impostato automaticamente. |
| **Installation ID** | Il riferimento all'installazione della GitHub App, impostato automaticamente.                 |

## Connessione

Salva per completare. L'organizzazione comparirà in **Environment → Integrations**. Per modificare in seguito quali repository Myrmex può raggiungere, gestisci la **Myrmex GitHub App** dalle impostazioni della tua organizzazione GitHub. È la tua prima integrazione? Consulta la [panoramica sulle integrazioni](/it/documentation/integrations/overview).