Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade HiBob 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
La plataforma de RR. HH. HiBob (Bob) mediante su API pública con un service user: búsqueda y fichas de empleados, historial laboral, de empleo, de ciclo de vida y salarial, tablas personalizadas, listas de la empresa, ausencias con quién falta, solicitudes, saldos y políticas, festivos, informes guardados, onboarding, tareas y documentos. Las escrituras en datos maestros vienen desactivadas.
Prueba a pedir
Prompts de ejemplo para HiBob
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 → HiBob, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
HiBob + ChatGPT
La plataforma de RR. HH. HiBob (Bob) mediante su API pública con un service user: búsqueda y fichas de empleados, historial laboral, de empleo, de ciclo de vida y salarial, tablas personalizadas, listas de la empresa, ausencias con quién falta, solicitudes, saldos y políticas, festivos, informes guardados, onboarding, tareas y documentos. Las escrituras en datos maestros vienen desactivadas.
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:
HIBOB_SERVICE_USER_ID, HIBOB_SERVICE_USER_TOKEN
Paso 1 — Obtener credenciales
La configuración lleva unos 10 minutos y necesita un administrador de Bob. El conector usa la API REST pública de Bob (https://api.hibob.com/v1) con un service user.
- En Bob, como administrador, ve a Settings > Integrations > Automation > Service Users, haz clic en Manage y crea un service user con un nombre y un nombre visible. Copia enseguida su ID y su token: el token solo se muestra al generarlo. Un token perdido se puede regenerar, lo que invalida el anterior.
- Crea un grupo de permisos (permission group) propio para el service user y añádelo. Un grupo nuevo no tiene permisos, así que concede solo lo que uses:
- People's data > People's fields: View en las categorías que lees (como mínimo root, about, employment y work para
hibob_search_people), View history en las tablas de historial (work, employment, lifecycle, payroll), Edit donde actualices. - Access data for: Everyone o una condición. Por defecto solo se cubre a las personas en plantilla; quita la condición Lifecycle status equals Employed para leer bajas con
show_inactive. - People's data > Time off: ver solicitudes y saldos, y enviar o cancelar solicitudes si usas esas herramientas; ver solicitudes privadas para
include_private. - Features > Reports: View reports according to people's data access rights.
- People's data > Tasks and flow > People's tasks: View and mark selected people's tasks as complete.
- People's data > Docs > [carpeta]: View por carpeta de documentos, y Upload para la carpeta compartida.
- People's data > People's fields: View en las categorías que lees (como mínimo root, about, employment y work para
- Pega el ID en
HIBOB_SERVICE_USER_IDy el token enHIBOB_SERVICE_USER_TOKEN. Se envían como autenticación HTTP Basic. - Instala el conector y ejecuta
hibob_list_employee_fieldspara comprobar el acceso.
Primero los ids de campo: hibob_list_employee_fields lista cada campo estándar y personalizado con su id en notación de puntos (root.displayName, work.department, work.custom.field_123) y el id de lista de los campos de lista. hibob_list_named_lists y hibob_get_named_list convierten ids de lista en nombres (departamentos, sedes, puestos, calendarios).
Qué lee:
- Personas:
hibob_search_peoplelee muchos empleados en una llamada (todos, o filtrados solo porroot.idoroot.email; otros filtros se rechazan),hibob_get_employeeuna persona por id o email de trabajo,hibob_list_profilesun directorio rápido. En una empresa grande la IA busca primero confields: ["root.id"]y luego lee de 50 a 200 ids por llamada. - Tablas de historial de una persona (work, employment, lifecycle, salary) y en bloque para muchas (work, lifecycle, salary).
- Tablas personalizadas con sus columnas y las entradas de un empleado.
- Ausencias: quién falta en un rango de fechas o un día, solicitudes cambiadas desde un momento, una solicitud con sus días, el saldo de un empleado para un tipo de política, tipos de política, códigos de motivo, políticas, y festivos y cierres de la empresa con
hibob_search_calendar_events. - Informes guardados, ejecutados como filas JSON, CSV o XLSX; los grandes se generan en segundo plano con
hibob_request_report_downloady se descargan conhibob_download_report_by_name. - Asistentes de onboarding, tareas abiertas de toda la empresa, las tareas de un empleado, carpetas de documentos y los documentos de un empleado con enlaces de descarga.
Qué escribe tras instalarlo: hibob_submit_time_off_request (la IA comprueba antes la unidad del tipo de política con hibob_get_policy_type; la solicitud sigue el flujo de aprobación de la política, salvo que un administrador active skip_manager_approval), hibob_cancel_time_off_request y hibob_complete_task.
Desactivadas al instalar: las escrituras en datos maestros hibob_update_employee (solo campos, no filas de tablas), hibob_create_work_entry (ascenso, traslado, nuevo responsable), hibob_create_custom_table_entry, hibob_add_named_list_item y hibob_upload_shared_document (una URL pública o prefirmada, como máximo 5 MB, visible para el empleado). Un administrador del espacio de trabajo las activa a conciencia en el conector.
Formatos de datos: los ids de empleado son números largos enviados como cadenas (3332883884017713238). Las peticiones usan notación de puntos (work.department); las respuestas usan claves con barras (/work/department) y pueden anidar además el mismo valor por categoría. Los campos de lista contienen ids de elementos; human_readable: APPEND o REPLACE añade los nombres o los pone en su lugar. Las fechas son YYYY-MM-DD; hibob_list_time_off_changes acepta fechas y horas ISO 8601. Los saldos están en la unidad del tipo de política (días u horas) y los salarios llevan su propia moneda. Tras una actualización, Bob puede devolver el valor antiguo durante hasta 20 segundos.
Omisión silenciosa: un campo sin permiso o con un id erróneo simplemente falta en la respuesta, sin error. Si falta algo, revisa el grupo de permisos del service user antes de concluir que el valor está vacío.
Paginación: la búsqueda de personas, los perfiles, el historial de un empleado, las tareas abiertas (como máximo 5.000) y quién falta devuelven todo de una vez. Las herramientas de historial en bloque y hibob_search_calendar_events paginan con cursor igual a response_metadata.next_cursor; la IA para cuando es null.
Límites: los límites de peticiones se aplican por endpoint (la búsqueda de personas admite 50 peticiones por minuto) y responden 429. Quién falta y los rangos del calendario tienen una amplitud máxima, y los cambios de ausencias llegan como mucho a 6 meses atrás.
Errores comunes: 401 indica un ID o un token incorrecto, 403 un permiso que falta en el grupo del service user, 400 un filtro, campo o rango de fechas no válido. El firewall de Bob puede bloquear durante un tiempo las respuestas 401 o 403 repetidas, así que corrige los permisos antes de reintentar.
El conector no procesa nóminas, no cambia filas de tablas de historial con hibob_update_employee y no tiene herramientas para aprobar o rechazar solicitudes de ausencia pendientes.
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 ChatGPT
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.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
HiBob. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Tool | What it does |
|---|---|
hibob_search_people | Read employee fields for many employees in one call: everyone the service user can access, or only the employees whose id or email is given… |
hibob_get_employee | Read the fields of one employee, identified by employee id or work email |
hibob_update_employee | Update fields of one employee record |
hibob_list_profiles | Public profile section of every active employee the service user can access: a fixed set of fields such as name, email, work title… |
hibob_list_employee_fields | All employee fields defined in the company (built-in and custom) with their field id (the dot-notation id to pass in fields), name… |
hibob_list_named_lists | All company lists (departments, sites, job titles, calendars, custom lists) with their items: each item has an id, the value Bob stores in… |
hibob_get_named_list | One company list by its internal name (e.g. department, site, title, calendar), with its items, their ids and names, and child items for… |
hibob_add_named_list_item | Add a new item to an existing company list, for example a new department or job title, optionally below a parent item in a hierarchy list |
hibob_list_work_history | Work history of one employee: one entry per change with effective date, title, department, site, manager (reportsTo) and reason |
hibob_list_employment_history | Employment history of one employee: contract type, weekly hours, working pattern, FTE and similar entries, each with its effective date |
hibob_list_lifecycle_history | Lifecycle status history of one employee: hired, employed, on leave, terminated and so on, each with its effective date and reason |
hibob_list_salary_history | Salary (payroll) history of one employee: base pay amount, currency, pay period and frequency, each entry with its effective date |
hibob_bulk_list_work_history | Work history for many employees at once (one page of employees per call, each with all its work entries) |
hibob_bulk_list_lifecycle_history | Lifecycle history for many employees at once (one page of employees per call, each with all its lifecycle entries) |
hibob_bulk_list_salary_history | Salary history for many employees at once (one page of employees per call, each with all its salary entries) |
hibob_create_work_entry | Add a work history entry for an employee (promotion, transfer, new manager, department change) taking effect on a given date |
hibob_list_custom_tables | Custom employee tables defined in the company, with their ids, names and column definitions |
hibob_get_custom_table_metadata | Definition of one custom employee table: its columns with id, name, type and the list id for list columns |
hibob_list_custom_table_entries | All entries of one custom table for one employee; values are keyed by column id |
hibob_create_custom_table_entry | Add one or more entries to an employee's custom table |
hibob_list_whos_out | Time off requests in a date range, for everyone the service user can access: who is out, which policy, request type, dates and status |
hibob_list_out_today | Who is out of the office today (UTC) or on one given date, optionally only at one site |
hibob_list_time_off_changes | Time off requests created, approved, declined, cancelled or deleted since a point in time (at most 6 months back and a 6-month window) |
hibob_get_time_off_request | Details of one time off request of an employee: policy type, dates, portions, status, approver, total cost and (by default) the duration… |
hibob_get_time_off_balance | Time off balance of one employee for one policy type on a given date: the amount available, used, pending and accrued, in the policy's unit… |
hibob_list_policy_types | Names of all time off policy types in the company (Holiday, Sick, custom types) |
hibob_get_policy_type | Settings of one time off policy type: unit (days or hours), allowed request types, whether it is a working type, visibility and similar… |
hibob_list_policy_type_reason_codes | Reason codes defined for one time off policy type, with the numeric id to pass as reason_code when submitting a request |
hibob_list_policy_names | Names of the policies (for example per country or contract) that belong to one time off policy type |
hibob_get_policy | Details of one time off policy: its type, allowance, accrual, carry-over and other rules |
hibob_search_calendar_events | Company holidays and closures (calendar events) in a date range, optionally for one calendar, site or event type |
hibob_submit_time_off_request | Submit a time off request for an employee |
hibob_cancel_time_off_request | Cancel an existing time off request of an employee |
hibob_list_reports | Company reports saved in Bob that the service user can see, with id, name, description, type, folder and dates (the column configuration is… |
hibob_download_report | Run a saved report and return its data. format json gives rows the model can read directly; csv returns text; xlsx returns a file |
hibob_request_report_download | Start generating a saved report in the background, for reports too large to download at once |
hibob_download_report_by_name | Fetch a report file generated by hibob_request_report_download |
hibob_list_onboarding_wizards | Onboarding wizards configured in Bob (id and name), the flows new hires are invited with |
hibob_list_open_tasks | All open tasks in the company (onboarding, offboarding and other flow tasks) with owner, related employee, due date and status |
hibob_list_employee_tasks | Tasks assigned to one employee (onboarding and other flow tasks), open, closed or both |
hibob_complete_task | Mark a task as complete, for example an onboarding step that was done outside Bob |
hibob_list_document_folders | Document folders defined in Bob (shared, confidential and custom folders) with their ids and metadata |
hibob_list_employee_documents | Documents of one employee in the folders the service user may view, with name and a download link per document |
hibob_upload_shared_document | Add a document to an employee's shared folder by giving a public or pre-signed URL that Bob downloads (max 5 MB) |
Ejemplos de prompts
- "¿Quién está fuera de la oficina la semana que viene, y con qué política de ausencia?"
- "Muestra el historial laboral de [email protected]: puestos, departamentos y responsables con sus fechas de efecto."
- "¿Cuántos días de vacaciones le quedan este año al empleado 3332883884017713238, y cuántos están pendientes?"
- "Ejecuta el informe guardado "Headcount by department" y resúmelo por sede."
- "Lista todas las tareas de onboarding abiertas y vencidas, con su responsable y la nueva incorporación a la que pertenecen."
FAQ
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?