Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Rippling 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
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.
Prova a chiedere
Prompt di esempio per Rippling
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 → Rippling, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Rippling + Meta Muse
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.
- In Rippling apri Developer > API credentials (
https://app.rippling.com/api-tokens/tokens) e fai clic su New API token. - 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.readsolo se l'AI deve vedere le retribuzioni.leave-types.read,leave-balances.read,leave-requests.readeleave-requests.read-writeper registrare o approvare assenze.time-entries.readetime-entries.read-writeper registrare ore (richiede Rippling Time).departments.read-write,teams.read-write,work-locations.read-writeedraft-hires.read-writeper le scritture corrispondenti.
- Copia subito il token (viene mostrato una sola volta) in
RIPPLING_API_TOKEN, senzaBearer. 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_requestregistra un'assenza per un worker (PENDINGsegue il normale flusso di approvazione,APPROVEDregistra un'assenza già concordata);rippling_update_leave_requestla approva, la rifiuta o la annulla tramitestatus, oppure ne cambia date e commenti. - Ore:
rippling_create_time_entryregistra il tempo lavorato come job shift con ora di inizio e fine o come durata in un giorno; accetta unidempotency_key, così un nuovo tentativo non crea un duplicato.rippling_update_time_entrymodifica una registrazione; l'API vuoleworker_idanche quando non cambia. - Struttura organizzativa:
rippling_create_department,rippling_update_department,rippling_create_team,rippling_update_team,rippling_create_work_locationerippling_update_work_location. Gli aggiornamenti cambiano solo i campi inviati. - Assunzioni:
rippling_create_draft_hirescrea 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 Muse
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.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Rippling.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
rippling_list_companies | List the Rippling company the token belongs to (name, legal name, primary email, address, legal entities when expanded) |
rippling_list_workers | List workers (employees and contractors): status, work and personal email, start and end date, title, department, manager, level, teams… |
rippling_get_worker | Read one worker by id with the same fields as rippling_list_workers; expand user, manager or custom_fields for more |
rippling_list_users | List users (the login identity behind a worker): name, display name, emails, phone numbers, addresses, time zone, locale and whether the… |
rippling_get_user | Read one user by id: name, emails, phone numbers, addresses, locale and time zone |
rippling_list_compensations | List compensation packages the token owner may see: annual, monthly, weekly and hourly amounts with currency, bonus targets, commission and… |
rippling_get_compensation | Read one compensation package by id (the compensation_id of a worker) |
rippling_list_custom_fields | List the company's custom fields on employees: id, name, description, data type (TEXT, DATE, NUMBER, SELECT and more), whether required… |
rippling_list_departments | List departments with name, reference code, parent department and the hierarchy of department ids from the top |
rippling_get_department | Read one department by id: name, reference code, parent and the chain of parent departments |
rippling_list_teams | List teams with their name and parent team, to resolve the teams_id values on workers |
rippling_get_team | Read one team by id: name and parent team (expand parent for its details) |
rippling_list_work_locations | List work locations (offices) with name and full address, to resolve a worker's location |
rippling_get_work_location | Read one work location by id (the location.work_location_id of a worker) |
rippling_list_levels | List job levels with name, parent level, track and rank, to resolve the level_id of workers |
rippling_get_level | Read one job level by id: name, parent level and track (expand track for its name) |
rippling_list_titles | List the job titles defined in the company, with id and name, for consistent title values |
rippling_list_employment_types | List employment types: label, CONTRACTOR or EMPLOYEE, HOURLY or SALARIED, FULL-TIME, PART-TIME or TEMPORARY |
rippling_list_job_codes | List job codes (the codes workers log time against) with their job dimension, department and work location |
rippling_list_supergroups | List supergroups: the attribute-based groups Rippling uses for policies, apps and workflows (name, type, description, whether terminated… |
rippling_get_supergroup | Read one supergroup by id: name, type, description and membership settings |
rippling_list_supergroup_members | List the members of a supergroup: worker id, full name and work email |
rippling_list_leave_types | List leave types (vacation, sick and others): name, type, description, whether paid and whether managed by an external system |
rippling_list_leave_balances | List leave balances per worker and leave type: whether unlimited, balance with and without future requests, in hours and in days |
rippling_get_leave_balance | Read one leave balance by id: worker, leave type and remaining balance in hours and days |
rippling_list_leave_requests | List leave requests with worker, requester, reviewer, status (PENDING, APPROVED, REJECTED, CANCELED), dates, hours, leave type and comments |
rippling_get_leave_request | Read one leave request by id: worker, status, dates, hours, leave type, reviewer and comments |
rippling_list_time_entries | List time entries (worked shifts with job shifts, breaks, duration, status DRAFT, APPROVED, PAID or FINALIZED, pay period and tags) |
rippling_get_time_entry | Read one time entry by id: job shifts, breaks, duration, status, pay period and comments |
rippling_create_department | Create a department, optionally under a parent department and with a reference code |
rippling_update_department | Change a department's name, parent or reference code |
rippling_create_team | Create a team, optionally nested under a parent team; assign workers to it in Rippling |
rippling_update_team | Rename a team or move it under another parent team |
rippling_delete_team | Delete a team; workers lose the team assignment |
rippling_create_work_location | Create a work location (office) with its name and postal address, for assigning workers |
rippling_update_work_location | Rename a work location or change its address |
rippling_create_leave_request | File a leave request for a worker |
rippling_update_leave_request | Approve, reject or cancel a leave request (status), or change its dates and comments |
rippling_create_time_entry | Record worked time for a worker, as job shifts with start and end times or as a duration on a day |
rippling_update_time_entry | Change a time entry: shifts, breaks, duration, comments, tags or status. worker_id is required by the API even when unchanged |
rippling_delete_time_entry | Delete a time entry permanently, e.g. a duplicate |
rippling_create_draft_hires | Create draft hires that then follow Rippling's review and approval policies before anyone is hired |
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
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?