# Solución de problemas del MCP: 401, 403, herramientas ausentes

_Conectar Claude / Codex · 3 min de lectura · Actualizado 2026-11-08 · https://lanachat.ai/guides/es/ai-troubleshooting/_

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: Bearer ` seguido del token. La palabra `Bearer` y 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.

1. En **Users › API & MCP**, pulse **Edit** en el token.
2. Marque la casilla que necesita la acción (vea la tabla en [Cree su MCP token](https://lanachat.ai/guides/es/ai-create-mcp-token/)).
3. 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](https://lanachat.ai/guides/mcp-tool-reference/).
- 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.

> Tip: 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.

## Artículos relacionados

- [Proteja su token](https://lanachat.ai/guides/es/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP: conectar un asistente de IA](https://lanachat.ai/guides/es/api-mcp/)