Saltar al contenido

Servidor Curriculo ATS MCP

En esta página

Conecte su Curriculo ATS a Claude, Cursor y cualquier cliente MCP que hable HTTP en streaming, o a ChatGPT a través de un GPT personalizado. Pida en lenguaje sencillo para revisar a los candidatos, mover las líneas, responder a los solicitantes, programar entrevistas y hacer análisis. Su cliente AI hace el trabajo directamente en su ATS.

Punto finalTransporteAutoraEspecíficosHerramientas
https://mcp.curriculo.me/mcpHTTP transmitibleOAuth 2.1, o un token de acceso personalats:read, ats:write25

El servidor está remoto y alojado, así que no hay nada que instalar o ejecutar localmente. Ponte a cualquier cliente MCP en el punto final, autentique una vez, y el cliente obtiene herramientas que leen y actúan sobre sus datos de contratación en tiempo real.

Un producto diferente del público API, con una autenticación diferente. MCP habla con Curriculo ATS y el usuario se registra. Un API público key_ no llega a estas herramientas, y el API público no llega a su ATS.

¿Qué es el servidor Curriculo ATS MCP?

El servidor Curriculo ATS MCP es un punto final alojado, https://mcp.curriculo.me/mcp, que permite a Claude, ChatGPT, Cursor y otros clientes MCP leer y actuar en su Curriculo ATS. Usted se registra una vez con OAuth o un token de acceso personal, luego pide en lenguaje simple para revisar a los candidatos, mover las etapas, responder a los solicitantes o programar entrevistas.

Inicio rápido

Utilice este punto final en cada cliente MCP:

https://mcp.curriculo.me/mcp

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

  1. Abre Claude, luego Personaliza, luego Conectores.
  2. Haga clic en Añade el conector personalizado y pega el servidor URL arriba.
  3. Complete el OAuth de inicio de sesión cuando se le pida. Claude se conecta con su organización.
  4. Comience una charla y pregunte, por ejemplo, "¿Qué está sentado en cada etapa de mis roles abiertos?"

¿Es nuevo aquí? Siga el tutorial paso a paso de : ejecuta su ATS en Claude, que recorre la conexión, clasifica a los candidatos por el ajuste de AI y programa entrevistas desde un chat.

Conectar un cliente

Cualquier cliente que hable Streamable HTTP funciona. Autentique con OAuth 2.1 o con un token de acceso personal enviado en un encabezado Authorization: Bearer . Se sigue la configuración para los clientes comunes.

Claude

En Claude (web o escritorio), vaya a Personalizar,Conectores,Agregar conector personalizado, y luego ingrese:

https://mcp.curriculo.me/mcp

Haga clic en Agregar, complete el inicio de sesión de OAuth, luego abra el conector para habilitar las herramientas específicas que desea que use Claude.

Claude compositor de chat abierto a Conectores; Curriculo ATS listado entre los conectores con Conector Añadir
Añadir el conector Curriculo en Claude: Personalizar → Conectores → Añadir conector personalizado.

Código Claude

Agregue el servidor con un solo comando. OAuth se abre en su navegador a través de /mcp:

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

O pasar 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"

ejecuta /mcp dentro del código Claude para verificar el estado o activar el inicio de sesión de OAuth.

Cursor

Abrir Personalizar en la barra lateral de Cursor y agregar esto a mcp.json:

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

Cursor muestra necesita iniciar sesión. Haga clic en él para ejecutar el flujo de consentimiento de OAuth, y las herramientas se vuelven verdes.

Código VS y otros clientes

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

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

Para autenticar sin cabeza, añadir un argumento de encabezado:

"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp",
         "--header", "Authorization: Bearer YOUR_CURRICULO_PAT"]

ChatGPT (Acciones GPT personalizadas)

ChatGPT se conecta a través de un GPT personalizado con Acciones, utilizando una superficie REST que refleja las 25 herramientas MCP.

  1. En ChatGPT, crear un GPT y abrir Configurar, luego Acciones, luego Crear una nueva acción.

  2. Importar el esquema de este URL:

    https://mcp.curriculo.me/api/v2/mcp/openapi.json
  3. Configurar Authentication a OAuth, con un cliente ID y secreto de https://mcp.curriculo.me/api/v2/ats/oauth/register y estos valores del esquema:

    ConfiguraciónEl valor
    Autorización URLhttps://mcp.curriculo.me/api/v2/ats/oauth/authorize
    El símbolo URLhttps://mcp.curriculo.me/api/v2/ats/oauth/token
    El ámbito de aplicaciónats:read ats:write
  4. Guardar, luego iniciar sesión en Curriculo ATS y aprobar el acceso cuando el GPT primero llama a una acción.

