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/mcpque llega con una key válida, sea cual sea el mensaje:initialize,tools/list,tools/callo 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/mcpyDELETE /api/mcpcontestan405conAllow: POST, OPTIONS: no hay stream que abrir ni sesión que cerrar.- No hace falta
initializeantes de cada llamada. Un cliente puede llamar atools/calldirectamente. - Ninguna tool recuerda llamadas anteriores: un objeto se nombra por su id. Por ejemplo,
get_talent_searchnecesita elsearchIdque 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 enremaining.
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:
| Tool | Qué devuelve | Cómo seguirlo |
|---|---|---|
run_sourcing | La corrida arrancada; sigue sola en segundo plano. | get_talent_icp (su openRun) y list_longlists. |
continue_sourcing | Lo que hizo la página; con autoStep (por defecto true) la corrida sigue sola. | get_talent_icp y list_longlists. |
upload_cv | Un 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
413con un error JSON-RPC. - Archivos: no viajan por MCP.
upload_cvyupload_attachmentdevuelven una URL firmada (válida dos horas) a la que tu cliente sube los bytes con unPUT. 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 conpage.
Headers obligatorios
| Header | Valor | Sin él |
|---|---|---|
Authorization | Bearer rcl_… | 401 con WWW-Authenticate |
Content-Type | application/json | 415 |
Accept | application/json, text/event-stream | 406 |
Los clientes MCP los mandan solos; importan si llamas al servidor a mano.