Cómo conectar Gusto a Gemini vía MCP

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

Gusto + Gemini

Deja que tu IA lea tus datos de nómina y RR. HH. en Gusto: la empresa, sus ubicaciones y administradores, los empleados con sus puestos y tarifas salariales, contratistas, departamentos, calendarios y periodos de pago, nóminas procesadas con totales, pagos a contratistas, políticas y solicitudes de tiempo libre, tipos de ingresos y beneficios. Solo lectura para las nóminas; solo puede crear departamentos y cambiarles el nombre. Inicio de sesión con OAuth de Gusto, en demo o producción.

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:

GUSTO_CLIENT_ID, GUSTO_CLIENT_SECRET, GUSTO_API_URL

Paso 1 — Obtener credenciales

1. Crea una cuenta gratuita en el Gusto Developer Portal en https://dev.gusto.com y crea una aplicación. Una aplicación nueva empieza en el entorno demo, que trabaja con empresas de prueba.
2. En los ajustes de la aplicación, añade la URI de redirección https://cloud.anythingmcp.com/api/mcp-oauth/callback (si alojas AnythingMCP tú mismo: <your AnythingMCP URL>/api/mcp-oauth/callback). Las URI de redirección de una aplicación demo se pueden editar en el portal; en una aplicación de producción, Gusto las cambia si se lo pides.
3. Copia el Client ID y el Secret de la aplicación en GUSTO_CLIENT_ID y GUSTO_CLIENT_SECRET.
4. Pon GUSTO_API_URL en https://api.gusto-demo.com para una aplicación demo, o en https://api.gusto.com cuando Gusto haya aprobado tu aplicación para producción. Las claves solo funcionan en su propio entorno.
5. Para probarlo primero, crea una demo company en el Developer Portal. Viene con empleados, contratistas y nóminas de ejemplo.
6. Instala el conector, haz clic en Authorize with Provider e inicia sesión en Gusto como administrador principal o administrador con acceso total. Gusto pregunta qué empresa conectar: una autorización cubre una sola empresa, así que instala el conector otra vez para una segunda.
7. Ejecuta gusto_get_token_info. Muestra con qué empresa trabajan las demás herramientas y qué puede leer tu aplicación.

Las nóminas son de solo lectura: la IA lee las nóminas con totales, impuestos y deducciones por empleado, los calendarios de pago, los periodos de pago y los pagos a contratistas, pero no puede preparar, calcular, enviar ni cancelar una nómina, pagar a contratistas, dar de alta o de baja a empleados ni cambiar salarios. Los únicos cambios que puede hacer son crear un departamento (gusto_create_department) y cambiarle el nombre (gusto_update_department, desactivada al instalar), y en ambos casos te pide confirmación antes.

Qué lee: la empresa, sus ubicaciones y administradores, los empleados con sus puestos, tarifas salariales e historial laboral, los contratistas, los departamentos, las políticas de tiempo libre con sus saldos, las solicitudes de tiempo libre, los tipos de ingresos y los beneficios de la empresa. Las listas de nóminas muestran por defecto las nóminas regulares procesadas en los últimos seis meses, con hasta un año por solicitud.

Los permisos vienen de Gusto: no eliges scopes al iniciar sesión. Gusto se los asigna a tu aplicación, de forma amplia en el entorno demo y en producción después de su revisión. Las tarifas salariales necesitan el scope compensations:read, y los beneficios con información de salud, los scopes :phi. Una llamada fuera de los scopes de tu aplicación responde 403.

Tokens: los tokens de acceso duran dos horas y se renuevan automáticamente. Gusto sustituye el refresh token en cada renovación, así que no uses la misma autorización en otra herramienta a la vez: una de las dos tendría que volver a iniciar sesión.

Errores comunes: 401 significa que la autorización se revocó, así que haz clic de nuevo en Authorize with Provider. 403: a tu aplicación le falta el scope, o la empresa no es la que autorizaste. 406: la versión de la API que envía el conector está fuera de lo que permite tu aplicación (el Developer Portal muestra su versión mínima). 429: más de 200 solicitudes en un minuto, así que espera un minuto.

El conector no procesa nóminas, no paga a contratistas, no gestiona altas ni bajas de personal, no cambia salarios ni beneficios y no lee formularios fiscales ni documentos. Gusto Embedded es otro producto y no está incluido.

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

Herramientas disponibles

Ejemplos de prompts

• "Resume nuestra última nómina procesada: salario bruto, impuestos y salario neto por empleado."
• "¿Quién está ausente la semana que viene y qué solicitudes de tiempo libre siguen pendientes?"
• "Enumera nuestros contratistas activos y cuánto le pagamos a cada uno este trimestre."
• "¿Cuántos empleados tenemos por departamento y quién se incorporó en los últimos 90 días?"

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