Autenticación

Hay dos maneras de autenticar. Ambos se resuelven a un usuario en una organización.

OAuth 2.1 (recomendado)

Los clientes interactivos (Claude, Cursor, ChatGPT) utilizan OAuth 2.1 con el flujo de código de autorización. Se admite el registro dinámico del cliente, se requiere PKCE (S256) para los clientes públicos, y los URIs redirigidos deben ser https. Usted se inicia en Curriculo ATS, aprueba la conexión, y el cliente almacena un token de corta duración que se actualiza automáticamente. Con Claude y Cursor no hay secretos para copiar o girar a mano. Los metadatos del servidor se publican en https://mcp.curriculo.me/.well-known/oauth-authorization-server.

Token de acceso personal

Para CLI o configuraciones sin cabeza, genere un token en el ATS y envíelo como encabezado portador:

  1. Inscríbete en ats.curriculo.me.
  2. Vaya a Configuraciones,Desarrolladores,Tokens de acceso personal.
  3. Crear un token, elegir su vencimiento, y copiarlo. Se muestra una vez.
  4. Pasarlo como Authorization: Bearer <token>, como se muestra en los pasos de configuración anteriores.

Específicos

Los tokens tienen uno o ambos escalones.

El ámbito de aplicaciónPermite
ats:readLista y lectura de trabajos, solicitantes, bandejas de entrada, entrevistas y análisis (todavía no aplicado: cualquier token puede utilizar todas las herramientas).
ats:writeCrear y cambiar datos: mover etapas, enviar correo electrónico, programar entrevistas, actualizar trabajos.

¿No estás seguro de quién es un símbolo? Llame a la herramienta whoami . Retorna el usuario autenticado, la organización, el método de autor y los ámbitos otorgados.

Referencia a las herramientas

25 herramientas. El tipo de acceso le dice el riesgo:

  • Sólo lee las miradas de .
  • Escriba cambios ATS datos.
  • Write+ cambia los datos y llega al exterior: un correo electrónico sale, se envía una invitación, o comienza un trabajo AI.

Diecisiete de las veinticinco herramientas son sólo para lectura. Las siete herramientas Write+ tienen consecuencias externas; si el asistente confirma la intención antes de usarlas depende de su cliente. Ninguna herramienta elimina un registro, pero reprocess_resume sobreescribe la evaluación de AI almacenada.

Trabajos

HerramientaAccesoLo que haceParámetros
list_jobsLeerListas de trabajos en su organización, más recientes primero. Filtro de estado opcional.status, page, limit
get_jobLeerDetalles completos para un trabajo, incluyendo sus etapas de embudo y el número de candidatos.jobId (se requiere)
create_jobEscribir +Crea un puesto de trabajo y lo abre de inmediato: es en vivo y acepta solicitudes, no un borrador. Las etapas predeterminadas son Líderes + Aplicaciones, Evaluación, Entrevista, Oferta. Sólo se requiere un título.title (se requiere), description, location, locations, location_ack_required, type, work_mode, headcount, must_have_skills, preferred_skills, salary_min, salary_max, salary_currency, salary_period, salary_public, ask_salary, experience_min, experience_max, experience_public, ask_experience
update_job_statusEscribir +Cambia el estado de un puesto de trabajo (DRAFT, OPEN, PAUSED, CLOSED, ARCHIVED). No envía correos electrónicos a los candidatos. Usalo deliberadamente.jobId, status (ambos requeridos)

Los solicitantes

