Come collegare Rippling a Claude via MCP

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

Rippling + Claude

La piattaforma HR Rippling tramite la sua REST API: worker e utenti, reparti, team, sedi di lavoro, livelli, qualifiche, tipi di impiego e campi personalizzati, retribuzioni, tipi di assenza, saldi e richieste, supergroup e registrazioni orarie. Inoltre registra e approva assenze, registra ore, gestisce la struttura organizzativa e crea draft hire.

Prerequisiti

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

RIPPLING_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti serve un utente Rippling con il permesso Create and manage API Tokens e accesso ai dati che l'AI deve leggere.

1. In Rippling apri Developer > API credentials (https://app.rippling.com/api-tokens/tokens) e fai clic su New API token.
2. Dai un nome al token e scegli i suoi scope. Il token raggiunge solo i dati consentiti sia dai suoi scope sia dal profilo di permessi del suo proprietario. Scegli quello che usi:
   • companies.read (obbligatorio, il controllo di installazione), più workers.read, users.read, departments.read, teams.read, work-locations.read, levels.read, titles.read, employment-types.read, job-codes.read, custom-fields.read, supergroups.read.
   • compensations.read solo se l'AI deve vedere le retribuzioni.
   • leave-types.read, leave-balances.read, leave-requests.read e leave-requests.read-write per registrare o approvare assenze.
   • time-entries.read e time-entries.read-write per registrare ore (richiede Rippling Time).
   • departments.read-write, teams.read-write, work-locations.read-write e draft-hires.read-write per le scritture corrispondenti.
3. Copia subito il token (viene mostrato una sola volta) in RIPPLING_API_TOKEN, senza Bearer. Installa il connettore: rippling_list_companies è il controllo di installazione.

Le richieste girano come il proprietario del token. Rippling revoca un token rimasto inutilizzato per 30 giorni e i token di un proprietario che lascia l'azienda, quindi scegli un proprietario con un accesso stabile.

Dati personali: worker, utenti e pacchetti retributivi contengono dati personali e salariali: nomi, email private, numeri di telefono, indirizzi di casa, data di nascita, genere e stipendio. Chiedi solo i campi che servono al compito, non copiarli in altri sistemi senza motivo e dai al token solo gli scope che il team usa.

Cosa legge: l'azienda (rippling_list_companies); i worker, cioè i rapporti di lavoro di dipendenti e collaboratori, con stato, email aziendale e personale, data di inizio e di fine, qualifica, reparto, responsabile, livello, team, sede, tipo di impiego e paese (rippling_list_workers, rippling_get_worker); gli utenti, l'identità di accesso dietro lo user_id di un worker (rippling_list_users, rippling_get_user); i pacchetti retributivi con importi annuali, mensili, settimanali e orari, obiettivi di bonus e provvigioni (rippling_list_compensations e rippling_get_compensation con il compensation_id del worker); le definizioni dei campi personalizzati (rippling_list_custom_fields), i cui valori arrivano con expand=custom_fields sui worker; la struttura organizzativa con reparti, team, sedi di lavoro, livelli, qualifiche, tipi di impiego e job code; i supergroup e i loro membri; i tipi di assenza, i saldi in ore e giorni e le richieste di assenza; le registrazioni orarie con job shift, pause, durata, stato e periodo di paga. expand (ad esempio user,manager,department) incorpora gli oggetti collegati in una sola chiamata.

Cosa scrive:

• Assenze: rippling_create_leave_request registra un'assenza per un worker (PENDING segue il normale flusso di approvazione, APPROVED registra un'assenza già concordata); rippling_update_leave_request la approva, la rifiuta o la annulla tramite status, oppure ne cambia date e commenti.
• Ore: rippling_create_time_entry registra il tempo lavorato come job shift con ora di inizio e fine o come durata in un giorno; accetta un idempotency_key, così un nuovo tentativo non crea un duplicato. rippling_update_time_entry modifica una registrazione; l'API vuole worker_id anche quando non cambia.
• Struttura organizzativa: rippling_create_department, rippling_update_department, rippling_create_team, rippling_update_team, rippling_create_work_location e rippling_update_work_location. Gli aggiornamenti cambiano solo i campi inviati.
• Assunzioni: rippling_create_draft_hires crea fino a cinque draft hire, che passano dalla revisione e dall'approvazione di Rippling prima che qualcuno venga assunto.

Disattivati all'installazione: rippling_delete_team (i worker perdono l'assegnazione al team) e rippling_delete_time_entry. Nessuno dei due si può annullare; un amministratore del workspace li attiva quando servono al team.

Filtri: filter accetta un'espressione in stile OData sui campi indicati da ciascuno strumento, ad esempio status eq 'ACTIVE', updated_at ge 2026-01-01T00:00:00 o status in ('HIRED','ACCEPTED'), combinata con and e or. Le stringhe vanno tra apici singoli e un filtro ha al massimo 64 nodi. Saldi di un worker: worker_id eq '...'; richieste aperte: status eq 'PENDING'.

Formati dei dati: gli id sono stringhe esadecimali di 24 caratteri. Le date sono YYYY-MM-DD, i timestamp ISO 8601 con offset. Gli importi sono { "currency_type": "USD", "value": 120000 } in unità intere della valuta. Lo status del worker è INIT, HIRED, ACCEPTED, ACTIVE o TERMINATED. Un campo che il token non può vedere torna null ed è indicato con il motivo in __meta.redacted_fields: null quindi non prova che il campo sia vuoto, controlla prima gli scope e i permessi del proprietario.

Paginazione: gli elenchi rispondono con results e next_link, 50 elementi di default e fino a 100 con limit. Finché next_link non è null, l'AI richiama lo strumento con cursor uguale al valore del cursore contenuto in next_link.

Limiti ed errori comuni: 600 richieste ogni 10 secondi per endpoint e token, poi 429 (aspetta qualche secondo e riprova). 400 indica un filtro errato, un campo non espandibile o limit oltre 100; 401 un token errato o revocato; 403 uno scope mancante o un permesso che il proprietario non ha; 404 un id sconosciuto.

Il connettore non modifica i dati dei worker né le retribuzioni, non assume né licenzia nessuno direttamente e non elabora le buste paga.

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 Claude

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.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Rippling, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Chi è entrato in azienda negli ultimi 30 giorni? Elenca nome, qualifica, reparto, responsabile e data di inizio."
• "Mostrami tutte le richieste di assenza in attesa con worker, date, ore e tipo di assenza."
• "Quante ferie restano a Maria Lopez, in giorni e in ore?"
• "Approva la richiesta di ferie in attesa di Maria Lopez dal 10 al 14 novembre."
• "Quanti worker attivi abbiamo per reparto e sede di lavoro?"

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot