Conexiones MCP para agentes personalizados

Las conexiones MCP (Protocolo de contexto de modelo) permiten que tus agentes personalizados se conecten de forma segura a aplicaciones externas. Gracias a ellas, los agentes pueden leer información y realizar acciones utilizando conexiones preconfiguradas con aplicaciones como Linear, Ramp, Canva y más, o conectarse a cualquier aplicación configurando conexiones MCP personalizadas.

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

Las conexiones MCP permiten a los agentes personalizados interactuar con herramientas y servicios externos a través del protocolo de contexto de modelo. Las herramientas de MCP funcionan con todos los tipos de activadores, incluidas las ejecuciones programadas, las que se activan basándose en eventos de Notion o Slack, y las manuales a través del chat o las @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 o desactivar, y puedes elegir si quieres que pidan una confirmación antes de ejecutarse o que lo hagan automáticamente.

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 los agentes, incluso aunque se conecten 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:

• Linear

• Ramp

• Figma

• GitHub

• Stripe

• Sentry

• Attio

• HubSpot

• Amplitude

• Intercom

• Wiz

1. Abre la Configuraciónde tu agente personalizado.

2. Ve a Herramientas y acceso.

3. Haz clic en Agregar conexión → Agregar.

4. Elige un servidor preconfigurado.

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

6. Selecciona qué herramientas del servidor quieres que use tu agente. Estas variarán en función del servidor que elijas.

7. Haz clic en Guardar.

Sigue estos pasos si quieres conectarte a un servidor MCP que no está en la lista de los preconfigurados:

1. Para usar conexiones MCP personalizadas con los agentes, un administrador del espacio de trabajo debe habilitar esta opción en Configuración → IA de Notion → Conexiones de IA → Habilitar servidores MCP personalizados.

2. Una vez que el administrador del espacio de trabajo haya permitido las conexiones MCP personalizadas, abre la Configuraciónde tu agente personalizado.

3. Ve a Herramientas y acceso.

4. Haz clic en Agregar conexión → Servidor MCP personalizado.

5. Ingresa la URL del servidor MCP.

6. Proporciona un nombre para la conexión.

7. Agrega los detalles de autenticación necesarios.

8. Haz clic en Guardar.

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 del cliente con el servicio de terceros antes de que el inicio de sesión de OAuth pueda funcionar. Si el servidor que quieres usar no es compatible con el DCR, consulta su documentación para ver si puedes usar una clave de API o un token de portador. Si ninguna de las opciones está disponible, el servidor MCP no se podrá utilizar con los agentes personalizados.

Puedes decidir cómo debe usar un agente personalizado una conexión MCP en la Configuraciónde tu agente, en la secciónHerramientas y acceso. Amplía la entrada de conexión MCP para ver las herramientas disponibles y determinar cómo deben ejecutarse. Las herramientas se pueden habilitar o deshabilitar utilizando el botón adyacente.

Herramientas de lectura y escritura

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

• Las herramientas de escritura (por ejemplo, crear, actualizar, eliminar, enviar, publicar) realizan cambios en los datos de los sistemas externos. De forma predeterminada, estas

  requieren confirmación antes 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 confirmación

  del usuario. Esta configuración es mejor para las herramientas de lectura (buscar, obtener, enumerar, visualizar), ya que no modifican datos.

• La opción Preguntar siempre significa que el usuario tendrá que aprobar o cancelar las acciones antes de que se ejecuten. Esta es la configuración predeterminada para las herramientas de escritura (crear, actualizar, eliminar, enviar) para poder evitar cambios no deseados.

Cómo eliminar una conexión MCP

1. Abre la Configuración de tu agente.

2. Ve a Herramientas y acceso.

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

4. Haz clic en Guardar.

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

Nota: si eliminas una conexión, el agente ya no podrá acceder a ese servicio y las ejecuciones programadas que dependan de dicho servidor podrían fallar. Los flujos de trabajo de tu agente podrían interrumpirse si eliminas una conexión, incluso antes de hacer clic en Guardar.

Las conexiones MCP respetan los niveles de permisos de usuario establecidos en tu agente personalizado. Esto es lo que cada nivel de permiso puede hacer con las herramientas conectadas a MCP:

Los usuarios con los permisos Acceso completo y Puede editar para un agente pueden:

• Agregar nuevas conexiones MCP al agente

• Chatear con el agente 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 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 los permisos Acceso completo y Puede editar 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 que se establece una conexión MCP, solo la persona que la autentica puede configurar y actualizar los ajustes de la herramienta, incluso si otros tienen permisos de Acceso completo o de Puede editar para el agente. El agente utiliza las credenciales y los permisos de esa persona al acceder al servicio externo.

Los usuarios con los permisos Puede ver e interactuar para un agente pueden:

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

• Activar 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 del agente)

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

• Agregar o eliminar conexiones MCP

• Cambiar las herramientas habilitadas

• Modificar la configuración de ejecución de las herramientas

• 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 involuntarios. Los usuarios verán un mensaje que mostrará exactamente qué hará el agente antes de que lo haga.

Si las herramientas no aparecen después de conectarse:

• Actualiza la página de configuración 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 agregarlo.

Si las ejecuciones del agente 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 para mencionar el nombre del servidor o de la herramienta que quieres usar. Por ejemplo: "usa Linear MCP para recuperar los metadatos de esta simulación".