Documentación del Servidor MCP de Curriculo ATS

Conecta tu Curriculo ATS a Claude, Cursor y cualquier cliente de IA compatible con MCP. El servidor MCP de Curriculo ATS es un servidor remoto alojado en https://mcp.curriculo.me/mcp, sin necesidad de instalar nada. Autentícate una vez con OAuth 2.1 o un Token de Acceso Personal, y el cliente obtendrá 25 herramientas que leen y actúan sobre tus datos de contratación en tiempo real.

Fuente: https://curriculo.me/docs/mcp/ (Curriculo ATS)

Propiedad	Valor
Endpoint	https://mcp.curriculo.me/mcp
Transporte	HTTP transmitible
Autenticación	OAuth 2.1 + Token de Acceso Personal (PAT)
Alcances	ats:read, ats:write
Herramientas	25

El servidor MCP de Curriculo ATS es un servidor remoto alojado, sin necesidad de instalar o ejecutar nada localmente. Apunta cualquier cliente MCP al endpoint, autentícate una vez y el cliente obtendrá un conjunto de herramientas que leen y actúan sobre tus datos de contratación en tiempo real.

Inicio rápido

Usa este endpoint en todas partes: https://mcp.curriculo.me/mcp

El camino más rápido es el flujo de conector de un clic de Claude:

Abre Claude, luego Configuración, luego Conectores.
Haz clic en Agregar conector personalizado y pega la URL del servidor anterior.
Completa el inicio de sesión OAuth cuando se te solicite. Claude se conecta a tu organización.
Comienza un chat y pregunta, por ejemplo, "¿Qué hay en cada etapa de mis roles abiertos?"

¿Nuevo aquí? Sigue el tutorial paso a paso tutorial: ejecuta tu ATS en Claude.

Conectar un cliente

El servidor habla HTTP transmitible y admite tanto OAuth interactivo como un Token de Acceso Personal a través de un encabezado Authorization: Bearer.

Claude

En Claude (web o escritorio), ve a Configuración, Conectores, Agregar conector personalizado, luego ingresa:

https://mcp.curriculo.me/mcp

Haz clic en Agregar, completa el inicio de sesión OAuth y luego abre el conector para habilitar las herramientas específicas que deseas que Claude use.

Claude Code

Agrega el servidor con un solo comando (OAuth se abre en tu navegador a través de /mcp):

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp

O pasa un Token de Acceso Personal directamente con un encabezado:

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp \
  --header "Authorization: Bearer YOUR_CURRICULO_PAT"

Cursor

Abre Configuración de Cursor, Herramientas y MCP, Nuevo Servidor MCP, y agrega esto a mcp.json:

{
  "mcpServers": {
    "curriculo": {
      "url": "https://mcp.curriculo.me/mcp"
    }
  }
}

VS Code / otro

Cualquier cliente sin soporte nativo para MCP remoto puede usar el puente mcp-remote:

{
  "mcpServers": {
    "curriculo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
    }
  }
}

Autenticación

Dos maneras de autenticar. Ambas se resuelven a un usuario en una organización con permisos de alcance.

OAuth 2.1 (recomendado)

Clientes interactivos (Claude, Cursor) usan OAuth con registro de cliente dinámico. Te inicias sesión en Curriculo, apruebas la conexión y el cliente almacena un token de corta duración que refresca automáticamente.

Token de Acceso Personal (PAT)

Para configuraciones CLI o sin interfaz, genera un token en el ATS y envíalo como un encabezado Bearer:

Inicia sesión en ats.curriculo.me.
Ve a Configuración, API e Integraciones, Tokens de Acceso Personal.
Crea un token, elige sus alcances y cópialo (se muestra una vez).
Pásalo como Authorization: Bearer <token>.

Alcances

ats:read: Enumera y lee trabajos, postulantes, bandeja de entrada, entrevistas, analíticas.
ats:write: Crea y cambia datos: mover etapas, enviar correos, programar entrevistas, actualizar trabajos.

