Cómo conectar Recruitee a Microsoft Copilot 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 + Microsoft Copilot

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

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. 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.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Recruitee.
6. 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

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

¿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