Come collegare CircleCI a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → CircleCI, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

CircleCI + Gemini

Fai controllare CircleCI alla tua AI: pipeline, workflow e job, test falliti e artefatti, metriche Insights e test instabili, contesti e nomi delle variabili, e avvia pipeline o riesegui e annulla workflow dopo la tua conferma.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

CIRCLECI_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi a CircleCI su https://app.circleci.com e apri User Settings → Personal API Tokens (https://app.circleci.com/settings/user/tokens).
2. Fai clic su Create New Token, dagli un nome e copialo. I token più recenti iniziano con CCIPAT_. I token API di progetto delle impostazioni del progetto non funzionano con l'API v2.
3. Incolla il token in CIRCLECI_TOKEN così com'è, senza prefissi, e installa il connettore. Viene inviato nell'header Circle-Token solo a circleci.com.
4. Verifica la configurazione con circleci_get_current_user e poi con circleci_list_collaborations, che mostra le organizzazioni di cui fai parte.

Chi vede cosa: il token ha gli stessi diritti del tuo utente CircleCI in ogni organizzazione di cui fai parte. Condividi il server MCP solo con persone autorizzate a vedere quelle build.

Slug di progetto: quasi tutti i tool richiedono lo slug del progetto mostrato in Project Settings → Overview. I progetti collegati con GitHub OAuth e Bitbucket Cloud usano gh/<org>/<repo> o bb/<workspace>/<repo> (per esempio gh/rossi-srl/ecommerce); i progetti collegati con la GitHub App e GitLab usano circleci/<organization id>/<project id>. Passa lo slug così com'è, con le sue barre.

Avvia build e ferma lavori in corso, quindi l'AI chiede prima: circleci_trigger_pipeline avvia una nuova pipeline su un branch o un tag. Richiede l'id di una definizione da circleci_list_pipeline_definitions, che a sua volta richiede l'id del progetto da circleci_get_project, e non è disponibile per i progetti GitLab. circleci_rerun_workflow riesegue un workflow come nuovo workflow: tutti i job, solo dal job fallito in poi, oppure i job che scegli. circleci_cancel_workflow ferma un workflow in esecuzione, e i job non ancora partiti non verranno eseguiti. Avviare e rieseguire consumano crediti ed eseguono tutto ciò che prevede la configurazione, job di deploy compresi; annullare può lasciare un deploy a metà. Prima di ognuno l'AI ti indica progetto, branch, workflow o job e aspetta il tuo sì. Nessun tool è disattivato all'installazione, e nulla qui elimina progetti, contesti o variabili.

Capire perché una build è fallita: circleci_list_pipelines (dalla più recente, anche per un solo branch), circleci_get_pipeline per id o circleci_get_pipeline_by_number per il #numero mostrato nell'app; poi circleci_list_pipeline_workflows e circleci_list_workflow_jobs per trovare il job fallito e il suo numero. circleci_get_job fornisce stato, durata, executor, contesti usati e il link web. circleci_list_job_tests conta i test superati, saltati e falliti e mostra ogni test fallito con il suo messaggio (solo per i job che salvano i risultati dei test). circleci_list_job_artifacts elenca gli artefatti salvati con i link di download, che richiedono lo stesso token. I log completi degli step sono solo nell'app CircleCI, tramite il web_url del job.

Tendenze e test instabili: circleci_get_workflow_metrics riassume tutti i workflow di un progetto su una finestra che va dalle ultime 24 ore agli ultimi 90 giorni (esecuzioni, tasso di successo, durata, crediti usati, tempo di ripristino), per un branch o per tutti. circleci_get_workflow_summary mostra un workflow negli ultimi 90 giorni con la tendenza rispetto al periodo precedente. circleci_list_flaky_tests elenca i test che sono passati e falliti sullo stesso commit, con quante volte è successo e il tempo sprecato. I dati Insights vengono aggiornati ogni giorno, non in tempo reale.

Contesti e variabili: circleci_list_contexts richiede l'id dell'organizzazione da circleci_list_collaborations (oppure uno slug di organizzazione come gh/rossi-srl per le organizzazioni GitHub OAuth e Bitbucket). circleci_list_context_env_var_names e circleci_list_project_env_var_names restituiscono solo i nomi delle variabili d'ambiente, mai i loro valori.

Paginazione: le liste restituiscono next_page_token; l'AI lo ripassa come page_token finché non è vuoto.

Errori comuni: 401: il token è errato o revocato, oppure è un token API di progetto; crea un token API personale in User Settings. 404: lo slug del progetto è sbagliato o il tuo utente non vede il progetto; per i progetti fuori dal tuo accesso CircleCI risponde 404 invece di 403. 429: è stato raggiunto il limite di richieste; attendi un minuto e riprova.

Il connettore non copre l'approvazione dei job in attesa, la creazione o l'eliminazione di progetti, contesti, variabili d'ambiente, pianificazioni e webhook, né la lettura dei log completi degli step.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di CircleCI.

Tool disponibili

Esempi di prompt

• "Perché è fallita l'ultima pipeline su main in gh/rossi-srl/ecommerce? Mostrami il job fallito, i test falliti con i loro messaggi e il link al job."
• "Quali test di gh/rossi-srl/ecommerce sono instabili, quante volte sono falliti a caso e quanto tempo ci hanno fatto perdere?"
• "Confronta tutti i workflow di gh/rossi-srl/ecommerce negli ultimi 30 giorni su tutti i branch: tasso di successo, durata media e crediti usati."
• "Riesegui il workflow di deploy della pipeline #1482 dal job fallito. Dimmi quali job ripartiranno e chiedimi conferma prima di avviarlo."
• "Avvia una pipeline sul branch release/2.4 con il parametro deploy impostato a true. Mostrami prima progetto, branch e parametri."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT