# Introducción a MCP

Cómo conectar un asistente de IA, como Claude o ChatGPT, a tu organización de plnnrly y qué puede hacer una vez conectado.

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](https://developers.plnnrly.com/es/docs/administration/) explica los interruptores.

## Datos de conexión

- URL del servidor: `https://<tu-url>/mcp/v1`
- Transporte: HTTP (streamable)
- Autenticación: Inicio de sesión (OAuth)

`<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](https://developers.plnnrly.com/es/docs/mcp/examples/) muestra preguntas de ejemplo por área.
- [Herramientas](https://developers.plnnrly.com/es/docs/mcp/tools/) describe las cuatro herramientas que usa un cliente.
- [Permisos y seguridad](https://developers.plnnrly.com/es/docs/mcp/permissions-and-safety/) explica qué puede hacer un cliente y cómo se bloquea la eliminación.

## Elige tu cliente

- [claude.ai](https://developers.plnnrly.com/es/docs/mcp/install/claude-ai/): Un conector personalizado en tu cuenta de Claude. Después también funciona en Claude Desktop y en las aplicaciones móviles.

  1. En Claude, abre **Customize › Connectors** y elige **Add custom connector**.
  2. Escribe `plnnrly` como nombre y pega la URL del servidor.
  3. Haz clic en **Add**, inicia sesión en plnnrly y haz clic en **Aprobar**.

- [Claude Desktop](https://developers.plnnrly.com/es/docs/mcp/install/claude-desktop/): El mismo conector que en claude.ai. Si lo añadiste allí, ya está aquí.

  1. En Claude Desktop, abre **Customize › Connectors** y elige **Add custom connector**.
  2. Escribe `plnnrly` como nombre y pega la URL del servidor.
  3. Haz clic en **Add**. Se abre una ventana de plnnrly en tu navegador: inicia sesión y haz clic en **Aprobar**.

- [Claude Code](https://developers.plnnrly.com/es/docs/mcp/install/claude-code/): Ejecuta esto en tu terminal y luego inicia sesión con `claude mcp login plnnrly`.

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

- [ChatGPT](https://developers.plnnrly.com/es/docs/mcp/install/chatgpt/): ChatGPT en la web añade plnnrly como servidor MCP personalizado.

  1. Abre chatgpt.com/plugins y elige **+** y después **Add custom MCP server**.
  2. Pega la URL del servidor en **Connection** y elige **OAuth**.
  3. Crea e instala el plugin. Después inicia sesión en plnnrly y haz clic en **Aprobar**.

- [Cursor](https://developers.plnnrly.com/es/docs/mcp/install/cursor/): Añade esta entrada a `~/.cursor/mcp.json`. Cursor te pide iniciar sesión en plnnrly cuando se conecta.

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

- [Gemini](https://developers.plnnrly.com/es/docs/mcp/install/gemini/): Ejecuta esto en tu terminal, inicia `gemini` e inicia sesión con `/mcp auth plnnrly`.

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

- [Otros clientes](https://developers.plnnrly.com/es/docs/mcp/install/other-clients/)