*MCP › Guías*

# Límites y contexto

> El catálogo es grande. Elige permisos para que el cliente liste solo las herramientas que necesita y pide páginas pequeñas.

## Límites de peticiones

El servidor MCP funciona con la cuota de la clave: 120 llamadas por minuto por clave en todas las herramientas, más otras 30 por minuto aparte que comparten las herramientas de disponibilidad. Una [`rate_limited`](https://docs.filmo.io/es/rest-api/errors/rate_limited) el resultado incluye `retryAfter` (segundos) y el `detail` “Rate limit exceeded: retry in N seconds”. Además, cada resultado informa de la cuota en `meta.rateLimit` (`limit`, `remaining`, `reset`), porque las cabeceras `RateLimit-*` no viajan por MCP.

## El tamaño del catálogo

`tools/list` es público: enumera las 170 herramientas, unos 1.00 MB de definiciones. Con una clave, enumera solo las herramientas que esa clave puede llamar, así que los permisos (scopes) de la clave determinan cuánto del contexto de tu cliente ocupan las herramientas. Con OAuth, los clientes con autenticación diferida enumeran todo el catálogo antes de iniciar sesión y el servidor no anuncia cambios (`tools.listChanged` es false); cómo se comporta cada cliente después de que des tu consentimiento está en su página Conectar.

## Preajustes

Un preset es una lista corta de permisos (scopes) que mantiene a un cliente por debajo de su límite de herramientas. Ninguno incluye `ai:ask`. Con una clave, créala con exactamente estos permisos. Con OAuth, un preset solo funciona si el administrador marca esos permisos a mano en la pantalla de consentimiento.

| Preajuste | Permisos | Herramientas | Definiciones (caracteres) |
| --- | --- | --- | --- |
| Disponibilidad y agenda (lectura) | `availability:read`, `schedule:read`, `planner:read`, `staff:read`, `vehicles:read`, `items:read`, `spaces:read`, `kits:read`, `account:read` | 20 | 107.420 |
| CRM (lectura) | `contacts:read`, `crm:read`, `quotes:read`, `projects:read`, `tags:read`, `notes:read`, `users:read`, `account:read` | 18 | 90.993 |
| Operaciones de alquiler | `orders:read`, `orders:write`, `availability:read`, `items:read`, `contacts:read`, `account:read` | 21 | 158.716 |
| Finanzas (lectura) | `invoices:read`, `treasury:read`, `contracts:read`, `supplier-invoices:read`, `purchase-orders:read`, `account:read` | 20 | 113.977 |
| Todos los permisos de lectura | 31 | 76 | 422.451 |
| Todos los permisos | 59 | 170 | 1.049.688 |

## Pedir páginas pequeñas

- Pide `limit` 20 y añade un filtro. La página por defecto es de 50 y el máximo de 500; una lista de 50 contactos o pedidos puede superar el umbral de salida de un cliente.
- Devuelve `pagination.nextCursor` como `cursor`, con el mismo `limit` y `sort`; el cursor está ligado a ambos.
- Define `includeTotal` solo cuando necesites el total.
- En las herramientas de listado, los filtros de fecha van en `dateFilters` como `{ field: { gte, lte, gt, lt, on } }`; una fecha sin hora se lee en la zona horaria del negocio de la cuenta.

## Qué hace cada cliente con el tamaño

| Cliente | Herramientas | Salida |
| --- | --- | --- |
| Claude (web, escritorio) | Sin límite documentado | Resultados cortados en unos 150,000 caracteres; 240 s por llamada |
| Claude Code | Sin tope fijo; la búsqueda de herramientas difiere las definiciones | Avisa por encima de 10,000 tokens, corta en 25,000; el texto de más de 50,000 caracteres va a un archivo |
| Cursor | Unas 40 en total (hilos de foros, no documentación) | No documentado |
| VS Code | 128 por petición; herramientas virtuales por encima | No documentado |
| Windsurf | 100 en total | No documentado |
| Codex | No documentado | `output_token_limit` por herramienta; 60 s por llamada por defecto |

La página de cada cliente tiene la fuente y la fecha. Claude Code también corta cada descripción de herramienta en 2,048 caracteres; la más larga de este catálogo tiene 1,718 caracteres.

## Llamadas lentas

[`filmo_ai_ask`](https://docs.filmo.io/es/mcp/tools/ai/filmo-ai-ask) puede tardar decenas de segundos cuando una pregunta encadena varias consultas. Fija el tiempo que espera un cliente por encima de eso donde te lo permita (el `tool_timeout_sec` de Codex es 60 por defecto; Claude espera 240 segundos). Si el resultado trae `needsMoreContext`, reformula la pregunta con más detalle en lugar de repetir la misma.

---

URL canónica: https://docs.filmo.io/es/mcp/guides/limits-and-context  
Última actualización: 2026-10-25