Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Gusto con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
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.
Prova a chiedere
Prompt di esempio per Gusto
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 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 + Microsoft Copilot
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
- Crea un account gratuito sul Gusto Developer Portal su
https://dev.gusto.come crea un'applicazione. Una nuova applicazione parte nell'ambiente demo, che lavora su aziende di test. - 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. - Copia Client ID e Secret dell'applicazione in
GUSTO_CLIENT_IDeGUSTO_CLIENT_SECRET. - Imposta
GUSTO_API_URLsuhttps://api.gusto-demo.comper un'applicazione demo, oppure suhttps://api.gusto.comquando Gusto avrà approvato la tua applicazione per la produzione. Le chiavi funzionano solo nel loro ambiente. - Per provare prima, crea una demo company nel Developer Portal. Contiene già dipendenti, collaboratori esterni e payroll di esempio.
- 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.
- 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 Microsoft Copilot
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 mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Gusto. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
gusto_get_token_info | Read what this authorization reaches: resource.type and resource.uuid (the company UUID every company tool needs as company_uuid)… |
gusto_get_company | Read the company: name, trade_name, ein, entity_type, company_status, tier, is_suspended, pay_schedule_type, join_date, funding_type… |
gusto_list_locations | List the company's addresses: street, city, state, zip, phone_number and whether each is a mailing address, filing address or active work… |
gusto_list_company_admins | List the company's Gusto admins with uuid, first_name, last_name and email (scope company_admin:read) |
gusto_list_employees | List the company's employees (onboarding, active and terminated) with uuid, name, email, department, onboarding status, terminated… |
gusto_get_employee | Read one employee by UUID: name, email, work_email, phone, date_of_birth, title, department, manager_uuid, hired_at… |
gusto_get_employment_history | Read an employee's employment history: every hire, termination and rehire with its dates and employment status (scope employments:read) |
gusto_list_job_compensations | List the compensations of one job: rate, payment_unit (Hour, Week, Month, Year, Paycheck), flsa_status and effective_date |
gusto_list_contractors | List the company's contractors, individual and business, active and inactive: uuid, type, name or business_name, email, wage_type (Fixed or… |
gusto_get_contractor | Read one contractor by UUID: type, names or business name, email, wage_type, hourly_rate, start_date, is_active, address and department… |
gusto_list_departments | List the company's departments with uuid, title, version and the employees and contractors assigned to each (scope departments:read) |
gusto_get_department | Read one department by UUID: title, its current version (needed by gusto_update_department) and its employees and contractors (scope… |
gusto_create_department | Create a department in the company |
gusto_update_department | Rename a department |
gusto_list_pay_schedules | List the company's pay schedules: uuid, frequency (Every week, Every other week, Twice per month, Monthly...), anchor_pay_date… |
gusto_list_pay_periods | List pay periods with start_date, end_date, pay_schedule_uuid and the payroll of each (check date, processed or not) |
gusto_list_payrolls | List the company's payrolls: payroll_uuid, pay_period, check_date, processed, off_cycle, off_cycle_reason, external and, with… |
gusto_get_payroll | Read one payroll: pay period, check_date, processed, totals and, once calculated or processed, employee_compensations[] per employee… |
gusto_list_contractor_payments | List contractor payments between two dates, newest first, with totals: per payment the contractor_uuid, date, wage, hours, bonus… |
gusto_get_contractor_payment | Read one contractor payment by UUID: contractor_uuid, date, wage, hours, hourly_rate, bonus, reimbursement, wage_total, payment_method… |
gusto_list_time_off_policies | List the company's time off policies (vacation, sick and custom): uuid, name, policy_type, accrual_method, accrual rate and limits… |
gusto_get_time_off_policy | Read one time off policy by UUID, with its accrual rules and employees[] carrying each employee's current balance (scope… |
gusto_list_time_off_requests | List time off requests of the company, past and future: employee, request_type, policy_type and policy_uuid, status (pending, approved… |
gusto_list_earning_types | List the company's earning types, split into default (regular wages, overtime, bonus, commission and others with their own tax treatment)… |
gusto_list_company_benefits | List the benefits the company offers: uuid, benefit_type, description, active, source, partner_name and, with enrollment_count=true, how… |
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?