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/mcpQué 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:
| Familia | Tools | Qué hacen |
|---|---|---|
READ | 35 | Leen. No cambian nada. |
DO | 62 | Escriben en el ATS, el talent pool, las listas o el sourcing. |
CRM | 17 | Escriben en el CRM. |
GENERATE | 9 | Escriben sin confirmación un borrador o una propuesta (casi siempre de la IA) que la persona revisa en la app. |
PROVIDER | 9 | Llaman 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/mcpse 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.GETyDELETEcontestan405. - 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 leernext,missing,suggestionsycost. - Links absolutos. Cada resultado trae
linkscon 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 mismonext. - Mismo rate limit. 60 requests por minuto por persona, compartidos entre REST y MCP.
Cuándo conviene cada uno: MCP o REST.
Conectar un cliente
Claude, Claude Code, Cursor, VS Code, MCP Inspector o una API key.
Autorización OAuth
El flujo completo, para quien escribe su propio cliente.
Catálogo de tools
Las 132 tools por área, con sus parámetros.
Seguridad y confirmaciones
Qué confirmar con la persona, qué gasta créditos y cómo se ven los errores.