# Solución de problemas

Qué hacer cuando un cliente de IA no puede conectarse a plnnrly, no puede iniciar sesión o ve rechazada una petición.

Busca el mensaje o el comportamiento que ves y sigue la solución. Los mensajes de plnnrly se citan tal cual, en inglés. Algunos pueden aparecer en otro idioma, como el neerlandés o el idioma en que usas plnnrly; junto a esos se cita también la versión en español.

## Conexión e inicio de sesión

| Lo que ves                                                                                                             | Por qué                                                                                                                                          | Qué hacer                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| «The MCP server is not enabled for this organisation.» (`404`)                                                         | MCP está desactivado para tu organización. Las organizaciones nuevas empiezan con MCP desactivado. Desactivar la API REST también desactiva MCP. | Pide a un administrador que lo active; consulta [Para administradores](https://developers.plnnrly.com/es/docs/administration/).           |
| «OAuth is not available for this organisation.» (`404`) al iniciar sesión                                              | La API REST está desactivada, así que ninguna aplicación puede iniciar sesión.                                                                   | Habla con un administrador; consulta [Para administradores](https://developers.plnnrly.com/es/docs/administration/).                      |
| El cliente no encuentra el servidor, o la página de inicio de sesión muestra `404`                                     | La URL del servidor es incorrecta, o MCP está desactivado.                                                                                       | Copia la URL del servidor del panel de **IA** (el icono de destellos en la barra superior). Si el panel no aparece, MCP está desactivado. |
| El cliente informa de `invalid_redirect_uri`                                                                           | El cliente aún no puede iniciar sesión en plnnrly.                                                                                               | Consulta [Otros clientes](https://developers.plnnrly.com/es/docs/mcp/install/other-clients/).                                             |
| «Your role does not allow connecting apps to the REST API.» o «Tu rol no permite conectar aplicaciones a la API REST.» | La aplicación también pidió acceso a la API REST, y tu rol no tiene **Gestionar tokens de API**.                                                 | Pide el permiso a un administrador, o usa un cliente que solo pida MCP.                                                                   |
| El inicio de sesión se rechaza (`403`) mientras trabajas en una sesión de soporte                                      | Las sesiones de soporte no pueden conectar aplicaciones.                                                                                         | Inicia sesión con tu propia cuenta.                                                                                                       |
| «This organization's access has been suspended.» o «El acceso de esta organización ha sido suspendido.» (`503`)        | Tu organización está suspendida.                                                                                                                 | Contacta con tu administrador.                                                                                                            |
| «This organization is currently unavailable.» o «Esta organización no está disponible actualmente.» (`503`)            | Tu organización se está configurando o está archivada.                                                                                           | Contacta con tu administrador o con el [soporte de plnnrly (en inglés)](https://www.plnnrly.com/en/support).                              |
| El cliente te pide que vuelvas a iniciar sesión                                                                        | No se ha usado durante 30 días, o alguien lo desconectó.                                                                                         | Vuelve a iniciar sesión.                                                                                                                  |

## Uso de las herramientas

| Lo que ves                                                                                                           | Por qué                                                                                          | Qué hacer                                                                                                                                               |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| «Too Many Attempts.» (`429`)                                                                                         | Enviaste más de 60 peticiones MCP en un minuto, sumando todos los clientes de IA que conectaste. | Espera un minuto y después pide menos cosas a la vez.                                                                                                   |
| La respuesta tiene `meta.mcp_truncated`                                                                              | La respuesta superó el límite de unos 30.000 caracteres y se acortó.                             | Pide menos filas, una pregunta más concreta o un solo campo. Consulta [Respuestas](https://developers.plnnrly.com/es/docs/mcp/tools/#responses).        |
| Una eliminación se rechaza con `forbidden-by-policy` y «This organisation does not allow AI clients to delete data.» | **Permitir acciones destructivas** está desactivado para tu organización.                        | Consulta [Permisos y seguridad](https://developers.plnnrly.com/es/docs/mcp/permissions-and-safety/). Solo un administrador puede activarlo.             |
| Un cambio se rechaza con `forbidden-by-policy` y otro mensaje                                                        | Tu rol, o el propio registro, no permite este cambio. El mensaje dice por qué.                   | Comprueba en plnnrly si puedes hacer el cambio tú mismo.                                                                                                |
| Una eliminación o sobrescritura se rechaza con `validation-failed` en `confirm`                                      | Aún no la has confirmado.                                                                        | Dile al asistente que estás de acuerdo, para que repita la llamada con tu confirmación.                                                                 |
| Una subida se rechaza con `endpoint-not-found`                                                                       | No se pueden subir archivos mediante MCP.                                                        | Usa la API REST con un token de API; consulta [Archivos: subida y descarga (en inglés)](https://developers.plnnrly.com/en/docs/api/v2/guides/uploads/). |
| Un registro que sabes que existe devuelve `404`                                                                      | No tienes permiso para verlo, o pertenece a un área que tu organización no usa.                  | Comprueba en plnnrly si puedes abrirlo. El asistente ve exactamente lo que ves tú.                                                                      |
| La aplicación sigue apareciendo en **Aplicaciones conectadas** después de quitarla en el cliente                     | Su inicio de sesión sigue siendo válido hasta 30 días después de su último uso.                  | Haz clic en **Desconectar** en el panel de **IA**.                                                                                                      |

## Las herramientas no aparecen

Comprueba primero el propio cliente:

- **claude.ai y Claude Desktop:** en un chat, haz clic en **+**, elige **Connectors** y comprueba que plnnrly está activado; consulta [claude.ai](https://developers.plnnrly.com/es/docs/mcp/install/claude-ai/).
- **Claude Code:** ejecuta `claude mcp list`, o `/mcp` dentro de una sesión; consulta [Claude Code](https://developers.plnnrly.com/es/docs/mcp/install/claude-code/).
- **ChatGPT:** comprueba que el plugin está instalado, escribe `@` y elige plnnrly; consulta [ChatGPT](https://developers.plnnrly.com/es/docs/mcp/install/chatgpt/).
- **Cursor:** abre el panel **Output** y elige **MCP Logs**; consulta [Cursor](https://developers.plnnrly.com/es/docs/mcp/install/cursor/).
- **Gemini CLI:** ejecuta `/mcp` dentro de una sesión; consulta [Gemini CLI](https://developers.plnnrly.com/es/docs/mcp/install/gemini/).

## Si sigues sin resolverlo

Escribe al [soporte de plnnrly (en inglés)](https://www.plnnrly.com/en/support). Si plnnrly respondió con un error, incluye su `request_id`.
