MCP de Bison
Límites y errores
Qué topes tiene el MCP y cómo se ve cada error, para saber rápido qué corregir.
Límites
| Qué | Límite |
|---|---|
| Tokens activos por empresa | 10 |
run_schema_audit | 30 por día |
generate_faqs | 3 por día |
regenerate_improvements | 3 por día |
Los topes de los trabajos con costo se cuentan por empresa y por día UTC, sumando todos los tokens. Si ya hay un trabajo igual en curso, el servidor devuelve ese en vez de iniciar otro. Los trabajos que tardan responden con estado running: consulta su avance con get_job_status.
Errores de conexión
| Respuesta | Qué significa | Qué hacer |
|---|---|---|
401 UNAUTHENTICATED | El token falta, está mal escrito o fue revocado. | Revisa que el encabezado sea Authorization: Bearer bsn_… y que el token siga activo en Ajustes → API y agentes. |
403 PLAN_REQUIRED | La cuenta de esa empresa no tiene el MCP habilitado. | Escríbenos para activarlo. |
| 405 | Usaste GET. El servidor no guarda sesiones ni abre un flujo de eventos. | Haz solo peticiones POST a https://mcp.bisonagents.com. |
| 406 | Faltó el encabezado Accept. | Envía Accept: application/json, text/event-stream. Los clientes MCP ya lo hacen. |
| 500 | Falló algo en el servidor. | Reintenta. Si persiste, escríbenos con la hora aproximada. |
Errores de una herramienta
Cuando una herramienta no puede hacer lo pedido, responde con un mensaje en español y la marca de error, para que tu agente te lo explique. Los más comunes:
- Tope diario alcanzado. Dice cuántos trabajos de ese tipo permite el día. Vuelve a intentarlo mañana (UTC) o hazlo desde Bison.
- Página que no es del sitio de la marca.
run_schema_auditsolo audita páginas del sitio de tu marca. - Pregunta ya monitoreada o ya sugerida.
suggest_promptno duplica preguntas. - Demasiadas sugerencias pendientes. Pide al equipo revisarlas en Bison → Prompts.
- Mejora que no existe.
update_improvementsolo cambia mejoras de tu empresa; usa un id delist_improvements.
Sin datos todavía
Si tu marca aún no tiene semanas medidas, las herramientas que dependen de un reporte responden con un aviso en lugar de devolver ceros.