Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade SmartHR con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
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.
Prueba a pedir
Prompts de ejemplo para SmartHR
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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 + Microsoft Copilot
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.
- Inicia sesión en SmartHR como administrador y abre 共通設定 (configuración común), 外部システム連携 (integraciones externas), アクセストークン (tokens de acceso), y haz clic en 新規発行 (emitir).
- 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.
- Copia el token en
SMARTHR_ACCESS_TOKEN, sin la palabra Bearer. Solo se muestra una vez, así que guárdalo en secreto. - Introduce el host de tu dirección de SmartHR en
SMARTHR_HOST:example.smarthr.jppara https://example.smarthr.jp, oexample.daruma.spacepara el sandbox (solicítalo en https://developer.smarthr.jp/api/about_sandbox). - 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 Microsoft Copilot
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 muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
SmartHR. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
smarthr_list_companies | List the companies (会社) of the SmartHR tenant: id, name, corporate number, address and representative |
smarthr_list_biz_establishments | List the business establishments (事業所) used for social and labour insurance: id, name, address, insurance numbers and owner |
smarthr_list_departments | List departments (部署) with id, name, code, position (sort order), parent and full path |
smarthr_get_department | Read one department (部署) with its name, code, parent and position in the tree |
smarthr_create_department | Create a department (部署), optionally under a parent department |
smarthr_update_department | Rename or move a department (部署): name is always sent; code, parent and position only when given |
smarthr_list_job_titles | List job titles (役職, positions) with id, name and rank |
smarthr_list_employment_types | List employment types (雇用形態) with id, name and preset_type (full_timer, part_timer, contract_worker ...) |
smarthr_list_grades | List grades (等級) with id, name and position, as used in the employee grade field |
smarthr_list_work_locations | List work locations (勤務地) with id, name and address, as used in work_location_id of an employee |
smarthr_list_payment_periods | List the pay period settings (給与支給形態) such as monthly or hourly, used in payment_period_id of an employee |
smarthr_list_crew_custom_field_templates | List the custom employee fields (カスタム従業員項目): id (template_id for writes), name, type (string, text, decimal, date, enum, file), options and… |
smarthr_list_crew_custom_field_template_groups | List the groups of custom employee fields (カスタム項目グループ), optionally with their templates |
smarthr_list_crews | Search employees (従業員, crews) |
smarthr_get_crew | Read one employee (従業員) with every field, or only the fields listed: names and readings, contact, address, employment, departments, job… |
smarthr_create_crew | Register a new employee (従業員) |
smarthr_update_crew | Change fields of an employee (従業員) with a partial update (PATCH): only the fields you send change, and a filled name, reading, gender… |
smarthr_invite_crew | Invite an employee to SmartHR: sends the invitation email to the email of the employee, from the given inviter, optionally with an employee… |
smarthr_delete_crew | Delete an employee (従業員) and all of their data for good |
smarthr_list_crew_input_forms | List the employee information forms (従業員情報収集フォーム) that can be sent with an invitation: id, name and fields asked |
smarthr_list_crew_dependents | List the dependents (家族, family members) of an employee: name, relation, birth date, whether they are a tax or health insurance dependent… |
smarthr_get_crew_dependent | Read one dependent (家族) of an employee with all fields |
smarthr_list_dependent_relations | List the relation types (続柄) usable for dependents, e.g. spouse, child; filter spouse returns only spouse relations |
smarthr_list_crew_childcare_leaves | List maternity and childcare leaves (産休育休) of an employee with their periods |
smarthr_list_users | List SmartHR user accounts (ユーザー): id, email, role, admin flag, invitation state and, with embed crew, the linked employee |
smarthr_get_user | Read one SmartHR user account with role, admin flag and invitation dates |
smarthr_list_payrolls | List payroll runs (給与明細グループ): id, payment type (salary or bonus), paid date, period, status (fixed, published) and name |
smarthr_get_payroll | Read one payroll run (給与明細グループ) with its status, dates and settings |
smarthr_list_payslips | List the payslips (給与明細) of a payroll run: per employee the allowances, deductions, attendance and totals |
smarthr_get_payslip | Read one payslip (給与明細) with allowances, deductions, attendance and aggregates |
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?