Come collegare Rollbar a Gemini via MCP

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

Rollbar + Gemini

Il monitoraggio degli errori di Rollbar in qualsiasi agente AI: item con cronologia e occorrenze, stack trace completi, item più attivi e report sulle occorrenze, la Metrics API, deploy, ambienti e versioni del codice, query RQL e progetti, utenti e team dell'account. Risolve, silenzia, assegna e posticipa gli item, li commenta e registra i deploy.

Prerequisiti

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

ROLLBAR_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti servono un account Rollbar e un access token. Il tipo di token che incolli decide che cosa raggiunge il connettore:

1. Un solo progetto: nel progetto apri Settings, Project Access Tokens e crea o copia un project access token. Dagli lo scope read per leggere, write per modificare gli item e post_server_item per registrare i deploy. Un token di progetto lavora sempre sul proprio progetto, ma non può elencare progetti, utenti o team.
2. L'intero account: crea invece un account access token. Un service token (Settings dell'account, API Access Tokens, scheda Service) raggiunge tutti i progetti; un personal access token (User Settings, Personal access tokens) può fare solo ciò che può fare il suo utente. I loro scope sono read e write. Con un token di account l'AI passa project_id (da rollbar_list_projects) agli strumenti di progetto, e rollbar_list_items cerca in tutti i progetti che il token può leggere, a meno che tu non indichi project_ids.
3. Incolla il token in ROLLBAR_ACCESS_TOKEN. Viene inviato nell'header X-Rollbar-Access-Token a https://api.rollbar.com/api/1.
4. Installa il connettore ed esegui rollbar_list_items per verificare il token.

Solo un personal access token può commentare gli item, e solo un token di progetto con post_server_item può registrare i deploy.

Che cosa non funziona adesso: rollbar_get_top_active_items mostra gli item con più occorrenze nelle ultime ore (da 1 a 168, predefinito 24) con i conteggi orari, come la Top 10 della dashboard del progetto. rollbar_list_items elenca e cerca gli item (errori e messaggi raggruppati) per stato, livello, ambiente, framework, assegnatario, stato di posticipo o con lo stesso testo di ricerca della pagina Items. rollbar_get_item legge un item. Il numero in un URL di Rollbar (#123) è il counter del progetto, non l'id dell'item: rollbar_get_item_by_counter ricava l'item da un counter o dall'UUID di un'occorrenza.

Indagare: rollbar_list_item_occurrences elenca i singoli eventi di un item e rollbar_list_occurrences gli ultimi eventi dell'intero progetto, ciascuno con orario, versione del codice e payload. rollbar_get_occurrence restituisce il payload completo come la vista Raw JSON: classe e messaggio dell'eccezione, frame dello stack trace, richiesta, persona, server, client, dati personalizzati e telemetria. rollbar_list_item_events mostra chi ha commentato, modificato, assegnato, posticipato o unito un item.

Triage: rollbar_update_item risolve un item (facoltativamente con resolved_in_version, ad esempio uno SHA git), lo silenzia o lo riattiva, ne cambia livello o titolo, lo assegna a un utente o a un team (id da rollbar_list_users e rollbar_list_teams) o lo posticipa per un certo numero di secondi (il posticipo richiede un piano a pagamento). rollbar_add_item_comment aggiunge un commento in Markdown alla cronologia dell'item. Servono lo scope write.

Andamenti e metriche: rollbar_get_occurrence_counts dà le occorrenze per minuto, ora o giorno, rollbar_get_activated_item_counts gli item nuovi e riattivati per giorno e rollbar_get_item_metrics i conteggi delle occorrenze con prima e ultima occorrenza per un elenco di item. Con il piano Advanced, rollbar_query_occurrence_metrics interroga la Metrics API con filtri, raggruppamenti e aggregati (ad esempio le occorrenze per ambiente al giorno o i browser più frequenti di un item), e rollbar_get_resolution_time_metrics dà il tempo di risoluzione degli item (mediana, media, minimo o massimo) per periodo.

Rilasci: rollbar_list_deploys, rollbar_get_deploy e rollbar_list_environments leggono deploy e ambienti. rollbar_report_deploy registra il deploy di una revisione in un ambiente, e rollbar_update_deploy chiude un deploy registrato come avviato (succeeded, failed o timed_out). Per capire che cosa ha rotto un rilascio, rollbar_get_version conta gli item nuovi, riattivati, ripetuti e risolti di una versione del codice in un ambiente, e rollbar_list_version_items con event: new elenca gli item comparsi per la prima volta in quella versione.

RQL: per analisi al volo l'AI avvia una query nel linguaggio simile a SQL di Rollbar con rollbar_create_rql_job (tabelle item_occurrence e deploy), interroga rollbar_get_rql_job finché status è success e legge le righe con rollbar_get_rql_job_result. rollbar_list_rql_jobs e rollbar_cancel_rql_job gestiscono i job precedenti e quelli in corso. RQL non modifica dati.

Account: con un token di account, rollbar_list_projects, rollbar_get_project, rollbar_list_users, rollbar_get_user e rollbar_list_teams.

Disattivati all'installazione: rollbar_request_person_deletion, che cancella una persona tracciata (l'utente finale associato alle occorrenze) da tutti i progetti dell'account, ad esempio per una richiesta GDPR. Non si può annullare, quindi un amministratore del workspace lo attiva quando serve; rollbar_get_person_deletion_status segue poi il job.

Formati dei dati: ogni risposta è {"err": 0, "result": ...}; err: 1 arriva con un message. rollbar_report_deploy risponde {"data": {"deploy_id": ...}}. Tutti i timestamp sono secondi Unix in GMT e i grafici dei report sono coppie [timestamp, count]. Lo status di un item è active, resolved, muted o archived; il level è debug, info, warning, error o critical. Gli elenchi di occorrenze omettono header della richiesta, cookie e dettagli del notifier; il payload completo di rollbar_get_occurrence può contenere dati personali dei tuoi utenti finali.

Paginazione: gli item arrivano 100 per pagina; occorrenze, deploy, ambienti ed eventi degli item 20 per pagina di default, con limit fino a 5000 dove previsto. Passa page a partire da 1; gli elenchi di occorrenze si sfogliano anche con last_id. total_count è null nei progetti con più di 100.000 item.

Limiti: ogni token ha il suo limite di richieste su Rollbar; X-Rate-Limit-Remaining mostra quante ne restano. Gli strumenti della Metrics API richiedono il piano Advanced.

Errori comuni: 401 indica un token mancante o malformato. 403 indica un token disattivato, senza lo scope necessario, un token di progetto su uno strumento dell'account oppure (Requires project access) un token di account senza un project_id valido. 404 è un id sconosciuto o di un altro account, 422 parametri non validi e 429 il limite di richieste del token.

Il connettore non invia errori a Rollbar (lo fa l'SDK di Rollbar nella tua app), non elimina item e non crea progetti, team, utenti o access token.

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 Rollbar.

Tool disponibili

Esempi di prompt

• "Quali sono gli errori più frequenti in production nelle ultime 24 ore, e quali sono nuovi?"
• "Mostrami lo stack trace completo dell'ultima occorrenza dell'item Rollbar #482."
• "Quali item sono comparsi per la prima volta nella versione 3f9c2ab in production? Raggruppali per livello."
• "Segna come risolto l'item TimeoutError nella versione 1.8.3 e assegna la NullPointerException al team backend."
• "Quante occorrenze error e critical abbiamo avuto al giorno questa settimana rispetto alla settimana scorsa?"

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
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot