API y MCP de Reclee
Integra Reclee desde tu código con la API REST o conecta un asistente de IA con el servidor MCP.
Reclee es un ATS y CRM con sourcing para agencias de reclutamiento. Todo lo que tu equipo hace en la app —publicar vacantes, mover candidatos por el pipeline, buscar talento, revelar contactos, llevar el CRM de clientes— también se puede hacer desde afuera, con dos puertas que comparten las mismas reglas:
- La API REST (
https://app.reclee.com/api/v1): HTTP y JSON, para scripts, integraciones y backends propios. - El servidor MCP (
https://app.reclee.com/api/mcp): las mismas operaciones como tools para un cliente MCP (Claude, Claude Code, ChatGPT u otro agente).
Las dos usan la misma credencial (una API key del workspace), el mismo límite de pedidos y el mismo ejecutor: una acción hecha por REST y la misma hecha por MCP producen exactamente el mismo resultado.
Qué puedes hacer
| Área | Ejemplos |
|---|---|
| Vacantes | Crear borradores, editarlas, publicarlas, cerrarlas y reabrirlas; equipo, suscriptores, notas y links de shortlist para el cliente. |
| Pipeline (ATS) | Sumar candidatos, moverlos de etapa, descalificar o restaurar, etiquetas, comentarios, preguntas de screening, contratar. |
| Entrevistas e informes | Agendar entrevistas, generar preguntas, cargar transcripciones, proponer la scorecard y armar el informe para el cliente. |
| Talent pool | Perfiles, tags, notas, contactos, listas (bookmarks), carga de CVs y planillas, fusión de duplicados. |
| Búsqueda y sourcing | Buscar personas fuera del workspace, enriquecer perfiles, definir el perfil ideal (ICP) y correr el sourcing que arma la longlist. |
| Match score | Calcular cuánto encaja cada candidato con los criterios de la vacante. |
| Contactos | Revelar el email laboral, el personal o el teléfono de una persona (consume créditos). |
| CRM | Empresas (leads), contactos del lado del cliente, actividad, requests (las búsquedas que pide un cliente) y contrataciones. |
Cómo está organizada la API
La API separa leer de escribir:
- Las lecturas son
GETsobre recursos:GET /job-posts,GET /job-posts/{jobPostId},GET /crm/leads… Las listas se paginan siempre igual. - Las escrituras de negocio son acciones con nombre:
POST /actions/<tool>, por ejemploPOST /actions/close_job_postoPOST /actions/move_application_stage. Cada acción valida su cuerpo con su propio JSON Schema y es la misma operación que la tool homónima del MCP.
Algunos recursos también aceptan POST, PATCH o PUT directo (por ejemplo, editar tu perfil con PATCH /account/me); la referencia REST dice qué métodos acepta cada ruta. Muchas acciones devuelven, además del dato, next: qué le falta todavía al objeto y qué acciones siguen.
# Leer
curl https://app.reclee.com/api/v1/job-posts?status=ACTIVE \
-H "Authorization: Bearer $RECLEE_API_KEY"
# Escribir
curl -X POST https://app.reclee.com/api/v1/actions/create_note \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "jobPostId": "3f8a2b6c-1d4e-4a7b-9c2d-8e5f6a7b8c9d", "body": "El cliente pidió priorizar inglés avanzado." }'Direcciones base
| Qué | URL |
|---|---|
| API REST | https://app.reclee.com/api/v1 |
| Servidor MCP | https://app.reclee.com/api/mcp |
| Especificación OpenAPI 3.1 (pública, sin key) | https://app.reclee.com/api/v1/openapi.json |
Por dónde seguir
Primeros pasos
Crea una API key y haz tu primera lectura y tu primera acción en cinco minutos.
Fundamentos de la API
Pedidos y respuestas, paginación, errores, límites, idempotencia, borrados y créditos.
Acciones
Todas las escrituras de POST /actions/<tool>, agrupadas por área, con su esquema.
Referencia REST
Cada ruta de /api/v1 con sus métodos, parámetros y respuestas.
Servidor MCP
Conecta Claude u otro cliente MCP a tu workspace con OAuth.
Guías
Recorridos de punta a punta: publicar una vacante, hacer sourcing, revelar contactos, del lead al placement.