Llama a la herramienta whoami para confirmar el usuario autenticado, la organización, el método de autenticación y los alcances otorgados.

Referencia de herramientas (25 herramientas)

Las herramientas de lectura nunca cambian datos. Las herramientas de escritura crean o modifican registros y pueden desencadenar correos, eventos de calendario o automatizaciones.

Trabajos (4)

list_jobs (lectura): Enumera trabajos en tu organización, los más nuevos primero. Params: estado, página, límite.
get_job (lectura): Detalles completos de un trabajo por UUID, incluyendo etapas del embudo y conteo de postulantes. Params: jobId (requerido).
create_job (escritura): Crea una publicación de trabajo con etapas de embudo predeterminadas. Solo se requiere el título; se abre en borrador. Params: título (requerido), descripción, ubicación, tipo, número de personas, habilidades necesarias, habilidades preferidas, salario_min/max, moneda_salario.
update_job_status (escritura): Cambia el estado de un trabajo (Borrador / Abierto / Pausado / Cerrado / Archivado). Params: jobId, estado (ambos requeridos).

Postulantes (8)

list_applicants (lectura): Enumera postulantes, opcionalmente enmarcado a un trabajo, con filtros de destacados / rechazados / archivados. Params: jobId, destacado, rechazado, archivado, página, límite.
get_applicant (lectura): Detalle completo del postulante: etapa del embudo, enlace del trabajo, notas, historial de actividad. Params: applicantId (requerido).
search_candidates (lectura): Búsqueda semántica entre todos los candidatos. Params: consulta (requerido), jobId, timestamp, página, límite.
move_applicant_stage (escritura): Mueve un postulante a otra etapa del embudo. Desencadena automatizaciones del embudo. Params: applicantId, funnelId (requerido), razón.
add_applicant_note (escritura): Agrega una nota a un postulante. Params: applicantId, contenido (requerido), tipoNota, banderaDecisión, nombreRonda.
get_applicant_resume_text (lectura): Texto del currículum analizado y datos estructurados. Params: applicantId (requerido).
get_applicant_evaluation (lectura): Evaluación del gráfico del agente de IA: puntaje de idoneidad, etiquetas de IA, resumen, estado de brecha. Params: applicantId (requerido).
reprocess_resume (escritura): Ejecuta nuevamente el pipeline del currículum (análisis + evaluación + ingestión del gráfico). Params: applicantId (requerido).

Bandeja de entrada y correo (5)

get_applicant_email_thread (lectura): Hilo completo de correos para un postulante. Params: applicantId (requerido).
list_inbox_emails (lectura): Enumera correos entrantes en la bandeja de entrada de la organización. Params: jobId, estado, búsqueda, página, límite.
get_inbox_stats (lectura): Resumen de estadísticas de la bandeja de entrada: conteos no leídos y totales. Params: ninguno.
reply_to_applicant_email (escritura): Responde a un postulante, agregando al último correo entrante. Se requiere Gmail conectado. Params: applicantId, cuerpo (requerido), asunto.
send_bulk_email (escritura): Envía un correo a uno o más postulantes por ID. Se requiere Gmail conectado. Params: applicantIds, asunto, cuerpoMensaje (todos requeridos).

Entrevistas (2)

list_interviews (lectura): Enumera entrevistas. Params: jobId, applicantId, estado, tipo, fechaDesde, fechaHasta, página, límite.
schedule_interview (escritura): Programa una entrevista, genera enlaces de retroalimentación y (con Gmail) sincroniza un evento de calendario y correo para todos. Params: applicantId, jobId, título, inicioProgramado, finProgramado (requeridos), además de tipo, ubicación, proveedor de reunión, participantIds, entrevistadoresExternos, zonaHoraria, instrucciones.

Analíticas (2)

