Curriculo ATS MCP servidor

Conecta tu Curriculo ATS a Claude, Cursor y cualquier MCP cliente que hable Streamable HTTP, o a ChatGPT a través de un Conector GPT personalizado. Pide en lenguaje plano para revisar candidatos, mover pipelines, responder a solicitantes, programar entrevistas y obtener análisis. Tu AI cliente realiza el trabajo directamente en tu ATS.

El servidor es remoto y alojado, por lo que no hay nada que instalar o ejecutar localmente. Apunte cualquier cliente MCP al punto de conexión, autentíquese una vez y el cliente obtendrá herramientas que leen y actúan sobre sus datos de contratación en tiempo real.

Un producto diferente del público API, con autenticación diferente. MCP se comunica con Curriculo ATS y el usuario inicia sesión. Un público API key_ no alcanza estas herramientas, y el público API no alcanza su ATS.

Inicio rápido

Utilice este punto de conexión en todas partes:

https://mcp.curriculo.me/mcp

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

1. Abra Claude, luego Configuración, luego Conectores.
2. Haga clic en Agregar conector personalizado y pegue la dirección del servidor URL anterior.
3. Complete el proceso de inicio de sesión de OAuth **** cuando se le solicite. Claude se conecta a su organización.
4. Inicie una conversación y pregunte, por ejemplo, "¿Qué hay en cada etapa de mis puestos abiertos?"

¿Nuevo aquí? Siga el tutorial paso a paso : ejecute su ATS en Claude, con capturas de pantalla que lo guían a través de la conexión, el ranking de candidatos por ajuste AI y la programación de entrevistas desde un chat.

Conectar un cliente

Cualquier cliente que hable Streamable HTTP funciona. Autentíquese con OAuth 2.1 o con un token de acceso personal enviado en un encabezado Authorization: Bearer . La configuración para clientes comunes sigue a continuación.

Claude

En Claude (web o de escritorio), vaya a Configuración,Conectores,Agregar conector personalizado, luego ingrese:

https://mcp.curriculo.me/mcp

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

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 pase 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"

Ejecute /mcp dentro de Código Claude para comprobar el estado o desencadenar el inicio de sesión de OAuth.

Cursor

Abrir Configuración del cursor, Herramientas y MCP, Nuevo servidor MCP y añadir esto a mcp.json:

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

El cursor muestra Necesita inicio de sesión. Haga clic en él para ejecutar el flujo de consentimiento de OAuth, y las herramientas se vuelven verdes.

VS Código y otros clientes

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

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

Para autenticar de forma desatendida, agregue un argumento de encabezado:

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

ChatGPT (Acciones personalizadas GPT )

ChatGPT se conecta a través de una acción personalizada GPT con Acciones, utilizando una superficie REST que refleja las 25 MCP herramientas.

1. En ChatGPT, cree un GPT y abra Configuración, luego Acciones, luego Crear nueva acción.

2. Importe el esquema desde este URL :

   https://mcp.curriculo.me/api/v2/mcp/openapi.json

3. Establezca la autenticación Autenticación en OAuth, con estos valores del esquema:

   Configuración	Valor
   Autorización URL	https://mcp.curriculo.me/api/v2/ats/oauth/authorize
   Token URL	https://mcp.curriculo.me/api/v2/ats/oauth/token
   Alcance	ats:read ats:write (o solo ats:read)

4. Guardar, luego iniciar sesión en Curriculo y aprobar el acceso cuando el GPT llame a una acción por primera vez.

Autenticación

Dos formas de autenticar. Ambas resuelven a un usuario en una organización con permisos limitados.

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 de cliente dinámico, PKCE (S256) es obligatorio para los clientes públicos, y las URI de redireccionamiento deben ser https. Inicia sesión en Curriculo, aprueba la conexión y el cliente almacena un token de vida corta que se actualiza automáticamente. No hay secretos que copiar o rotar manualmente. 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. Iniciar sesión en ats.curriculo.me.
2. Ir a Configuración,API y Integraciones,Tokens de acceso personal.
3. Crear un token, elegir sus alcances y copiarlo. Se muestra una sola vez.
4. Pásalo como Authorization: Bearer <token>, como se muestra en los pasos de configuración anteriores.

Ámbitos

Los tokens llevan uno o ambos alcances. Otorgue solo lo que necesite.

¿No está seguro de quién está actuando un token? Llame a la herramienta whoami . Devuelve el usuario autenticado, la organización, el método de autenticación y los alcances otorgados.

