Come collegare Gusto a Gemini via MCP

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

Gusto + Gemini

Fai leggere alla tua AI i dati di payroll e HR di Gusto: l'azienda, le sue sedi e i suoi admin, i dipendenti con mansioni e retribuzioni, i collaboratori esterni, i reparti, i calendari e i periodi di paga, i payroll elaborati con i totali, i pagamenti ai collaboratori, le regole e le richieste di ferie e permessi, le voci retributive e i benefit. Payroll in sola lettura; può solo creare e rinominare reparti. Accesso con OAuth di Gusto, demo o produzione.

Prerequisiti

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

GUSTO_CLIENT_ID, GUSTO_CLIENT_SECRET, GUSTO_API_URL

Step 1 — Ottieni le credenziali

1. Crea un account gratuito sul Gusto Developer Portal su https://dev.gusto.com e crea un'applicazione. Una nuova applicazione parte nell'ambiente demo, che lavora su aziende di test.
2. Nelle impostazioni dell'applicazione aggiungi l'URI di reindirizzamento https://cloud.anythingmcp.com/api/mcp-oauth/callback (se ospiti AnythingMCP in proprio: <your AnythingMCP URL>/api/mcp-oauth/callback). Gli URI di reindirizzamento di un'applicazione demo si modificano nel portale; per un'applicazione di produzione li cambia Gusto su richiesta.
3. Copia Client ID e Secret dell'applicazione in GUSTO_CLIENT_ID e GUSTO_CLIENT_SECRET.
4. Imposta GUSTO_API_URL su https://api.gusto-demo.com per un'applicazione demo, oppure su https://api.gusto.com quando Gusto avrà approvato la tua applicazione per la produzione. Le chiavi funzionano solo nel loro ambiente.
5. Per provare prima, crea una demo company nel Developer Portal. Contiene già dipendenti, collaboratori esterni e payroll di esempio.
6. Installa il connettore, fai clic su Authorize with Provider e accedi a Gusto come admin principale o admin con accesso completo. Gusto chiede quale azienda collegare: un'autorizzazione copre una sola azienda, quindi per una seconda installa di nuovo il connettore.
7. Esegui gusto_get_token_info. Mostra su quale azienda lavorano gli altri tool e cosa può leggere la tua applicazione.

Payroll in sola lettura: l'AI legge i payroll con totali, tasse e trattenute per dipendente, i calendari di paga, i periodi di paga e i pagamenti ai collaboratori esterni, ma non può preparare, calcolare, inviare o annullare un payroll, pagare i collaboratori, aggiungere dipendenti o chiuderne il rapporto, né modificare le retribuzioni. Le uniche modifiche possibili sono creare un reparto (gusto_create_department) e rinominarlo (gusto_update_department, disattivato all'installazione), e per entrambe chiede prima la tua conferma.

Cosa legge: l'azienda, le sue sedi e i suoi admin, i dipendenti con mansioni, retribuzioni e storico del rapporto di lavoro, i collaboratori esterni, i reparti, le regole per ferie e permessi con i saldi, le richieste di ferie e permessi, le voci retributive e i benefit aziendali. Gli elenchi dei payroll mostrano di default i payroll regolari elaborati negli ultimi sei mesi, con al massimo un anno per richiesta.

Le autorizzazioni arrivano da Gusto: all'accesso non scegli gli scope. Gusto li assegna alla tua applicazione, in modo ampio nell'ambiente demo e in produzione dopo la sua revisione. Le retribuzioni richiedono lo scope compensations:read, i benefit con dati sanitari gli scope :phi. Una chiamata fuori dagli scope della tua applicazione risponde 403.

Token: i token di accesso durano due ore e si rinnovano da soli. Gusto sostituisce il refresh token a ogni rinnovo, quindi non usare la stessa autorizzazione in un altro strumento nello stesso momento: uno dei due dovrebbe accedere di nuovo.

Errori comuni: 401 vuol dire che l'autorizzazione è stata revocata, quindi fai di nuovo clic su Authorize with Provider. 403: alla tua applicazione manca lo scope, oppure l'azienda non è quella che hai autorizzato. 406: la versione dell'API inviata dal connettore è fuori da quelle consentite alla tua applicazione (il Developer Portal ne mostra la versione minima). 429: più di 200 richieste in un minuto, quindi aspetta un minuto.

Il connettore non elabora payroll, non paga i collaboratori, non gestisce assunzioni o cessazioni, non modifica retribuzioni o benefit e non legge moduli fiscali e documenti. Gusto Embedded è un prodotto diverso e non è coperto.

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

Tool disponibili

Esempi di prompt

• "Riassumi l'ultimo payroll elaborato: lordo, tasse e netto per dipendente."
• "Chi è assente la prossima settimana, e quali richieste di ferie e permessi sono ancora in attesa?"
• "Elenca i nostri collaboratori esterni attivi e quanto abbiamo pagato a ciascuno in questo trimestre."
• "Quanti dipendenti abbiamo per reparto, e chi è entrato negli ultimi 90 giorni?"

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