get_analytics (lectura): Resumen de analíticas de la organización: total de postulantes, cambio de período, embudo por etapa, trabajos principales, mezcla de fuentes. Por defecto, los últimos 30 días. Params: fechaDesde, fechaHasta.
get_dashboard (lectura): Bandeja de entrada más desglose del embudo por trabajo de postulantes activos. Params: ninguno.

Automatizaciones e importaciones (3)

list_job_automations (lectura): Enumera las automatizaciones del embudo configuradas para un trabajo. Params: jobId (requerido).
get_automation_executions (lectura): Historial de ejecuciones para una sola automatización, paginado. Params: automationId (requerido), página, límite.
get_import_batch (lectura): Estado de un lote de importación de candidatos: progreso, estado por archivo, errores. Params: batchId (requerido).

Cuenta (1)

whoami (lectura): Devuelve el usuario autenticado, la organización, el método de autenticación y los alcances otorgados. Params: ninguno.

Ejemplos de solicitudes

"Muéstrame qué hay en cada etapa de mis roles abiertos y marca cualquier cosa detenida."
"Encuentra ingenieros React séniores con experiencia en liderazgo de equipo y resume los cinco principales."
"Mueve a Priya a Segunda Entrevista y redacta una respuesta pidiendo su disponibilidad la próxima semana."
"Programa una entrevista de video de 45 minutos con este candidato el jueves a las 2 p.m. ET y agrega un enlace de Google Meet."
"¿Cómo cambió el volumen de postulantes en comparación con el mes pasado y qué trabajo está convirtiendo mejor?"

Las herramientas de escritura tienen efectos secundarios reales (enviar correos, cambiar tuberías, cerrar trabajos). Mantén las aprobaciones de herramientas activadas para acciones de escritura hasta que confíes en un flujo de trabajo y otorga solo ats:read si solo deseas análisis.

Preguntas frecuentes y resolución de problemas

¿Necesito instalar o alojar algo?

No. El servidor está completamente alojado en https://mcp.curriculo.me/mcp. Apunta tu cliente a la URL y autentícate.

¿Qué clientes son compatibles?

Cualquier cliente MCP que admita servidores remotos sobre HTTP transmitible: Claude (web/escritorio), Claude Code, Cursor, VS Code y otros. Los clientes sin soporte remoto nativo pueden usar el puente mcp-remote.

Mis herramientas muestran "Necesita iniciar sesión" o no se conectan.

Vuelve a ejecutar el flujo de OAuth (en Claude Code, escribe /mcp; en Cursor, haz clic en Necesita iniciar sesión). Si usas un PAT, confirma que el encabezado sea exactamente Authorization: Bearer <token> y que el token no haya sido revocado o haya expirado.

Una herramienta de correo o entrevista devuelve un error.

Las herramientas de correo y calendario (reply_to_applicant_email, send_bulk_email, el lado de correo de schedule_interview) requieren una conexión activa de Gmail en la organización. Conecta Gmail en el ATS y vuelve a intentarlo.

¿Cómo limito lo que la IA puede hacer?

Emite un token solo con ats:read para acceso solo de análisis y usa la configuración de permisos por herramienta de tu cliente para deshabilitar herramientas de escritura específicas.

¿Sobre qué organización actúa?

La vinculada a tu token. Llama a whoami para confirmar el usuario, la organización y los alcances en cualquier momento.

Seguridad

Acceso delegado. Cada token está vinculado a un usuario y organización y lleva alcances explícitos ats:read / ats:write.
Menor privilegio. Concede el alcance más estrecho que haga el trabajo; prefiere tokens de solo lectura para análisis.
Revocación en cualquier momento. Los Tokens de Acceso Personal pueden ser revocados en Configuración, API e Integraciones; las conexiones OAuth pueden ser eliminadas de la configuración de conectores de tu cliente.
Seguridad de transporte. Todo el tráfico es HTTPS sobre HTTP transmitible. Nunca pegues un token en clientes no confiables o lo compartas en texto plano.

Versión HTML canónica: https://curriculo.me/docs/mcp/