# Para administradores

Activa o desactiva MCP y la API REST para tu organización, y decide quién puede crear tokens de API y conectar aplicaciones.

Esta página es para quien gestiona la organización de plnnrly. Quien solo quiera conectar un asistente de IA o llamar a la API puede necesitar que antes lo actives tú.

## La página MCP & API

Los interruptores están en **Configuración › Administración › MCP & API**, dentro de plnnrly. Dos permisos deciden quién puede usar la página:

- **Ver MCP & API** permite abrir la página y ver qué interruptores están activados.
- **Gestionar MCP & API** permite cambiar los interruptores.

Mientras tu organización está suspendida, no se puede cambiar nada en la página.

## Los tres interruptores

| Interruptor                        | Valor predeterminado                  | Qué hace                                                                                                                                                                                                                                                          |
| ---------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Activar la API REST**            | Activado                              | Permite que las personas llamen a la API REST con sus propios tokens de API, y que conecten aplicaciones iniciando sesión con OAuth.                                                                                                                              |
| **Activar MCP**                    | Desactivado en una organización nueva | Permite que las personas conecten un asistente de IA, como Claude o ChatGPT, iniciando sesión. El asistente trabaja a través de la API REST, en nombre de la persona que lo conectó.                                                                              |
| **Permitir acciones destructivas** | Desactivado                           | Permite que un asistente de IA conectado elimine todo lo que la API REST puede eliminar, dentro de los permisos de la propia persona y solo después de que lo confirme. Mientras está desactivado, un asistente puede leer, crear y actualizar, pero no eliminar. |

Cómo dependen los interruptores entre sí:

- **Activar MCP** solo puede estar activado mientras **Activar la API REST** también lo esté, porque los asistentes de IA trabajan a través de la API REST.
- Desactivar MCP también desactiva **Permitir acciones destructivas**. Si más adelante vuelves a activar MCP, ese interruptor sigue desactivado.
- **Permitir acciones destructivas** solo se aplica a los asistentes de IA. Un token personal de API con **Eliminación** entre sus **Permisos** puede eliminar todo lo que su propietario puede eliminar, diga lo que diga este interruptor. Las aplicaciones que llaman a la API REST con un inicio de sesión OAuth nunca pueden eliminar a través de ella.

Conectar un asistente de IA no necesita ningún permiso adicional. Mientras MCP está activado, todos en la organización ven el panel de **IA** (el icono de destellos en la barra superior) y pueden conectar uno. El asistente solo puede hacer lo que puede la cuenta de esa persona.

## Qué ocurre cuando un interruptor está desactivado

### API REST desactivada

- Todas las peticiones a `/api/v2` reciben `404` [endpoint-not-found](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#endpoint-not-found) con el detalle «The REST API is not enabled for this organisation.», incluidas las que usan un token que ya existe.
- Ya no se pueden conectar aplicaciones iniciando sesión con OAuth.
- **Acceso a la API** desaparece del menú de usuario, así que nadie puede crear, renovar ni revocar tokens.
- MCP también se desactiva. Volver a activar la API REST no vuelve a activar MCP.
- Los tokens existentes se conservan. Vuelven a funcionar cuando la API REST se activa de nuevo, salvo que hayan caducado mientras tanto.

### MCP desactivado

- Los asistentes de IA conectados reciben `404` con el mensaje «The MCP server is not enabled for this organisation.»
- Ningún asistente de IA puede iniciar sesión para conectarse.
- El panel de **IA** desaparece de la barra superior.

## Quién puede crear tokens y conectar aplicaciones

El permiso es **Gestionar tokens de API**. Quien lo tiene puede:

- abrir **Acceso a la API** en el menú de usuario, y crear, renovar y revocar sus propios tokens de API
- conectar una aplicación a la API REST iniciando sesión con OAuth

En una organización nueva, el rol **Admin** lo tiene desde el principio. Para dárselo a otro rol, abre el rol en **RRHH › Gestión de usuarios › Roles**, ve a la pestaña **Configuración** y selecciona **Gestionar tokens de API** en el grupo **Tokens de API**.

Cuando retiras el permiso:

- Las aplicaciones que esa persona conectó a la API REST con OAuth se rechazan al instante, con `403` [insufficient-permission](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#insufficient-permission).
- Sus tokens personales de API siguen funcionando hasta que caduquen. La persona ya no puede abrir **Acceso a la API**, así que ya no puede ver, renovar ni revocar esos tokens.

## Áreas que tu organización no usa

La facturación y las iteraciones son partes opcionales de plnnrly. Sin facturación, todas las operaciones de facturación responden `404` [endpoint-not-found](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#endpoint-not-found). Sin iteraciones, también responden `404` las operaciones de flujos de trabajo, estados de flujo de trabajo, transiciones de flujo de trabajo, tipos de trabajo y etiquetas. Las operaciones de las propias iteraciones y de los elementos de trabajo están siempre disponibles.

La petición de [descubrimiento (en inglés)](https://developers.plnnrly.com/en/docs/api/v2/discovery/) omite lo que tu organización no tiene. [Cómo encajan los datos (en inglés)](https://developers.plnnrly.com/en/docs/api/v2/guides/data-model/#optional-areas) enumera los recursos de cada área.

## Tu propio dominio

Si tu organización usa su propio dominio, usa exactamente ese dominio para la API REST y para MCP. La API REST responde `404` en cualquier otra dirección. Dentro de plnnrly, el panel de **IA** muestra la URL del servidor MCP en tu dominio, y **Acceso a la API** en el menú de usuario muestra la URL base de la API REST.

## Cuando plnnrly no está disponible

Mientras una organización se está configurando, está suspendida o está archivada, la API REST responde `503` [tenant-unavailable](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#tenant-unavailable), y el servidor MCP también responde `503`. Ambos vuelven a funcionar cuando la organización está activa. Si la situación se prolonga, contacta con el [soporte de plnnrly (en inglés)](https://www.plnnrly.com/en/support).

## Páginas relacionadas

- [Introducción a MCP](https://developers.plnnrly.com/es/docs/mcp/)
- [Permisos y seguridad](https://developers.plnnrly.com/es/docs/mcp/permissions-and-safety/)
- [Tokens de API (en inglés)](https://developers.plnnrly.com/en/docs/api/v2/guides/tokens/)
- [Autenticación (en inglés)](https://developers.plnnrly.com/en/docs/api/v2/guides/authentication/)