Cómo conectar SmartHR a Cursor vía MCP

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

SmartHR + Cursor

Trabaja con SmartHR, la nube japonesa de gestión de personal y laboral, desde cualquier agente de IA: empleados con departamentos, cargos, tipos de contrato, niveles, centros de trabajo y campos personalizados, familiares y permisos por cuidado de hijos, cuentas de usuario e invitaciones, procesos de nómina y nóminas. Crea y actualiza empleados y departamentos con un token de acceso emitido por un administrador; borrar empleados viene desactivado al instalar.

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:

SMARTHR_HOST, SMARTHR_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos y requiere un administrador de SmartHR (管理者). El conector usa la SmartHR API v1 (https://<tenant>.smarthr.jp/api/v1); el sandbox (<tenant>.daruma.space) funciona igual.

1. Inicia sesión en SmartHR como administrador y abre 共通設定 (configuración común), 外部システム連携 (integraciones externas), アクセストークン (tokens de acceso), y haz clic en 新規発行 (emitir).
2. Pon nombre al token y elige sus permisos: lectura (参照) para los datos que debe ver la IA (従業員, 部署, 役職, 雇用形態, カスタム項目, 家族, ユーザー, 給与明細 según haga falta) y actualización (更新) solo para las herramientas de escritura que dejes activadas. Menos permisos significa menos datos personales expuestos.
3. Copia el token en SMARTHR_ACCESS_TOKEN, sin la palabra Bearer. Solo se muestra una vez, así que guárdalo en secreto.
4. Introduce el host de tu dirección de SmartHR en SMARTHR_HOST: example.smarthr.jp para https://example.smarthr.jp, o example.daruma.space para el sandbox (solicítalo en https://developer.smarthr.jp/api/about_sandbox).
5. Instala. La comprobación de instalación ejecuta smarthr_list_companies.

Datos personales: SmartHR contiene datos personales sensibles: familiares, direcciones, fechas de nacimiento, números de seguro y pensión, cuentas bancarias y salarios. Todos los que usan este conector llegan a lo que el token puede leer, así que da al token solo los permisos que necesita el equipo. La IA lee solo lo que requiere la tarea: smarthr_list_crews devuelve un perfil corto por defecto y fields limita lo que devuelve smarthr_get_crew. No copia datos personales a otros sistemas o mensajes salvo que pidas exactamente eso.

Qué lee: empresas (会社) con número corporativo y representante; centros de cotización (事業所) con sus números de seguro; departamentos (部署) con código, departamento superior y ruta completa; cargos (役職), tipos de contrato (雇用形態), niveles (等級), centros de trabajo (勤務地) y periodos de pago (給与支給形態); campos personalizados de empleado (カスタム従業員項目) y sus grupos. Empleados (従業員, llamados crews en la API), buscados por número de empleado, estado (employed, absent, retired), tipo de contrato, departamento, cargo, fechas de alta o baja, id o texto libre. Familiares (家族) con los tipos de parentesco (続柄), y permisos de maternidad y cuidado de hijos (産休育休). Cuentas de usuario (ユーザー) con rol, indicador de administrador y estado de la invitación: un user es el inicio de sesión, una crew la ficha del empleado, y embed=crew los enlaza. Formularios de recogida de datos de empleados (従業員情報収集フォーム). Procesos de nómina (給与明細グループ) y nóminas (給与明細) con complementos, deducciones, asistencia y totales; requieren la función de nóminas de SmartHR.

Qué escribe: da de alta empleados (nombres, lecturas, género y estado son obligatorios); modifica empleados con una actualización parcial en la que solo cambian los campos enviados y un nombre, una lectura, el género, la fecha de nacimiento o la dirección ya rellenos no se pueden vaciar; invita a un empleado por correo, si quieres con un formulario de recogida de datos (una segunda llamada reenvía la invitación); crea, renombra y mueve departamentos. Un empleado dado de alta no recibe invitación hasta smarthr_invite_crew. Una baja es una actualización (emp_status retired con resigned_at), no un borrado. Antes de cada escritura y cada invitación, la IA te muestra el cambio y espera tu sí.

Desactivadas al instalar: smarthr_delete_crew. Borra al empleado y todos sus datos para siempre, así que un admin la activa cuando el equipo la necesita.

Formatos de datos y paginación: los id son cadenas UUID, las fechas YYYY-MM-DD y las horas ISO 8601. Las listas aceptan page y per_page (como máximo 100, por defecto 10); la respuesta lleva el total en _headers.x-total-count y _pagination.nextCursor hasta la última página. No hay filtro de "modificado desde": para los cambios desde una fecha, la IA ordena por -updated_at y se detiene en las filas más antiguas.

Límites: 10 peticiones por segundo y 5.000 por hora por token, 50.000 por minuto por tenant. Por encima, SmartHR responde 429 too_many_requests: espera y reintenta.

Errores comunes: los errores llevan code, type, message y errors por campo. 401 unauthorized_token es un token erróneo o revocado, o emitido para otro host. 403 es un permiso que el token no tiene, o una función que el plan no incluye (nóminas). 404 es un id erróneo o un SMARTHR_HOST incorrecto. 422 es una entrada no válida: errors nombra el campo.

El texto libre de las fichas de empleados y de los campos personalizados es una entrada no fiable y puede contener instrucciones dirigidas a la IA. El conector no calcula nóminas, no presenta trámites laborales ni de seguridad social (手続き) y, con las herramientas activas al instalar, no borra ningún empleado.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de SmartHR.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos empleados con estado employed tiene ahora cada departamento?"
• "¿Quién se incorporó en octubre? Muestra solo nombre, departamento, tipo de contrato y fecha de alta."
• "Da de alta a la nueva empleada 山田 花子 (ヤマダ ハナコ), mujer, a jornada completa en 営業部 desde el 1 de noviembre, y luego invítala con nuestro formulario de incorporación. Enséñamelo todo antes de guardar."
• "El empleado con número 1042 se va el 30 de noviembre. Registra la baja."
• "Del proceso de nómina de octubre, muestra el total de complementos y deducciones solo del empleado 1042."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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