Sviluppo
GitHub
Repository, codice, commit, issue e pull request di GitHub (anche Enterprise).
- Token o credenziali
- Azioni con conferma
Strumenti per l’agente
L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.
| Strumento | Cosa fa | Tipo |
|---|---|---|
search_repositories | Cerca repository (sintassi di ricerca GitHub, es. "org:azienda fatture"). | Lettura |
list_issues | Issue e pull request di un repository, filtrabili per stato ed etichette. | Lettura |
search_issues | Cerca issue e pull request con la sintassi GitHub (es. "repo:azienda/app is:open bug"). | Lettura |
get_issue | Dettaglio di un’issue o pull request con descrizione e ultimi commenti. | Lettura |
read_file | Legge un file (o elenca una cartella) di un repository. Con startLine/endLine restituisce solo quelle righe, numerate: usalo per i file lunghi e per citare percorso:riga. | Lettura |
search_code | Cerca nel codice del ramo predefinito e mostra i file e i frammenti trovati. | Lettura |
list_tree | Albero dei file di un repository (ricorsivo), filtrabile per cartella: utile per orientarsi prima di leggere i file. | Lettura |
get_commit | Dettaglio di un commit: messaggio completo e file cambiati con le differenze. | Lettura |
list_pull_requests | Pull request di un repository, filtrabili per stato e ramo di destinazione. | Lettura |
get_pull_request | Dettaglio di una pull request: descrizione, file cambiati con le differenze e revisioni. | Lettura |
list_commits | Ultimi commit di un repository, anche per ramo o percorso. | Lettura |
create_issue | Crea un’issue. Richiede conferma. | Con conferma |
add_comment | Aggiunge un commento a un’issue o pull request. Richiede conferma. | Con conferma |
Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti creazione di issue e commenti (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli GitHub e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- GitHub → Settings → Developer settings → Fine-grained tokens → Generate new token.
- Repository access: solo i repository necessari. Permessi: Contents e Issues/Pull requests in Read-only (Read and write solo se abiliti la scrittura), Metadata Read-only.
- Incolla il token: resta nel Vault. Imposta una scadenza e rinnovalo.
Campi del modulo: Organizzazione o utente predefinito, URL API (solo GitHub Enterprise Server).
Da incollare (cifrato nel Vault, poi non più visibile): Personal access token.
Collegarla a un agente
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- Premi Prova in chat e fai una domanda che richiede i dati del servizio.
Errori frequenti
- Credenziali non valide
- Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
- Permessi insufficienti
- All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
- Servizio non raggiungibile
- Controlla indirizzo, porta e firewall.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.