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
Enlace a esta sección: Límites de peticionesEl 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 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. (limit, remaining, reset), porque las cabeceras RateLimit-* no viajan por MCP.
El tamaño del catálogo
Enlace a esta sección: El tamaño del catálogotools 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. es false); cómo se comporta cada cliente después de que des tu consentimiento está en su página Conectar.
Preajustes
Enlace a esta sección: PreajustesUn 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
Enlace a esta sección: Pedir páginas pequeñas- Pide
limit20 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.comonextCursor cursor, con el mismolimitysort; el cursor está ligado a ambos. - Define
includeTotalsolo cuando necesites el total. - En las herramientas de listado, los filtros de fecha van en
dateFilterscomo{ 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
Enlace a esta sección: 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
Enlace a esta sección: Llamadas lentasfilmo_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.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasGuías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Solución de problemas
La mayoría de problemas son la URL, los permisos o un cliente que conserva una lista antigua de herramientas.
¿Te ha resultado útil esta página?