Conexiones MCP para agentes personalizados

Las conexiones MCP (Model Context Protocol) permiten que tu Agente Personalizado se conecte de forma segura a apps externas. Con las conexiones MCP, tu agente puede leer información y realizar acciones mediante conexiones preconfiguradas con apps como Linear, Ramp, Figma y más, o bien conectar con cualquier app configurando conexiones MCP personalizadas.

Nota: Las conexiones MCP solo están disponibles en los planes Business y Enterprise.

Las conexiones MCP permiten que los Agentes Personalizados interactúen con herramientas y servicios externos a través del Model Context Protocol. Las herramientas MCP funcionan con todos los tipos de disparadores, incluidas las ejecuciones programadas, las ejecuciones disparadas por eventos de Notion o Slack y las ejecuciones manuales desde el chat o mediante @-menciones.

Características principales:

• Servidores preconfigurados: puedes conectarte rápidamente a aplicaciones populares sin ninguna configuración adicional.

• Servidores personalizados: conéctate a cualquier herramienta que admita un servidor MCP alojado utilizando URL disponibles públicamente.

• Personalización: Las herramientas de cada conexión se pueden activar/desactivar, y puedes elegir si quieres que pidan una confirmación antes de ejecutarse, que lo hagan automáticamente o permitir permanentemente todas las herramientas de un servidor.

Cada conexión MCP es exclusiva de un único Agente Personalizado y utiliza las credenciales de la persona que la autenticó. Las conexiones no se comparten entre Agentes Personalizados, incluso si se conectan al mismo servicio.

Esto significa que:

• Si configuras una conexión de Figma para el agente A, el agente B necesitará su propia conexión de Figma.

• Debes iniciar sesión en cada servidor MCP para cada agente que configures.

• Revocar una conexión en un agente no afecta a otros agentes.

Puedes conectarte a las siguientes aplicaciones sin ninguna configuración adicional:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Abre la Configuración de tu agente personalizado.

2. Ve a Herramientas y acceso.

3. Haz clic en Añadir conexión → Añadir.

4. Elige un servidor preconfigurado.

5. Sigue las indicaciones de autenticación para conectar tu cuenta.

6. Selecciona qué herramientas del servidor quieres que utilice tu agente. Estas variarán según el servidor que elijas.

7. Haz clic en Conectar.

Para conectarse a un servidor MCP que no esté en la lista preconfigurada, un administrador del espacio de trabajo debe activar primero esta opción. Hay dos ajustes distintos: uno para permitir servidores MCP personalizados y otro para decidir si los miembros pueden instalar cualquier conexión o solo las que tú apruebes.

Para permitir servidores MCP personalizados:

1. Como administrador del espacio de trabajo, ve a Ajustes → Conexiones.

2. En la pestaña Gestionar, activa Habilitar servidores MCP personalizados.

Para elegir si los miembros pueden instalar cualquier conexión o solo las aprobadas por el administrador:

1. Como administrador del espacio de trabajo, ve a Ajustes → Conexiones.

2. En la pestaña Gestionar, busca la sección Gestionar permisos.

3. Junto a Limitar qué conexiones pueden instalar los miembros, elige una:

   • Aprobadas y recomendadas: Aprueba automáticamente todas las conexiones recomendadas por Notion.

   • Solo aprobadas: Selecciona manualmente cada conexión que los miembros pueden instalar.

4. Selecciona Conexiones aprobadas para revisar lo que los miembros pueden instalar.

5. Selecciona Añadir conexión aprobada. A continuación, elige lo que quieres permitir:

   • Conexiones: Busca una conexión por nombre o ID y añádela a la lista de aprobadas.

   • Servidor MCP personalizado: Añade una URL de servidor MCP personalizado específica que quieras permitir.

6. Haz clic en «Save».

Una vez configurado esto, cualquier persona del espacio de trabajo podrá conectarse a las opciones aprobadas al configurar un Agente Personalizado. Se autenticarán con sus propias credenciales.

Para añadir un MCP personalizado a un Agente Personalizado:

1. Abre la Configuración de tu Agente Personalizado.

2. Ve a Herramientas y acceso.

3. Haz clic en Añadir conexión → Servidor MCP personalizado.

4. Tendrás que introducir la URL del servidor MCP de la herramienta o proveedor al que te conectas (por ejemplo: el equipo de herramientas internas de tu empresa).

5. Proporciona un nombre para mostrar para la conexión (opcional).

6. Añade los detalles de autenticación necesarios.

7. Haz clic en Conectar.

Los servidores MCP personalizados pueden admitir uno o ambos de los siguientes métodos de inicio de sesión:

• OAuth

• Autenticación basada en encabezados

  (por ejemplo, claves de API o tokens de portador)

Algunos servidores OAuth no admiten el registro dinámico de clientes (DCR). Esto significa que Notion debe registrar previamente una aplicación cliente con el servicio de terceros antes de que el inicio de sesión OAuth pueda funcionar. Si el servidor que quieres usar no admite DCR, consulta su documentación para ver si puedes usar una clave API o un token de portador en su lugar. Si ninguna de las dos opciones está disponible, el servidor MCP no se puede usar con agentes personalizados.