Referencia de herramientas

Veinticinco herramientas. El tipo de acceso te indica el riesgo:

• Leer solo visualiza.
• Escribir modifica ATS datos.
• Escribir+ modifica datos y tiene consecuencias externas: se envía un correo electrónico, se envía una invitación o se inicia un AI trabajo.

Diecisiete de las veinticinco herramientas son de solo lectura. Las seis herramientas de Escritura+ tienen consecuencias externas, y el asistente confirma la intención antes de utilizarlas. Ninguna herramienta elimina nada.

Trabajos

Solicitantes

Bandeja de entrada y correo electrónico

Entrevistas

Análisis

Automatizaciones e importaciones

Cuenta

Las herramientas de correo electrónico envían desde la bandeja de salida de Curriculo, por lo que funcionan sin una bandeja de correo conectada. La programación de entrevistas también funciona sin un calendario: aún guarda la entrevista y informa que no se enviaron invitaciones.

Ejemplos de prompts

Una vez conectado, pregunte en lenguaje plano. El cliente elige las herramientas adecuadas.

• "Muestre lo que está en cada etapa de mis puestos abiertos y marque cualquier cosa estancada."
• "Encuentre ingenieros senior React con experiencia como líder de equipo y resuma los cinco principales."
• "Mueva a Priya a la segunda entrevista y redacte una respuesta pidiendo su disponibilidad para la próxima semana."
• "Programa una entrevista de video de 45 minutos con este candidato el jueves a las 2pm ET y agrega un enlace de Google Meet."
• "¿Cómo cambió el volumen de solicitudes en comparación con el mes pasado, y qué trabajo es el que mejor se está convirtiendo?"

Las herramientas de escritura tienen efectos secundarios reales: envían correos electrónicos, cambian pipelines, cierran trabajos. Mantenga las aprobaciones de herramientas activadas para acciones de escritura hasta que confíe en un flujo de trabajo, y otorgue solo ats:read si solo desea análisis.

FAQ y solución de problemas

¿Necesito instalar o alojar algo? No. El servidor está completamente alojado en https://mcp.curriculo.me/mcp. Apunte su cliente al URL y autentíquese.

¿Qué clientes son compatibles? 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 de escritorio), Claude Code, Cursor, VS Code y otros. Los clientes sin soporte de servidor remoto nativo pueden utilizar el puente mcp-remote . ChatGPT se conecta a través de un puente personalizado con Acciones.

Mis herramientas muestran "Necesita inicio de sesión" o no se conectan. Vuelva a ejecutar el flujo de OAuth (en Claude Code, escriba /mcp; en Cursor, haga clic en Necesita inicio de sesión). Si utiliza un token de acceso personal, confirme que el encabezado es exactamente Authorization: Bearer <token> y que el token no ha sido revocado o ha caducado.

¿Las herramientas de correo electrónico necesitan una bandeja de entrada conectada? No. send_bulk_email y reply_to_applicant_email envían desde la bandeja de salida de Curriculo. Una respuesta se envía desde la bandeja de entrada de su organización cuando esa bandeja de entrada 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 .

¿ schedule_interview crea enlaces de Zoom? No. Los enlaces de video provienen de un calendario conectado: Google Meet con Google, Microsoft Teams con Microsoft. Sin un calendario, la entrevista se guarda sin enlace.

¿Cómo limito lo que puede hacer el AI? Emita un token con solo ats:read para acceso de solo análisis, y utilice la configuración de permisos por herramienta de su cliente para deshabilitar herramientas de escritura específicas.

¿Qué organización actúa sobre ella? La que está vinculada a su token. Llame a whoami para confirmar al usuario, la organización y los alcances en cualquier momento.

Seguridad

• Acceso con alcance. Cada token está vinculado a un usuario y una organización y lleva alcances explícitos ats:read o ats:write . Todo lo que ve el asistente está limitado a su propia organización.
• Privilegio mínimo. Otorgue el alcance más estrecho que haga el trabajo; prefiera tokens de solo lectura para análisis.
• Revocar en cualquier momento. Los tokens de acceso personal pueden ser revocados en Configuración,API y Integraciones. Las conexiones de OAuth se pueden eliminar desde la configuración del conector del cliente.
• Seguridad de transporte. Todo el tráfico está HTTPS sobre Streamable HTTP. Nunca pegue un token en clientes no confiables ni lo comparta en texto plano.

Parte de la Curriculo ATS MCP centro, que enlaza las guías de configuración, la referencia de herramientas y la documentación del conector.