Conectar un cliente
Cómo conectar Claude, Claude Code, Cursor, VS Code, MCP Inspector o cualquier cliente MCP al servidor de Reclee, con OAuth o con una API key.
Para conectar un cliente MCP a Reclee alcanza con la URL del servidor. Si el cliente soporta OAuth, abre el navegador, eliges el workspace y listo: no copias ninguna credencial. Si no lo soporta, usas una API key en un header.
https://app.reclee.com/api/mcpLa URL y el comando de Claude Code también están en la app, en Configuración → Developers, en la sección «Servidor MCP».
Antes de empezar
Necesitas un asiento (rol Dueño o Reclutador) en el workspace que vas a conectar. Un Colaborador o un Lector no puede autorizar un cliente: la pantalla de consentimiento le muestra el workspace sin poder elegirlo.
Qué pasa al conectar con OAuth
Es igual en todos los clientes que soportan OAuth:
Agregas la URL en el cliente. El cliente llama al servidor sin credencial, recibe un 401 y descubre solo dónde autorizarse.
Se abre el navegador en Reclee. Si no tienes sesión iniciada, primero inicias sesión.
La pantalla de consentimiento muestra el nombre del cliente, a qué dirección vuelve al aceptar y tus workspaces. Eliges uno donde tengas asiento y aceptas.
El cliente recibe un token y ya puede llamar a las tools. En Configuración → Developers aparece una API key nueva con el nombre del cliente seguido de «(MCP)».
Reclee no verifica el nombre del cliente
Cualquiera puede registrar un cliente con el nombre que quiera. Acepta solo si tú iniciaste la conexión, y fíjate en la dirección a la que vuelve: es el único dato que un cliente falso no puede falsificar.
Una conexión vale para un workspace. Para trabajar en dos, conecta el servidor dos veces (con dos nombres distintos en el cliente) y elige un workspace en cada autorización.
Claude (web y escritorio)
Abre Configuración → Conectores y elige Agregar conector personalizado.
Ponle un nombre (por ejemplo, «Reclee») y pega https://app.reclee.com/api/mcp como URL.
Conecta. Claude abre Reclee en el navegador para que elijas el workspace y aceptes.
En un chat, activa el conector y pídele algo como «lista mis vacantes activas».
Los nombres exactos de los menús y qué planes de Claude admiten conectores personalizados dependen de Anthropic; si no encuentras la opción, revisa su documentación.
Claude Code
claude mcp add --transport http reclee https://app.reclee.com/api/mcpDespués, dentro de Claude Code, ejecuta /mcp, elige reclee y autentica: se abre el navegador con la pantalla de consentimiento. La primera vez que lo pidas, Claude Code muestra las tools de Reclee junto a las demás.
Para un segundo workspace:
claude mcp add --transport http reclee-otra-agencia https://app.reclee.com/api/mcpCursor
Agrega el servidor en ~/.cursor/mcp.json (para todos tus proyectos) o en .cursor/mcp.json (solo para uno):
{
"mcpServers": {
"reclee": {
"url": "https://app.reclee.com/api/mcp"
}
}
}Al habilitarlo en la configuración de MCP de Cursor, Cursor inicia el OAuth y abre el navegador.
VS Code
En .vscode/mcp.json:
{
"servers": {
"reclee": {
"type": "http",
"url": "https://app.reclee.com/api/mcp"
}
}
}Inicia el servidor desde la lista de servidores MCP; VS Code te pide autorizar y abre Reclee en el navegador.
Otros clientes
Cualquier cliente que hable Streamable HTTP y la autorización de MCP (OAuth 2.1 con descubrimiento y registro dinámico) se conecta con la URL sola. Si escribes tu propio cliente, el flujo completo está en Autorización OAuth.
MCP Inspector
El MCP Inspector sirve para ver las tools y probarlas a mano:
npx @modelcontextprotocol/inspectorEn Transport Type, elige Streamable HTTP, y pega https://app.reclee.com/api/mcp como URL.
Abre Open Auth Settings y corre Quick OAuth Flow. El Inspector se registra, abre Reclee para que aceptes y canjea el código.
Conecta y abre Tools → List Tools.
El Inspector corre en tu navegador; el servidor responde con CORS abierto (Access-Control-Allow-Origin: *) para que funcione.
Con una API key
Para clientes que no soportan OAuth, scripts o servidores, puedes mandar una API key directamente en el header Authorization. El servidor acepta cualquier key rcl_… activa de una persona con asiento; es la misma credencial que usa la API REST.
En la app, ve a Configuración → Developers y crea una API key. Cópiala: se muestra una sola vez.
Configura el header Authorization: Bearer rcl_… en tu cliente.
La key queda atada a tu membresía en el workspace donde la creaste: el MCP opera en ese workspace, con tu rol.
Claude Code:
claude mcp add --transport http reclee https://app.reclee.com/api/mcp \
--header "Authorization: Bearer rcl_tu_api_key"Cursor (mcp.json):
{
"mcpServers": {
"reclee": {
"url": "https://app.reclee.com/api/mcp",
"headers": {
"Authorization": "Bearer rcl_tu_api_key"
}
}
}
}VS Code (.vscode/mcp.json, la key se pide al iniciar y no queda en el archivo):
{
"inputs": [
{
"type": "promptString",
"id": "reclee-api-key",
"description": "API key de Reclee",
"password": true
}
],
"servers": {
"reclee": {
"type": "http",
"url": "https://app.reclee.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:reclee-api-key}"
}
}
}
}Clientes que solo hablan stdio: un puente como mcp-remote (de terceros) expone el servidor HTTP como un proceso local y reenvía el header:
npx mcp-remote https://app.reclee.com/api/mcp --header "Authorization: Bearer rcl_tu_api_key"Una key es una contraseña
No la guardes en un archivo que se comparte o se sube a un repositorio. Si se filtra, revócala en Configuración → Developers: deja de funcionar en el próximo request.
Probar a mano con HTTP
Útil para verificar una key o depurar un cliente. Cada request es un POST con un mensaje JSON-RPC. Los headers Content-Type: application/json y Accept: application/json, text/event-stream son obligatorios: sin el segundo, el servidor contesta 406.
curl -s https://app.reclee.com/api/mcp \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": { "name": "mi-script", "version": "1.0.0" }
}
}'Respuesta (extracto):
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-06-18",
"capabilities": { "tools": { "listChanged": true } },
"serverInfo": { "name": "reclee", "version": "1.0.0" },
"instructions": "Reclee is a recruiting agency's workspace: job posts, candidates, the ATS pipeline, sourcing and the CRM. ..."
}
}Como el servidor no guarda sesión, puedes llamar a tools/list o tools/call directamente, sin initialize previo:
curl -s https://app.reclee.com/api/mcp \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "list_job_posts",
"arguments": { "status": "ACTIVE", "limit": 5 }
}
}'El resultado de una tool viene dos veces: como texto JSON en content[0].text y como objeto en structuredContent. La forma de ese objeto está en Seguridad y confirmaciones.
Cada mensaje cuenta
Cada POST a /api/mcp con una key válida cuenta como un request contra el rate limit de 60 por minuto, incluidos initialize, tools/list y las notificaciones.