Introducción a MCP

plnnrly tiene un servidor MCP (Model Context Protocol). Conecta un asistente de IA a él y el asistente podrá leer y cambiar datos de tu organización por ti. Actúa en tu nombre: puede ver y cambiar lo que puede tu cuenta, y nada más.

Antes de empezar

Un administrador activa MCP en Configuración › Administración › MCP & API. Para abrir esa página se necesita el permiso Ver MCP & API, y para cambiarla, Gestionar MCP & API. MCP está desactivado en las organizaciones nuevas y solo funciona mientras la API REST está activada; Para administradores explica los interruptores.

Datos de conexión

<tu-url> es la dirección con la que inicias sesión en plnnrly, por ejemplo acme.plnnrly.com, o el dominio propio de tu organización. El panel de IA (el icono de destellos en la barra superior) muestra la URL exacta del servidor para tu organización. El panel aparece cuando MCP está activado.

Cómo funciona la conexión

Añades la URL del servidor a tu cliente de IA. El cliente abre plnnrly en tu navegador, donde inicias sesión si hace falta y apruebas la conexión. No hay ningún token que copiar.

La pantalla de aprobación muestra:

• con qué cuenta has iniciado sesión
• lo que pide la aplicación, por ejemplo Usar el servidor MCP (asistentes de IA)
• un aviso cuando tu organización permite acciones destructivas, porque entonces la aplicación también puede eliminar registros
• la dirección a la que vuelves después de aprobar
• Aprobar y Cancelar

Una sesión de soporte no puede conectar una aplicación. Inicia sesión con tu propia cuenta.

Una vez conectado, el cliente renueva su acceso cada hora por sí solo. Un cliente que no hayas usado durante 30 días tiene que volver a iniciar sesión.

¿Conectaste un cliente con un token MCP personal antes de que existiera el inicio de sesión? Ese token sigue funcionando. Puedes eliminarlo en el panel de IA, en Token de acceso personal. Ya no se pueden crear tokens MCP personales nuevos.

Desconectar una aplicación

El panel de IA muestra las aplicaciones que conectaste en Aplicaciones conectadas. Desconectar termina al instante la conexión de IA de una aplicación, y puedes volver a conectarla más tarde. Si el mismo inicio de sesión también le dio acceso a la API REST, ese acceso termina también. En cambio, las aplicaciones conectadas solo a la API REST aparecen en Acceso a la API › Aplicaciones conectadas, en tu menú de usuario.

Quitar plnnrly en el cliente impide que ese cliente lo use, pero no siempre termina el inicio de sesión en plnnrly: la aplicación puede seguir apareciendo hasta 30 días después de su último uso, salvo que el propio cliente haya cancelado su inicio de sesión. Para asegurarte de que la conexión ha terminado, usa Desconectar.

Qué puede hacer un cliente

Un cliente conectado llega a todas las operaciones de la API REST, salvo la subida de archivos, siempre en tu nombre y dentro de tus permisos. Solo puede eliminar si tu organización lo permite y tú lo confirmas.

• Qué puedes pedir muestra preguntas de ejemplo por área.
• Herramientas describe las cuatro herramientas que usa un cliente.
• Permisos y seguridad explica qué puede hacer un cliente y cómo se bloquea la eliminación.

Elige tu cliente

claude mcp add --transport http plnnrly https://<tu-url>/mcp/v1

{
  "mcpServers": {
    "plnnrly": {
      "url": "https://<tu-url>/mcp/v1"
    }
  }
}

gemini mcp add --transport http --scope user plnnrly https://<tu-url>/mcp/v1