HerramientaAccesoLo que haceParámetros
list_applicantsLeerLista de candidatos, opcionalmente para un trabajo, con filtros con estrellas, rechazados y archivados.jobId, starred, rejected, archived, page, limit
get_applicantLeerUn solicitante completo: etapa actual, vínculo laboral, notas e historial de actividad.applicantId (se requiere)
search_candidatesLeerBusca en lenguaje simple a través de sus candidatos activos. Retorna coincidencias clasificadas con las habilidades y hechos y razonamiento correspondientes detrás de cada uno.query (se requiere), jobId, timestamp, page, limit
move_applicant_stageEscribir +Mueve a alguien a otro escenario. Activará las automatizaciones de esa etapa; llegar a la oferta puede cerrar automáticamente el trabajo una vez que se cumpla el número de empleados.applicantId, funnelId (se requiere), reason
add_applicant_noteEscribaAñade una nota, opcionalmente etiquetada con una decisión PASS o FAIL y la ronda a la que pertenece. Privado por defecto.applicantId, content (se requiere), noteType, decisionFlag, roundName
get_applicant_resume_textLeerEl contenido de CV analizado como texto y campos, sin archivo adjunto.applicantId (se requiere)
get_applicant_evaluationLeerLa evaluación AI: puntuación de idoneidad, etiquetas, resumen y estado de brecha.applicantId (se requiere)
reprocess_resumeEscribir +Reacciona la tubería AI en una CV (evaluar, indexar; solo analiza si aún no se analiza). Se ejecuta en el fondo.applicantId (se requiere)

Caja de entrada y correo electrónico

HerramientaAccesoLo que haceParámetros
get_applicant_email_threadLeerLa conversación completa con un candidato, en ambas direcciones.applicantId (se requiere)
list_inbox_emailsLeerListas de correos entrantes, filtradas por trabajo, estado o búsqueda de texto.jobId, status, search, page, limit
get_inbox_statsLeerCuentas y totales de procesamiento.Ninguna
reply_to_applicant_emailEscribir +Respuestas en el hilo existente, de la caja de correo de Curriculo o de la caja de correo de su organización que recibió la conversación. No se necesita conexión a la caja postal.applicantId, body (se requiere), subject
send_bulk_emailEscribir +Envía un mensaje a uno o varios candidatos, para actualizaciones de alcance o estado, desde la buzón de correo de Curriculo. No se necesita conexión a la caja postal.applicantIds, subject, messageBody (todos requeridos)

Entrevistas

HerramientaAccesoLo que haceParámetros
list_interviewsLeerLista de entrevistas por trabajo, candidato, estatus, tipo o rango de fechas.jobId, applicantId, status, type, dateFrom, dateTo, page, limit
schedule_interviewEscribir +Libra la entrevista, agrega entrevistadores y crea enlaces de retroalimentación. Con un calendario conectado, también crea el evento, invita al candidato y genera el enlace de vídeo: Google Meet a través de un calendario de Google, Microsoft Teams a través de un calendario de Microsoft. meetingProvider: ZOOM no genera ninguna conexión Zoom. La entrevista está guardada de cualquier manera.applicantId, jobId, title, scheduledStart, scheduledEnd (se requiere), type, location, meetingProvider, participantIds, externalInterviewers, timezone, instructions

Análisis

HerramientaAccesoLo que haceParámetros
get_analyticsLeerTotal, clasificación de etapas, puestos de trabajo principales y mezcla de fuentes (todo el tiempo), más cambio de período a período para un rango de fechas que no se cumpla con el mes hasta la fecha.dateFrom, dateTo
get_dashboardLeerCaja de entrada más un desglose de embudo por trabajo de todos los activos actualmente.Ninguna

Automatización y importaciones

HerramientaAccesoLo que haceParámetros
list_job_automationsLeerEnumera las automatizaciones configuradas en un trabajo: correo electrónico, programación de entrevistas, etiquetado y notificaciones.jobId (se requiere)
get_automation_executionsLeerEjecutar el historial para una automatización.automationId (se requiere), page, limit
get_import_batchLeerProgreso de la importación de productos candidatos: recuentos y errores.batchId (se requiere)

Cuenta

HerramientaAccesoLo que haceParámetros
whoamiLeerConfirma el usuario y la organización como que actúa el asistente, con el método de autor y los ámbitos de alcance otorgados. Vale la pena correr primero en cualquier sesión.Ninguna

Las herramientas de correo electrónico envían desde la caja de correo de Curriculo, por lo que funcionan sin una caja de correo conectada. La programación de entrevistas también funciona sin un calendario: todavía guarda la entrevista, pero una entrevista por video no tiene enlace a la reunión y no se envían las invitaciones.

Ejemplos de instrucciones

