Reclee

Qué es el servidor MCP

El servidor MCP de Reclee le da a un agente de IA las mismas tools que usa Ask Reclee dentro de la app, con las reglas de la API REST.

El servidor MCP de Reclee permite que un agente de IA (Claude, Claude Code, Cursor o tu propio cliente) opere un workspace de Reclee en nombre de una persona: leer vacantes y candidatos, mover el pipeline, buscar talento, armar longlists o trabajar el CRM. Hablas con él usando el Model Context Protocol, así que cualquier cliente MCP compatible lo usa sin código propio.

https://app.reclee.com/api/mcp

Qué expone

132 tools, las mismas que usa Ask Reclee (el asistente de la app), menos las que solo abren una pantalla dentro de la app:

FamiliaToolsQué hacen
READ35Leen. No cambian nada.
DO62Escriben en el ATS, el talent pool, las listas o el sourcing.
CRM17Escriben en el CRM.
GENERATE9Escriben sin confirmación un borrador o una propuesta (casi siempre de la IA) que la persona revisa en la app.
PROVIDER9Llaman a un proveedor externo de datos y pueden consumir créditos.

Cuatro tools existen solo para clientes con API key (MCP o REST) y no dentro de la app: get_usage, search_talent_preview, upload_cv y upload_attachment. El catálogo completo está en Catálogo de tools.

El servidor no publica recursos ni prompts: solo tools.

Cómo funciona

  • Transporte Streamable HTTP, sin estado. Cada POST /api/mcp se atiende de forma independiente: no hay sesión MCP (Mcp-Session-Id), ni stream SSE, ni nada que se guarde entre llamadas. Las respuestas son JSON. GET y DELETE contestan 405.
  • Cada llamada actúa como la persona que conectó, en el workspace que eligió al autorizar y con su rol. Una conexión vale para un solo workspace.
  • Cada llamada es independiente. No hay hilo de conversación del lado de Reclee: un objeto se nombra por el id que devolvió una llamada anterior (jobPostId, searchId, longlistId…).
  • Instrucciones para el modelo. Al inicializar, el servidor manda instructions: qué es Reclee, que las tools marcadas como destructivas cambian datos reales y hay que confirmarlas con la persona, y cómo leer next, missing, suggestions y cost.
  • Links absolutos. Cada resultado trae links con la URL de cada objeto en la app (https://app.reclee.com/job-posts/…), para que el agente se los pueda mostrar a la persona.
  • Historial. Lo que escribe un cliente MCP queda en el historial de Reclee con origen MCP, separado de lo que se hace en la app o por la API REST.

Quién puede conectarse

Solo un miembro con asiento en el workspace: rol OWNER (Dueño) o RECRUITER (Reclutador). Un COLLABORATOR o un VIEWER no puede autorizar un cliente MCP, aunque dentro de la app sí use parte de Ask Reclee. Si a alguien le quitan el asiento, su conexión deja de funcionar hasta que lo recupere.

Relación con la API REST

El MCP y la API REST son dos puertas al mismo sistema:

  • Misma credencial. El token que entrega el OAuth del MCP es una API key rcl_… del workspace, igual a las que se crean en Configuración → Developers. También puedes conectar el MCP con una key creada a mano (ver Conectar un cliente).
  • Mismo ejecutor. Cada tool que escribe es exactamente la acción POST /api/v1/actions/<tool>: mismo schema de entrada, mismas validaciones previas, mismas negativas y mismo next.
  • Mismo rate limit. 60 requests por minuto por persona, compartidos entre REST y MCP.

Cuándo conviene cada uno: MCP o REST.

En esta página