Cómo conectar Rippling a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Rippling, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Rippling + Gemini

La plataforma de RR. HH. Rippling a través de su REST API: workers y usuarios, departamentos, equipos, centros de trabajo, niveles, puestos, tipos de empleo y campos personalizados, compensación, tipos, saldos y solicitudes de ausencia, supergroups y registros de tiempo. Además registra y aprueba ausencias, registra horas, mantiene la estructura organizativa y crea draft hires.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

RIPPLING_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas un usuario de Rippling con el permiso Create and manage API Tokens y acceso a los datos que la IA debe leer.

1. En Rippling abre Developer > API credentials (https://app.rippling.com/api-tokens/tokens) y haz clic en New API token.
2. Ponle un nombre al token y elige sus scopes. El token solo llega a los datos que permiten a la vez sus scopes y el perfil de permisos de su propietario. Elige lo que uses:
   • companies.read (obligatorio, la comprobación de instalación), más 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 si la IA debe ver los salarios.
   • leave-types.read, leave-balances.read, leave-requests.read y leave-requests.read-write para registrar o aprobar ausencias.
   • time-entries.read y time-entries.read-write para registrar tiempo (requiere Rippling Time).
   • departments.read-write, teams.read-write, work-locations.read-write y draft-hires.read-write para las escrituras correspondientes.
3. Copia el token enseguida (solo se muestra una vez) en RIPPLING_API_TOKEN, sin Bearer. Instala el conector: rippling_list_companies es la comprobación de instalación.

Las peticiones se ejecutan como el propietario del token. Rippling revoca un token que pasa 30 días sin usarse y los tokens de un propietario que deja la empresa, así que elige un propietario con un acceso estable.

Datos personales: workers, usuarios y paquetes de compensación contienen datos personales y salariales: nombres, emails privados, teléfonos, domicilios, fecha de nacimiento, género y salario. Pide solo los campos que necesita la tarea, no los copies a otros sistemas sin motivo y da al token solo los scopes que usa el equipo.

Qué lee: la empresa (rippling_list_companies); los workers, es decir, las relaciones laborales de empleados y contratistas, con estado, email de trabajo y personal, fecha de alta y de baja, puesto, departamento, responsable, nivel, equipos, ubicación, tipo de empleo y país (rippling_list_workers, rippling_get_worker); los usuarios, la identidad de acceso detrás del user_id de un worker (rippling_list_users, rippling_get_user); los paquetes de compensación con importes anuales, mensuales, semanales y por hora, objetivos de bonus y comisiones (rippling_list_compensations y rippling_get_compensation con el compensation_id del worker); las definiciones de campos personalizados (rippling_list_custom_fields), cuyos valores llegan con expand=custom_fields en los workers; la estructura organizativa con departamentos, equipos, centros de trabajo, niveles, puestos, tipos de empleo y job codes; los supergroups y sus miembros; los tipos de ausencia, los saldos en horas y días y las solicitudes de ausencia; los registros de tiempo con job shifts, pausas, duración, estado y periodo de pago. expand (por ejemplo user,manager,department) incrusta los objetos relacionados en una sola llamada.

Qué escribe:

• Ausencias: rippling_create_leave_request registra una ausencia para un worker (PENDING sigue el flujo normal de aprobación, APPROVED registra una ausencia ya acordada); rippling_update_leave_request la aprueba, rechaza o cancela mediante status, o cambia sus fechas y comentarios.
• Tiempo: rippling_create_time_entry registra tiempo trabajado como job shifts con hora de inicio y fin o como duración en un día; acepta un idempotency_key para que un reintento no cree un duplicado. rippling_update_time_entry cambia un registro; la API exige worker_id aunque no cambie.
• Estructura organizativa: rippling_create_department, rippling_update_department, rippling_create_team, rippling_update_team, rippling_create_work_location y rippling_update_work_location. Las actualizaciones solo cambian los campos enviados.
• Contratación: rippling_create_draft_hires crea hasta cinco draft hires, que pasan por la revisión y aprobación de Rippling antes de que se contrate a nadie.

Desactivadas al instalar: rippling_delete_team (los workers pierden la asignación al equipo) y rippling_delete_time_entry. Ninguna se puede deshacer; un administrador del workspace las activa cuando el equipo las necesita.

Filtros: filter acepta una expresión estilo OData sobre los campos que indica cada herramienta, por ejemplo status eq 'ACTIVE', updated_at ge 2026-01-01T00:00:00 o status in ('HIRED','ACCEPTED'), combinada con and y or. Las cadenas van entre comillas simples y un filtro tiene como máximo 64 nodos. Saldos de un worker: worker_id eq '...'; solicitudes pendientes: status eq 'PENDING'.

Formatos de datos: los ids son cadenas hexadecimales de 24 caracteres. Las fechas son YYYY-MM-DD y las marcas de tiempo ISO 8601 con desfase. El dinero es { "currency_type": "USD", "value": 120000 } en unidades enteras de la moneda. El status del worker es INIT, HIRED, ACCEPTED, ACTIVE o TERMINATED. Un campo que el token no puede ver vuelve como null y aparece con el motivo en __meta.redacted_fields, así que null no demuestra que el campo esté vacío: revisa primero los scopes y los permisos del propietario.

Paginación: las listas responden con results y next_link, 50 elementos por defecto y hasta 100 con limit. Mientras next_link no sea null, la IA vuelve a llamar con cursor igual al valor del cursor dentro de next_link.

Límites y errores comunes: 600 peticiones cada 10 segundos por endpoint y token, después 429 (espera unos segundos y reintenta). 400 indica un filtro incorrecto, un campo que no se puede expandir o limit mayor que 100; 401 un token erróneo o revocado; 403 un scope que falta o un permiso que el propietario no tiene; 404 un id desconocido.

El conector no edita los datos de los workers ni la compensación, no contrata ni despide a nadie directamente y no procesa nóminas.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Rippling.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién se ha incorporado en los últimos 30 días? Lista nombre, puesto, departamento, responsable y fecha de alta."
• "Muéstrame todas las solicitudes de ausencia pendientes con worker, fechas, horas y tipo de ausencia."
• "¿Cuántas vacaciones le quedan a Maria Lopez, en días y en horas?"
• "Aprueba la solicitud de vacaciones pendiente de Maria Lopez del 10 al 14 de noviembre."
• "¿Cuántos workers activos tenemos por departamento y centro de trabajo?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot