Solución de problemas del MCP: 401, 403, herramientas ausentes
La mayoría de los problemas del MCP de LanaChat vienen del token: incorrecto, caducado o con una casilla ausente. Busque el error que ve en la tabla y luego los detalles de abajo.
| Lo que ve | Causa probable | Solución |
|---|---|---|
401, "unauthorized" | token incorrecto, caducado, revocado o rotado | cópielo de nuevo o use Rotate, revise Bearer |
403, "permission", "requires …" | al token le falta una casilla | Edit en el token, marque la casilla, reinicie |
| "tool not found" | casilla desactivada, nombre inventado, servidor no añadido | marque la casilla, revise /mcp |
409, "revision" o "hash" | el elemento cambió entretanto | léalo de nuevo y rehaga el cambio |
| "request too large" | más de 4 MiB en una solicitud | suba los archivos al Vault o por Drive |
| sin respuesta | red o un reinicio breve | reintente en unos minutos |
401: unauthorized #
El servidor no aceptó el token.
- El token se copió con un carácter de menos o de más. Cópielo de nuevo, desde donde lo guardó.
- La cabecera debe decir exactamente
Authorization: Bearerseguido del token. La palabraBearery el espacio son obligatorios. - El token fue revocado, o rotado (el anterior muere al instante). En Users › API & MCP, compruebe su estado.
- El token caducó: los tokens duran 365 días. Pulse Rotate (o Renew) y ponga el nuevo en su asistente.
- Usó una clave de empleado (Team Management) o una contraseña de la Console. El MCP solo acepta un token de API & MCP.
403: forbidden, o "permission" #
El token es válido pero le falta una casilla para esta acción.
- En Users › API & MCP, pulse Edit en el token.
- Marque la casilla que necesita la acción (vea la tabla en Cree su MCP token).
- Guarde, cierre su asistente y reinícielo.
Dos casos especiales:
- Se rechaza asignar una licencia: al token le falta Spend the balance on licences (necesita también Read sales, y solo el propietario del espacio de trabajo puede marcarla), o se alcanzó el Daily limit for licences (0 significa ninguna licencia). El rechazo indica cuál. Corríjalo con Edit en el token, o asigne la licencia en la Console, en Billing › Licences.
- Playground rechazado: las respuestas del Playground necesitan un saldo positivo. Recargue en Billing › Top up, o sáltese la prueba.
Falta una herramienta, o "tool not found" #
- Sin Configure agency AI, el asistente solo recibe las herramientas de configuración, fans y ventas (132): ninguna herramienta de AI Brain, Playground ni publicación. Marque la casilla y reinicie.
- Una herramienta que aparece en la lista pero se niega ("requires can_generate", "requires the owner's can_publish permission") indica una casilla ausente en el token. Márquela con Edit y reinicie.
- El asistente inventó un nombre. Pídale: "Lista las herramientas de lanachat." Los nombres reales están en la referencia de herramientas.
- El servidor no está conectado: en Claude Code o Codex escriba
/mcp; en un editor, revise sus ajustes de MCP.
409, "revision" o "hash" cambiado #
Alguien (o el propio asistente) cambió lo mismo entretanto. Pida al asistente que lea de nuevo el elemento y rehaga el cambio con la revisión reciente. No se perdió nada.
Solicitud demasiado grande #
Una solicitud MCP está limitada a 4 MiB. Las fotos y los vídeos no pasan por el chat: suba los archivos al Vault, o dé el enlace de una carpeta pública de Google Drive y deje que el asistente la importe.
El servidor no responde #
- Revise su conexión a internet.
- Inténtelo de nuevo en unos minutos: puede producirse un reinicio breve del servidor.
- Si sigue caído tras 15 minutos: escríbanos desde la Console (Support) con la hora y el nombre de la herramienta. Nunca envíe el token.
Consejo Tras cualquier cambio en un token (Edit, Rotate), reinicie el asistente. Solo lee la lista de herramientas cuando se conecta.
FAQ #
¿Por qué una herramienta aparece en la lista pero se niega a ejecutarse? #
Todas las herramientas de la familia aparecen en la lista, y las casillas se comprueban en cada llamada. Un rechazo que nombra un permiso significa que al token le falta esa casilla.
Mi token funcionaba ayer. ¿Por qué 401 hoy? #
Fue rotado, revocado o caducó (365 días). Compruebe su estado en Users › API & MCP y ponga el token nuevo en su asistente.
¿Tengo que reiniciar el asistente después de editar el token? #
Sí. El asistente solo lee la lista de herramientas cuando se conecta.