Perché collegare gli agenti al ciclo di vita del software

Gli agenti IA sono già presenti lungo l’intero ciclo di vita del software di un team, ma nella maggior parte dei casi operano come strumenti separati. Il contesto, le assegnazioni e le autorizzazioni devono ancora essere gestiti manualmente dal team. Quando gli agenti utilizzano le API di diversi tool, spesso devono indovinare gli endpoint corretti e consumano il proprio “contesto” con chiamate aggiuntive.

Il GitLab MCP‑Server, ora disponibile con GitLab 19.5, risolve questi problemi collegando gli agenti esterni al ciclo di vita completo del software, dalla pianificazione alla produzione. Ogni agente compatibile MCP può eseguire workflow GitLab direttamente dal client, ricevendo le informazioni necessarie con un numero ridotto di chiamate e senza un contesto ingombrante.

Grazie a questa integrazione, gli agenti possono interagire con codice, merge request, work item e pipeline, nonché delegare compiti ai flussi della GitLab Duo Agent Platform. Ogni azione avviene sotto le autorizzazioni GitLab già esistenti, garantendo coerenza e sicurezza.

Il Model Context Protocol (MCP) alla base dell’integrazione

Le API tradizionali sono progettate per gli sviluppatori: un agente deve scoprire quali endpoint chiamare e combinare più risposte per ottenere un risultato completo. Il Model Context Protocol (MCP) è uno standard aperto pensato per gli agenti. Un server MCP comunica all’agente le operazioni disponibili e offre una selezione curata di strumenti allineati ai workflow reali.

Con il MCP, gli agenti ottengono gli strumenti necessari con un contesto più focalizzato, riducendo il numero di chiamate e la quantità di dati trasferiti per ogni compito. Il GitLab MCP‑Server trasporta questo approccio a tutti i progetti GitLab, rispettando le autorizzazioni già configurate per ciascun membro del team.

Che si tratti di un singolo sviluppatore che assegna un’attività a un agente o di un’organizzazione che definisce le policy di utilizzo degli agenti, il server garantisce una copertura di strumenti sufficientemente ampia per completare il lavoro, mantenendo al contempo i permessi coerenti con quelli di GitLab.

Esempio pratico: avviare un flusso Duo Agent

Un caso d’uso tipico è l’avvio del “Fix Pipeline Flow” nella Duo Agent Platform tramite Claude Code, che invoca il GitLab MCP‑Server per eseguire il flusso in modo completamente integrato.

Nuovi strumenti introdotti in GitLab 19.5

Oltre ai tool già presentati nella versione 19.4, la release 19.5 aggiunge ulteriori capacità per la gestione di codice, pipeline, gruppi e documentazione.

Strumenti per il codice

    • add_branch: crea un branch feature.
    • getrepositoryfile: legge un file da qualsiasi ref.
    • semantic_search: trova codice in base al significato, rispondendo a domande tipo “dove è implementata questa funzionalità?” senza conoscere nomi di file o simboli.

Strumenti per le pipeline

    • get_pipeline: mostra perché una pipeline è rossa, includendo job, pipeline downstream e, su richiesta, artefatti.
    • list_pipelines: visualizza pattern nei recenti run.
    • getartifactfile: legge un singolo file dagli artefatti di un job (log, report, test‑fixture) senza scaricare l’intero archivio.

Strumenti di orientamento

    • list_groups: consente all’agente di esplorare la gerarchia dei gruppi per trovare quello corretto, evitando di indovinare ID.
    • listwikipages (opt‑in): rende disponibili runbook e documentazione prima che l’agente risponda a domande “how‑to”.

Raffinamenti del catalogo tool

In 19.5 il catalogo è stato semplificato: gli strumenti correlati sono stati raggruppati, così meno tool coprono più scenari. Alcune novità chiave includono:

    • getmergerequest: permette di recuperare commit, diff, pipeline, conflitti e commenti di un merge request.
    • getpipelinejobs: aggiunto a get_pipeline per ottenere i job associati alla pipeline stessa.

Queste modifiche rendono più facile per gli agenti scegliere lo strumento giusto e richiedere solo le informazioni strettamente necessarie.

Toolset e configurazione dei tool

Con i Toolset è possibile definire quali gruppi di strumenti il server restituisce a ciascun agente. In questo modo ogni agente lavora con una selezione mirata di tool adatti al workflow del team, riducendo il rischio di scegliere erroneamente uno strumento non pertinente.

La maggior parte dei gruppi è attiva per impostazione predefinita; “Code Security” e “Wikis” sono disponibili come opt‑in. Il catalogo completo è descritto nella Tool‑Reference ufficiale.

Avviare flussi Duo Agent direttamente dal client

Oltre a chiamare singoli tool, gli agenti possono ora delegare compiti alla GitLab Duo Agent Platform e seguirne l’avanzamento senza uscire dal client.

    • listduoagentsandflows: elenca i flussi disponibili per un progetto.
    • startduosession: avvia un nuovo flusso basandosi su un obiettivo espresso in linguaggio naturale.
    • getduosession e listduosessions: monitorano lo stato della sessione.
    • sendduosession_input: invia decisioni o risposte umane quando la sessione richiede un intervento, mantenendo la decisione finale nelle mani dell’operatore.

Tutte queste operazioni avvengono all’interno di un job CI di GitLab, condividendo lo stesso livello di contesto, le policy di sicurezza e il tracciamento di audit delle normali pipeline.

Come collegare gli agenti a GitLab

Il ciclo di vita degli agenti continuerà a evolversi. Quando un team introduce nuovi agenti, il GitLab MCP‑Server li collega automaticamente a tutti gli strumenti e i flussi di GitLab, rendendoli operativi fin dal primo utilizzo.

Per gli agenti già in uso, la documentazione del MCP‑Server fornisce guide dettagliate di configurazione per client come Claude Code, Claude Desktop, Cursor, GitHub Copilot, OpenAI Codex, Gemini, Kiro, Zed e altri client compatibili MCP.

Il GitLab MCP‑Server è disponibile nei piani Free, Premium e Ultimate su GitLab.com, GitLab Self‑Managed e GitLab Dedicated. Su GitLab.com sono in vigore i seguenti Rate Limits per persona:

    • Free: 60 chiamate al minuto.
    • Premium e Ultimate: 600 chiamate al minuto.

Primi passi per la Duo Agent Platform

Se sei nuovo alla Duo Agent Platform, puoi avviare una prova gratuita. Gli utenti già su Premium o Ultimate possono attivare la piattaforma e sfruttare i GitLab Credits inclusi nell’abbonamento.

Conclusioni

Il GitLab MCP‑Server rappresenta un salto di qualità nella collaborazione tra agenti IA e i workflow GitLab. Riducendo il numero di chiamate API, fornendo contesti più mirati e integrando nativamente i flussi Duo Agent, la soluzione permette ai team di sfruttare al massimo le potenzialità degli agenti senza sacrificare sicurezza o governance. Con un catalogo di tool ampliato, la possibilità di configurare set di strumenti specifici per ciascun agente e il supporto su tutti i piani GitLab, la piattaforma è pronta a diventare lo standard per l’interazione agente‑GitLab nei prossimi anni.