Cómo conectar Recruitee a ChatGPT vía MCP

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

Recruitee + ChatGPT

Seguimiento de candidatos con Recruitee (Tellent Recruitee): ofertas de empleo y talent pools, candidatos con búsqueda completa, pipelines y fases, placements, notas, etiquetas, departamentos, ubicaciones, entrevistas y evaluaciones, tareas y el feed de actividad. Además mueve candidatos entre fases y crea y publica ofertas. Recruitee ATS API con un token de API personal.

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:

RECRUITEE_COMPANY_ID, RECRUITEE_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos.

1. En Recruitee abre Settings > Apps and plugins > Personal API tokens (https://app.recruitee.com/#/settings/api_tokens), haz clic en Add new token, ponle una etiqueta y confirma tu contraseña. Copia el token en RECRUITEE_API_TOKEN; no se puede volver a mostrar.
2. Copia el company ID que aparece en la misma página (un número) en RECRUITEE_COMPANY_ID. El subdominio de la empresa también sirve.
3. Instala el conector: recruitee_get_current_admin es la comprobación de instalación.

El token actúa como tú, con tu rol, solo en esa empresa; otra empresa necesita su propio token. Recruitee no permite limitar el alcance de un token, así que créalo con un usuario cuyo rol encaje con lo que debe hacer la IA.

Datos personales: los candidatos son personas que se postulan, con CV, datos de contacto, evaluaciones y a veces fecha de nacimiento o nacionalidad. Pide solo lo que necesita la tarea, respeta los ajustes de RGPD de la empresa y no copies datos de candidatos a otras herramientas sin motivo.

El vocabulario de Recruitee: una oferta de empleo es un offer (kind job; un talent pool es un offer con kind talent_pool). Un candidato en una oferta es un placement, que lleva la fase y la descalificación para esa oferta. Los miembros del equipo son admins.

Qué lee:

• Equipo: recruitee_get_current_admin y recruitee_list_admins (ids para responsables de tareas y filtros).
• Ofertas: recruitee_list_offers (filtros por statuses como published, tipo, departamento, ubicación, etiqueta, recruiter o hiring manager), recruitee_get_offer (descripción, requisitos, equipo de contratación y las fases del pipeline con sus ids) y recruitee_list_offer_notes.
• Candidatos: recruitee_list_candidates (filtros simples), recruitee_search_candidates (búsqueda completa con filters_json), recruitee_get_candidate (contacto, enlaces al CV y a la carta de presentación, fuentes, etiquetas, campos personalizados, valoraciones, placements y respuestas a preguntas), recruitee_list_candidate_notes, recruitee_list_candidate_tasks y recruitee_list_candidate_activities. El feed de toda la empresa: recruitee_list_activities.
• Pipeline de una oferta: recruitee_list_placements (quién está en qué fase), recruitee_list_pipeline_templates, recruitee_get_pipeline_template y recruitee_list_disqualify_reasons.
• Listas de referencia: recruitee_list_departments, recruitee_get_department, recruitee_list_locations, recruitee_get_location, recruitee_list_tags y recruitee_list_sources.
• Entrevistas: recruitee_list_interview_events (por defecto las próximas), recruitee_get_interview_event y recruitee_list_interview_results (evaluaciones y scorecards). Tareas: recruitee_list_tasks.

Qué escribe:

• Candidatos: recruitee_create_candidate (opcionalmente ya postulado a ofertas; un remote_cv_url se analiza), recruitee_update_candidate, recruitee_add_candidate_tags (las etiquetas que aún no existen se crean), recruitee_remove_candidate_tags, recruitee_add_candidate_field (por ejemplo habilidades, idiomas o nacionalidad) y recruitee_create_candidate_note (visible para el equipo de contratación, no para el candidato).
• Pipeline: recruitee_assign_candidate mete a un candidato en una oferta (primera fase) o en un talent pool; recruitee_change_stage mueve un placement a otra fase (id del placement desde el candidato, id de fase desde recruitee_get_offer; una fase de contratado puede pedir hired_at, work_location_id y, con requisitions, opening_id); recruitee_disqualify_candidate con un motivo y recruitee_requalify_candidate se deshacen mutuamente.
• Ofertas: recruitee_create_offer crea un borrador, recruitee_update_offer cambia sus campos, recruitee_publish_offer la publica en la página de empleo y en los portales configurados para ella, recruitee_unpublish_offer la retira y conserva sus candidatos, recruitee_close_offer deja de aceptar candidaturas.
• Tareas: recruitee_create_task y recruitee_complete_task (o reabre una tarea con completed false).

Automatizaciones: crear un candidato en una oferta, cambiar de fase con run_actions true o descalificar puede disparar los emails y acciones que la empresa configuró en Recruitee, así que los candidatos pueden recibir noticias tuyas. La IA lo avisa antes de hacerlo para muchos candidatos.

Desactivadas al instalar: recruitee_delete_candidate (borra al candidato con todos sus datos) y recruitee_remove_placement (saca a un candidato de una oferta junto con el historial de fases de ese placement). No se pueden deshacer; un administrador del workspace las activa cuando el equipo las necesita. Descalificar es la forma reversible de sacar a un candidato de una oferta.

Filtros de búsqueda: filters_json de recruitee_search_candidates es un array JSON en forma de cadena, por ejemplo [{"field":"all","query":"java"},{"filter":"tags","id":{"in":[12]}},{"field":"created_at","gte":"2026-10-01"}]. Estado y fuente: {"field":"status","in":["qualified"]}; fases: {"filter":"stages","name":{"in":[...]}}.

Formatos de datos: los ids son enteros; fechas y horas son ISO 8601 en UTC (2026-10-19T11:02:32Z). Los placements de un candidato tienen una entrada por oferta con offer_id, stage_id y disqualify_reason; los cambios de fase y de calificación usan el id del placement. adminapp_url enlaza al candidato en Recruitee.

Paginación: recruitee_list_candidates pagina con limit (hasta 1000) y offset; ofertas, búsqueda, ubicaciones, actividades, eventos y tareas paginan con limit y page (desde 1). La IA para cuando una página devuelve menos elementos que limit.

Errores comunes: 401 invalid_token indica un token erróneo, revocado o de otra empresa; 403 un rol sin el permiso necesario; 404 un company ID o un id de registro incorrectos; 422 un error de validación, con el campo indicado en el cuerpo.

El conector no envía emails a los candidatos directamente, no programa entrevistas y no redacta evaluaciones.

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 muestra YOUR_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.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: Recruitee.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. 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.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué candidatos se han postulado esta semana a la oferta Senior Backend Developer y en qué fase están?"
• "Busca candidatos con la etiqueta java que se postularon después del 1 de octubre."
• "¿Qué entrevistas hay programadas para mañana, con candidato, oferta y participantes?"
• "Mueve a Laura Rossi a la fase Interview de la oferta Product Designer y añade una nota de que la entrevista telefónica fue bien."
• "Crea un borrador de oferta para un Customer Support Specialist en el departamento Support, con ubicación en Berlín."

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