Vai al contenuto
Kaiross

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.

StrumentoCosa faTipo
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.

  1. GitHub → Settings → Developer settings → Fine-grained tokens → Generate new token.
  2. 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.
  3. 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

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
  2. In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
  3. Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
  4. 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.

Altre integrazioni della categoria Sviluppo

Tutte le integrazioni