Puedes decidir cómo debe usar un Agente Personalizado una conexión MCP en la Configuración de tu Agente Personalizado, en Herramientas y acceso. Despliega la entrada de la conexión MCP para ver las herramientas disponibles y determinar cómo se ejecutan. Las herramientas se pueden habilitar o deshabilitar usando el interruptor adyacente.

Herramientas de lectura y escritura

• Las herramientas de lectura (por ejemplo, buscar, obtener, enumerar, ver) permiten al agente personalizado recuperar o consultar información sin realizar cambios en los sistemas externos.

• Las herramientas de escritura (ej.: crear, actualizar, eliminar, enviar, publicar) realizan cambios en los datos de sistemas externos. De forma predeterminada, estas requieren confirmaciónantes de que el agente ejecute la acción.

Ejecutar automáticamente o preguntar siempre

• Ejecutar automáticamente permite que la herramienta se ejecute sin requerir la confirmación del usuario. Esta configuración es ideal para herramientas de lectura (buscar, obtener, listar, ver), ya que no modifican los datos.

• Preguntar siempre requiere que el usuario apruebe o cancele una acción antes de que se ejecute. Esta es la configuración predeterminada para las herramientas de escritura (crear, actualizar, eliminar, enviar) para evitar cambios no deseados.

• Permitir siempre aprueba permanentemente todas las herramientas de un servidor y elimina las solicitudes de confirmación futuras.

Cómo eliminar una conexión MCP

1. Abre la Configuración de tu Agente Personalizado.

2. Ve a Herramientas y acceso.

3. Busca la conexión MCP y haz clic en Desconectar.

4. Haz clic en Desconectar para confirmar.

5. Prueba siempre tu Agente Personalizado después de realizar cambios. Puedes volver a conectarte en cualquier momento autenticándote de nuevo.

Nota: Si eliminas una conexión, el Agente Personalizado ya no podrá acceder a ese servicio y las ejecuciones programadas que dependan de ese servidor podrían fallar. Los flujos de trabajo de tu Agente Personalizado podrían interrumpirse en cuanto te desconectes. Puedes volver a conectarte en cualquier momento autenticándote de nuevo.

Las conexiones MCP respetan los niveles de permiso de usuario establecidos en tu Agente Personalizado. Esto es lo que puede hacer cada nivel de permiso con las herramientas conectadas mediante MCP.

Los usuarios con permisos de Acceso completo y de Puede editar para un Agente Personalizado pueden:

• Añadir nuevas conexiones MCP al Agente Personalizado.

• Chatear con el Agente Personalizado y usar todas las herramientas conectadas, incluso si no tienen acceso a la herramienta fuera del Agente Personalizado.

• Ver el registro de actividad del Agente Personalizado y el uso de la herramienta MCP.

• Eliminar las conexiones MCP existentes.

• Volver a conectar o actualizar las credenciales del servidor MCP.

Y para las conexiones MCP que configuren, los usuarios con permisos de acceso completo y de edición pueden:

• Configurar qué herramientas están habilitadas o deshabilitadas y cambiar la configuración de ejecución de la herramienta (ejecutar automáticamente o preguntar siempre).

Nota: Una vez establecida una conexión MCP, solo la persona que autentica la conexión MCP puede configurar y actualizar los ajustes de la herramienta, incluso si otros tienen permisos de Acceso completo o de Puede editar para un Agente Personalizado. El Agente Personalizado utiliza las credenciales y los permisos de esa persona al acceder al servicio externo.

Los usuarios con permisos de Puede ver e interactuar para un Agente Personalizado pueden:

• Chatear con el Agente Personalizado y usar todas las herramientas conectadas, incluso si no tienen acceso a las herramientas fuera del Agente Personalizado.

• Disparar acciones de lectura y escritura a través del agente.

• Aprobar o cancelar acciones de escritura cuando se requiera confirmación.

• Ver qué servidores MCP están conectados (en los ajustes de Agente Personalizado).

Los usuarios con permisos de Puede ver e interactuar no pueden:

• Añadir o eliminar conexiones MCP.

• Cambiar las herramientas habilitadas.

• Modificar la configuración de ejecución de la herramienta.

• Ver el registro de actividad completo del agente.

Nota: Las acciones de escritura (como crear o actualizar elementos) requieren confirmación de forma predeterminada para evitar cambios no deseados. Los usuarios verán un aviso que muestra exactamente qué acción realizará el agente antes de ejecutarla.

Si las herramientas no aparecen después de conectarse:

• Actualiza la página de ajustes del agente.

• Comprueba que el servidor MCP se haya autenticado correctamente (busca una marca de verificación verde o el estado «Conectado»).

• Verifica que el servidor esté en línea y que devuelva los metadatos de la herramienta.

• Intenta volver a conectar el servidor, o desconéctalo y vuelve a añadirlo.

Si las ejecuciones del Agente Personalizado fallan con errores de MCP:

• Comprueba la pestaña Actividad para ver mensajes de error específicos.

• Verifica que tu conexión siga siendo válida (es posible que los tokens hayan caducado).

• Asegúrate de que la conexión siga habilitada en la configuración del agente.

• Intenta volver a conectar el servidor MCP para actualizar las credenciales.

• Actualiza las instrucciones de tu Agente Personalizado para mencionar el servidor o el nombre de la herramienta que quieres usar. Por ejemplo: «Usa Linear MCP para recuperar metadatos para este simulacro».