Para administradores

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 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.
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. 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) omite lo que tu organización no tiene. Cómo encajan los datos (en inglés) 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, 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).