Una vez conectado, pregunte en lenguaje simple. El cliente elige las herramientas correctas.

  • "Muéstrame lo que está sentado en cada etapa de mis papeles abiertos, y señale cualquier cosa estancada".
  • "Encuentra ingenieros de React con experiencia en el liderazgo del equipo y resuma los cinco primeros".
  • "Múve a Priya a la segunda entrevista y redacta una respuesta pidiendo su disponibilidad la próxima semana".
  • "Agendemos una entrevista de vídeo de 45 minutos con este candidato el jueves a las 2 pm ET y añadimos un enlace a Google Meet".
  • "¿Cómo cambió el volumen de solicitantes en comparación con el mes pasado, y qué trabajo está convirtiendo mejor?"
Respuesta de Claude con análisis de contratación: 5 puestos de trabajo vacantes, 153 candidatos por etapa
Pídales cuentas de tuberías; el cliente llama a herramientas de análisis en su ATS.
Claude resumiendo a diez solicitantes de Frontend Senior con roles y experiencia analizados
Resumiendo a los candidatos de hoy para un puesto antes de profundizar en los currículos.
Claude confirma que dos candidatos se trasladaron a la selección y muestra un borrador de la selección de invitación de correo electrónico
Trasladar a los candidatos a la selección y redactar una invitación - enviar sólo después de confirmar las direcciones. La programación de entrevistas requiere un calendario conectado de Google o Microsoft.
Claude propone tres preguntas basadas en los proyectos de currículum de un candidato
Generar preguntas de detección desde el currículum ya en el ATS.

Las herramientas de escritura tienen efectos secundarios reales: enviar correos electrónicos, cambiar de tubería, cerrar puestos de trabajo. Mantenga las aprobaciones de las herramientas para escribir acciones hasta que confíe en un flujo de trabajo.

Seguridad

  • Acceso escogido. Cada token está ligado a un usuario y a una organización. Todo lo que el asistente ve se limita a su propia organización.
  • Es el menor privilegio. Los objetivos aún no se han aplicado; apague las herramientas de escritura en la configuración de herramientas de su cliente para su análisis.
  • Revocar en cualquier momento. Los tokens de acceso personal pueden ser revocados en Configuraciones,Desarrolladores. Las conexiones OAuth se pueden eliminar de la configuración de conectores de su cliente.
  • Seguridad del transporte. Todo el tráfico es HTTPS sobre Streamable HTTP. Nunca pongan un token en clientes no confiables o lo compartan en texto simple.

Parte del hub Curriculo ATS MCP, que une las guías de configuración, la referencia de herramientas y los documentos de conector.

Los siguientes pasos

FAQ y resolución de problemas

¿Necesito instalar o alojar algo?

- No, no es así. El servidor está totalmente alojado en https://mcp.curriculo.me/mcp. Ponte a su cliente a la URL y autentique.

¿Qué clientes son apoyados?

Cualquier cliente MCP que admita servidores remotos a través de Streamable HTTP, con OAuth 2.1 o un token de acceso personal: Claude (web y escritorio), Claude Code, Cursor, VS Code y otros. Los clientes sin soporte remoto nativo pueden usar el puente de MCP-remote. ChatGPT se conecta a través de un GPT personalizado con Acciones.

Mis herramientas muestran Necesidades de inicio de sesión o no se conectará.

Vuelva a ejecutar el flujo OAuth (en el código Claude, escriba /mcp; en Cursor, haga clic en Necesidades de inicio de sesión). Si utiliza un token de acceso personal, confirme que el encabezado es exactamente Autorización: portador <token> y la ficha no ha sido revocada o expirado.

¿Las herramientas de correo electrónico necesitan una caja de correos conectada?

- No, no es así. enviar_bulk_email y responder_to_applicant_email enviar desde la caja de correos de envío de Curriculo. Una respuesta sale de la caja de correos de su organización cuando esa caja de correos recibió la conversación. Para enviar desde su propia dirección en general, consulte la guía de configuración del agente de correo electrónico.

¿La entrevista schedule_interview crea enlaces en Zoom?

- No, no es así. Los enlaces de vídeo provienen de un calendario conectado: Google Meet con Google, Microsoft Teams con Microsoft. Sin un calendario, la entrevista se guarda sin vínculo.

¿Cómo puedo limitar lo que el AI puede hacer?

Utilice la configuración de permisos por herramienta de su cliente para desactivar herramientas de escritura específicas.

¿En qué organización actúa?

El que está atado a tu token. Llame a whoami para confirmar el usuario, la organización y el alcance en cualquier momento.

¿Te ha resultado útil esta página?

Actualizado