Reclee

Límites

Rate limit, ausencia de sesiones, tiempos máximos y tamaño de los mensajes del servidor MCP.

El servidor MCP comparte los límites de la API REST y suma los propios del transporte. Esta página reúne todos los que puede encontrar un cliente.

Rate limit

60 requests por minuto por persona, compartidos con la API REST. Si la misma persona usa una integración REST y un cliente MCP a la vez, los dos gastan del mismo cupo.

  • Cuenta cada POST /api/mcp que llega con una key válida, sea cual sea el mensaje: initialize, tools/list, tools/call o una notificación. Un cliente que inicializa y lista tools antes de cada llamada gasta tres requests por cada tool.
  • Un request con una key inválida no cuenta.
  • Pasado el límite, el servidor contesta antes de llegar a la tool, con un error HTTP (no JSON-RPC):
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 12

{ "error": "RATE_LIMITED", "retryAfterSeconds": 12 }

Retry-After está expuesto por CORS, así que un cliente que corre en el navegador también lo lee. Espera esos segundos antes de reintentar.

Aparte, un proveedor externo de datos puede pedir que se espere. En ese caso la tool PROVIDER contesta una negativa (isError: true) con { "error": "RATE_LIMITED", "retryAfterSeconds": … }; no es el rate limit de Reclee y no se resuelve bajando tu ritmo de requests.

Detalle general en Rate limits.

Uso y créditos

Las tools GENERATE consumen uso de IA de la persona y las PROVIDER pueden consumir créditos del workspace. Son límites de plan, distintos del rate limit: cuando se agotan, la tool contesta una negativa y no gasta nada. Ver Seguridad y confirmaciones y Créditos y uso.

Sin sesiones

El servidor no guarda estado entre requests:

  • No emite Mcp-Session-Id, y no hace falta mandarlo.
  • No abre streams SSE: cada respuesta es un JSON completo. No hay notificaciones del servidor ni avisos de progreso.
  • GET /api/mcp y DELETE /api/mcp contestan 405 con Allow: POST, OPTIONS: no hay stream que abrir ni sesión que cerrar.
  • No hace falta initialize antes de cada llamada. Un cliente puede llamar a tools/call directamente.
  • Ninguna tool recuerda llamadas anteriores: un objeto se nombra por su id. Por ejemplo, get_talent_search necesita el searchId que devolvió search_talent.

Tiempo máximo por request

Cada request tiene 300 segundos como máximo. Casi todas las tools contestan en segundos. Las que pueden tardar minutos son las que esperan a un modelo o a un proveedor dentro del mismo request:

  • las GENERATE, que esperan la respuesta del modelo;
  • continue_sourcing, que busca, enriquece y puntúa una página antes de contestar (unos dos minutos);
  • run_match_score, que calcula antes de contestar; lo que no llega a cubrir queda contado en remaining.

Configura el timeout de tu cliente para no cortar antes: un cliente que abandona a los 60 segundos puede perder la respuesta de una tool que igual escribió.

Otro trabajo largo sigue después de la respuesta:

ToolQué devuelveCómo seguirlo
run_sourcingLa corrida arrancada; sigue sola en segundo plano.get_talent_icp (su openRun) y list_longlists.
continue_sourcingLo que hizo la página; con autoStep (por defecto true) la corrida sigue sola.get_talent_icp y list_longlists.
upload_cvUn jobId y una URL de subida por archivo; los CVs se leen después.get_cv_import con el jobId.

En estos casos cost.billedLater puede venir en true: parte del gasto se registra a medida que el trabajo avanza.

Tamaño de los mensajes

  • Cuerpo del request: hasta 4 MB por mensaje JSON-RPC. Uno más grande contesta 413 con un error JSON-RPC.
  • Archivos: no viajan por MCP. upload_cv y upload_attachment devuelven una URL firmada (válida dos horas) a la que tu cliente sube los bytes con un PUT. Un CV puede pesar hasta 4 MB (PDF o DOCX, hasta 100 por carga); un adjunto, hasta 10 MB. El paso a paso está en Acciones del talent pool.
  • Listas: las lecturas que listan devuelven hasta 50 filas por página (20 por defecto) y traen total; para el resto, pide la página siguiente con page.

Headers obligatorios

HeaderValorSin él
AuthorizationBearer rcl_…401 con WWW-Authenticate
Content-Typeapplication/json415
Acceptapplication/json, text/event-stream406

Los clientes MCP los mandan solos; importan si llamas al servidor a mano.

En esta página