Servidor MCP de Notion: herramientas, configuración y cómo delimitar su alcance de forma segura
.png)
Diseñado para la velocidad: ~ 10 ms de latencia, incluso bajo carga
¡Una forma increíblemente rápida de crear, rastrear e implementar sus modelos!
- Gestiona más de 350 RPS en solo 1 vCPU, sin necesidad de ajustes
- Listo para la producción con soporte empresarial completo
Qué es el servidor MCP de Notion
El servidor MCP de Notion es un servidor remoto del Model Context Protocol para Notion. MCP es el estándar abierto que permite a un agente descubrir e invocar herramientas en un sistema externo; la implementación de Notion expone la búsqueda en el espacio de trabajo, la lectura y escritura de páginas y bases de datos, y los comentarios como herramientas invocables.
La documentación de TrueFoundry describe su alcance funcional como buscar, obtener, crear y actualizar páginas, bases de datos y comentarios, con herramientas nombradas bajo la convención notion-* (notion-search, notion-fetch, notion-create-pages, notion-update-page). Agrupadas por capacidad:
Esa pestaña de Resources es importante: la mayoría de los servidores MCP solo exponen herramientas, por lo que Resources constituye una segunda ruta de recuperación que resulta fácil pasar por alto al auditar a qué puede acceder un agente.
Al ser un servidor remoto, no hay ningún contenedor que ejecutar ni ningún proceso npx por portátil: basta con apuntar un cliente a una URL y autenticarse, el patrón que ahora es estándar en todos los servidores MCP remotos.
Qué hacen realmente los agentes con él
Los usos más valiosos encadenan herramientas y se apoyan en la búsqueda porque el contenido de Notion es no estructurado por naturaleza:
- Responder desde la wiki. Ejecutar notion-search sobre una pregunta, obtener las tres páginas más relevantes y responder incluyendo citas que remitan a las URL de las páginas.
- Resumen de notas de reuniones. Buscar páginas de notas de las últimas dos semanas, obtener cada una incluyendo las discusiones, extraer los elementos de acción y crear una única página de resumen con los responsables asignados.
- Redacción de especificaciones. Obtener un borrador de producto (product brief), extraer las entradas vinculadas de la base de datos de investigación, redactar una especificación como una página nueva y comentar en el borrador con un enlace.
- Mantenimiento de proyectos. Consultar en una base de datos de proyectos los campos de estado obsoletos, obtener la página de cada proyecto y publicar un comentario pidiendo una actualización al responsable.
La separación entre lectura y escritura es más marcada aquí que en la mayoría de las herramientas. Las lecturas son el objetivo principal: la recuperación de información es el motivo por el cual lo conectas. Las escrituras son convenientes pero rara vez fundamentales, y son las que pueden sobrescribir una página en la que una persona ha trabajado durante una semana. Por suerte, las herramientas de Notion ya vienen etiquetadas como Read-only (solo lectura) o Destructive (destructivas), por lo que la pestaña Tools te indica cuál es cuál sin necesidad de inspeccionarlas.
Por qué conectarlo directamente falla a escala de equipo
El perfil de riesgo de Notion difiere del de un repositorio de código. El fallo peligroso no es que un agente reescriba maliciosamente una página, sino que un agente lea de forma legítima mucho más de lo que nadie pretendía.
La herencia de permisos hace que el alcance sea invisible. El acceso en Notion tiene forma de árbol de páginas: si otorgas acceso a una página principal, la concesión fluye hacia abajo a cada página hija, nieta y base de datos que contenga. Cuando alguien comparte "la wiki de Ingeniería" con una integración, se está imaginando la página de inicio. Lo que realmente ha concedido es todo lo que se ha acumulado bajo ese nodo a lo largo de tres años, incluida la página de planificación de salarios que un mánager anidó allí con prisas. Nadie pretende dar datos de RR. HH. a un agente; la herencia lo hace por ellos.
El consentimiento a nivel de espacio de trabajo es demasiado general. La pantalla de OAuth de Notion te pide elegir un espacio de trabajo y luego muestra las categorías concedidas: acceso a páginas y bases de datos, búsqueda, usuarios del espacio de trabajo. Nunca te pide enumerar páginas. La unidad de consentimiento es mucho mayor que la unidad de necesidad, por lo que el valor predeterminado real es "el agente puede ver mucho", a menos que algo lo restrinja.
La búsqueda lo amplifica. Una concesión demasiado amplia sería llevadera si un agente tuviera que adivinar las URL de las páginas. No tiene que hacerlo. notion-search es una herramienta de descubrimiento: apunta un agente a un espacio de trabajo y encontrará las páginas confidenciales, porque ese es su trabajo. La calidad de la recuperación y el radio de impacto escalan juntos.
Nadie puede reconstruir lo que se leyó. Notion registra la actividad de la API. Lo que no registra es que tu agente interno de soporte buscó "indemnización" mientras respondía a una pregunta en un hilo de Slack. Las lecturas son la superficie de riesgo, y son lo que menos probabilidades tiene de ser detectado a posteriori.
Nada de esto es un motivo para omitir el servidor MCP de Notion. Es un motivo para colocar un plano de control frente a él: precisamente para lo que existe un gateway MCP.
Conectar el servidor MCP de Notion a través de TrueFoundry
En TrueFoundry, Notion es un TrueFoundry Managed MCP. TrueFoundry publica definiciones de servidores verificadas por la plataforma en un catálogo gestionado; para aprovisionar uno solo debes proporcionar un Name (Nombre), y la plataforma se encarga de cada URL, detalle de autenticación, alcance y credencial, manteniéndolos actualizados a medida que el proveedor original los modifica.
Paso 1 — Abre el catálogo. Ve a MCP Servers en la barra lateral, haz clic en Add new MCP Server y selecciona Connect TrueFoundry Managed MCPs. Busca notion —catalogado como "Notion is a collaboration and productivity tool"— y haz clic en + Add. TrueFoundry registra el servidor y abre su página de detalles.

Catálogo de MCP gestionados de TrueFoundry con la tarjeta de Notion destacada entre los servidores MCP disponibles y verificados por la plataforma
Ese es todo el proceso de registro: sin URL que pegar, sin integración de Notion que crear y sin secreto de cliente (client secret) que almacenar.
Paso 2 — Inicia la conexión. La pestaña Tools se abre con el mensaje "You're not connected to this MCP Server". Haz clic en Connect Now para iniciar la autorización OAuth2; la página de detalles muestra el tipo de autenticación antes de que hagas clic en nada.

Paso 3 — Aprueba en el gateway. Aparecerá la ventana emergente "Connect via TrueFoundry AI Gateway" mostrando la URL del MCP Gateway, la URL de redirección y los servidores que se van a autorizar. Revísala y haz clic en Approve. A continuación se te redirigirá a cada servidor MCP en secuencia (algo útil de saber si estás autorizando varios a la vez, porque el flujo es una cadena en lugar de un único paso).

Paso 4 — Autoriza tu espacio de trabajo de Notion. Se abrirá la pantalla de consentimiento de Notion. Selecciona el espacio de trabajo, revisa el acceso que se va a conceder (acceso a páginas y bases de datos, búsqueda, usuarios del espacio de trabajo), confirma que confías en la URL de redirección y haz clic en Continue.

Lee esta pantalla despacio: aquí es donde el problema de la herencia se convierte en una decisión. Quien haga clic en Continue está eligiendo qué parte del espacio de trabajo podrá buscar un agente.
Paso 5 — Verifica las herramientas. La pestaña Tools se completará con las herramientas de Notion, cada una con una descripción, un botón Try (Probar) y una etiqueta Read-only o Destructive. Los recursos (Resources) aparecen en su propia pestaña.

Cómo funciona realmente la autenticación
TrueFoundry separa la autenticación entrante (inbound, cómo un cliente se autentica ante el gateway) de la saliente (outbound, cómo el gateway se autentica ante Notion). Las capas son independientes, y esa distinción es lo que permite limitar el alcance por usuario.

Entrante — cuatro métodos compatibles:
Hay una advertencia que importa más en Notion que en casi cualquier otro servidor: los tokens de cuenta virtual (Virtual Account tokens) dan a cada solicitud exactamente el mismo acceso. Eso no sirve para limitar el alcance por usuario: un token compartido significa que todos los agentes ven la misma unión de páginas, exactamente el modo de fallo que estás intentando evitar. Utiliza un PAT o un token de IdP de forma entrante para que la identidad se conserve hasta el salto saliente.
Saliente — Notion utiliza OAuth2. Cada usuario autoriza su propio espacio de trabajo, y TrueFoundry gestiona el consentimiento, el almacenamiento de tokens y la renovación, inyectando el token correcto por usuario en cada llamada a una herramienta. La autorización se produce directamente entre la cuenta del usuario y su espacio de trabajo de Notion; TrueFoundry no recibe las credenciales de Notion. Para los MCP gestionados, la URI de redirección siempre es https://auth.truefoundry.com/mcp/oauth2/callback.
El efecto práctico es la clave de todo este artículo. Un agente que actúe en nombre de un ingeniero de soporte buscará las páginas que ese ingeniero puede ver; un agente que actúe en nombre de alguien de RR. HH. buscará páginas de RR. HH. Ningún token compartido contiene la unión de los accesos de todos, y cuando el acceso a Notion de alguien cambia, el alcance de su agente cambia con él, sin que nadie tenga que editar ninguna configuración. ## Delimitar las herramientas antes del despliegue
El OAuth por usuario delimita qué páginas; la gestión de herramientas delimita qué se puede hacer con ellas. Utiliza ambos.

Selectores por herramienta. Desactiva una herramienta y se omitirá por completo de tools/list: los clientes nunca la verán y no se podrá invocar. Esto no es un filtrado a nivel de prompt; la herramienta no está disponible. Para un agente de conocimiento de Notion, la configuración habitual deja activadas search y fetch y desactiva todas las herramientas de escritura. Un agente sin notion-update-page no puede ser manipulado para sobrescribir una página, al margen de lo que diga el cuerpo de una página alterada.
Enable new tools by default. En On, las herramientas que Notion lance más adelante aparecerán automáticamente. En Off, solo estarán disponibles las herramientas que hayas activado explícitamente y las nuevas permanecerán ocultas hasta que las apruebes. Para un servidor que se conecta a toda tu wiki interna, Off es la opción predeterminada correcta: el aumento de capacidades debe ser una decisión consciente.
Bulk Action. Cambia cada fila a casillas de verificación con Select all: el camino rápido para tener un servidor de Notion en modo solo lectura: seleccionar todo, desmarcar search y fetch, y guardar.
Haz clic en el icono del lápiz en cualquier herramienta para abrir Edit Tool. La anulación de la descripción (Description, de hasta 20.000 caracteres) orienta la selección de herramientas, lo que resulta útil para indicar a un modelo qué ruta de recuperación preferir, dado que Notion ofrece tanto búsqueda como Resources. Las anotaciones de herramientas MCP (MCP Tool Annotations) definen readOnlyHint o destructiveHint para los clientes que las respeten. Las herramientas de Notion ya vienen anotadas, por lo que estarás confirmando más que creando; aun así, confírmalas, porque las políticas de aprobación que se detallan a continuación se basan exactamente en esas anotaciones.
Quién puede hacer qué: roles de colaboradores
El control de acceso se asigna a usuarios, equipos o cuentas virtuales en dos dimensiones: a qué servidores MCP puede acceder una identidad y qué herramientas dentro de un servidor puede invocar. Añade colaboradores desde la configuración del servidor y asigna un rol:

Para Notion, la división útil es que quien decide qué puede hacer un agente en la wiki no suele ser quien posee su contenido: un equipo de plataforma tiene el rol de Manager, los equipos funcionales tienen el rol de User y un responsable de conocimiento o cumplimiento tiene el rol de Approver. El mismo modelo de control de acceso a MCP que en cualquier otro servidor de tu registro.
Aprobación humana para herramientas destructivas
Desactivar las escrituras es una medida contundente. A veces sí quieres que un agente cree una página de especificaciones o actualice una base de datos de proyectos, solo que no sin supervisión. Cuando se invoca una herramienta restringida a través del gateway, la llamada se retiene en lugar de ejecutarse, se crea una solicitud y se notifica a los aprobadores. Una vez aprobada, la misma llamada del mismo solicitante se ejecuta con éxito hasta que la concesión expira.
Crea una política en AI Gateway → Policies → MCP Tool Approval (marcada como Beta en la consola). Cada política indica los servidores que restringe y elige un alcance de aprobación (approval scope):
Dado que las herramientas de Notion vienen preanotadas, approval_scope: destructive resulta especialmente eficaz aquí: restringe toda la clase de escritura sin necesidad de enumerar los nombres de las herramientas, y sigue funcionando si Notion añade otra herramienta de escritura. Cuando los alcances se superponen, prevalece el más específico: named > destructive > all.
La validez (Validity) puede ser Once (una sola ejecución) o basarse en tiempo (una duración en minutos). Cuando hay conflicto entre políticas, prevalece la más restrictiva: Once supera a una ventana de 10 minutos, que a su vez supera a una de 30 minutos. Se notifica a los aprobadores por correo electrónico, Slack, PagerDuty o MS Teams, y estos revisan las solicitudes en la consola:

Cada solicitud muestra la herramienta, la política, el solicitante y los argumentos reales, de modo que un aprobador ve qué página quiere actualizar un agente antes de dar su visto bueno. Mientras está pendiente, quien realizó la llamada recibe un resultado JSON-RPC con _meta.approval_status: "pending" en lugar de un error, por lo que un agente bien diseñado espera y vuelve a intentarlo. Las autorizaciones son por solicitante, y una denegación no bloquea a nadie de forma permanente: la siguiente llamada genera una nueva solicitud. Para bloquear el acceso de forma duradera, desactiva la herramienta o elimina al usuario.
Pruebas en el Tool Playground
Prueba las herramientas manualmente primero. Haz clic en Try junto a cualquier herramienta en la página de detalles del servidor. Para notion-fetch, introduce el Id (o URL) de la página o fuente de datos, opcionalmente activa Include transcript o Include discussions, haz clic en Execute Tool y lee el JSON en el panel derecho. El botón Try está desactivado para las herramientas que hayas desactivado.

En Notion, el playground también sirve como la auditoría directa más rápida de tu alcance. Ejecuta notion-search con un término que esperaras que fuera privado (un rango salarial, un nombre en clave no anunciado) y observa qué devuelve tu autorización. Si devuelve algo sorprendente, tu árbol de herencia es más amplio de lo que pensabas, y es mucho mejor enterarse aquí que a través de una transcripción del agente.
Uso desde tu IDE
TrueFoundry expone el servidor a través del transporte HTTP. Abre la pestaña How To Use para obtener la URL del Gateway específica de tu entorno (tenant) y fragmentos de código listos para copiar y pegar.

Cubre Cursor, VS Code, Claude Code, Claude Web, Claude Desktop, Windsurf, Codex y los SDK de MCP para Python y TypeScript. Show API Key muestra la clave si tu cliente la necesita como cabecera. Copia la URL de esta pestaña en lugar de construirla tú mismo: es específica de tu tenant, y un punto de enlace (endpoint) creado a mano es la causa más común de que un cliente se conecte pero no liste ninguna herramienta.
Qué obtienes una vez que está detrás del gateway
Métricas por herramienta. La pestaña Tool Metrics muestra el recuento de invocaciones, la distribución de latencia y las tasas de error por herramienta: así es como descubres que un agente llama a notion-search cuarenta veces por conversación, o que notion-fetch da error en tus bases de datos más grandes.
Observabilidad completa de solicitudes. Cada invocación se rastrea con el usuario que realiza la llamada, el nombre de la herramienta, los datos de entrada (payload) y la latencia, exportándose mediante OpenTelemetry a Grafana, Datadog o Prometheus. En un servidor con alta carga de lectura esto es fundamental: es la única forma de responder a "¿qué leyó el agente y para quién?".
Barreras de seguridad (Guardrails). Los hooks se ejecutan en mcp_pre_tool (antes de la invocación) y mcp_post_tool (después de que esta devuelva un resultado), aplicando la política de contenido en la solicitud y en la respuesta. En un servidor de wiki, el hook posterior a la herramienta demuestra su valor: detecta una credencial o una cifra salarial en una página devuelta antes de que llegue al modelo.
Baja sobrecarga. El gateway añade aproximadamente 3–4 ms de latencia y gestiona más de 350 RPS en un solo vCPU, por lo que se sitúa en la ruta crítica sin convertirse en un cuello de botella.
Un solo registro. Una vez registrados varios servidores, un Virtual MCP Server agrupa un conjunto seleccionado de herramientas de varios de ellos detrás de un único endpoint, de modo que un agente de investigación obtiene la búsqueda de Notion junto con el historial de Slack y nada que permita escribir.
Revocar el acceso
Los administradores del entorno (tenant admins) pueden eliminar todas las credenciales almacenadas desde el menú de tres puntos situado junto a Edit. Revoke all tokens elimina todas las anulaciones de autenticación y los tokens OAuth almacenados para todos los usuarios y cuentas virtuales de ese servidor; la medida surte efecto en la siguiente solicitud y queda registrada en los Activity Logs. Es irreversible: todos los usuarios deberán volver a pasar por el proceso de consentimiento OAuth después.
Hay una limitación importante: esto elimina los tokens únicamente del gateway. No revoca la concesión dentro de Notion, por lo que en un incidente real debes eliminar también la conexión en la configuración del espacio de trabajo de Notion. Solo los administradores del entorno ven esta acción; los MCP Server Managers no la ven.
Detalles importantes a tener en cuenta
La herencia lo es todo. Antes de conectar, revisa las páginas del nivel superior a las que puede acceder la cuenta que autoriza y pregúntate qué se ha acumulado debajo de cada una. La concesión no es la página que te estás imaginando; es todo el subárbol.
Resources es una segunda puerta. Notion expone los MCP Resources en una pestaña independiente, por lo que una auditoría que solo cubra la pestaña Tools estará incompleta. Revisa ambas.
No utilices un token compartido para una wiki compartida. Conectar una sola vez con una identidad de servicio requiere menos configuración, pero borra todos los límites por usuario y los reemplaza por la unión de todo lo que esa identidad puede ver. El OAuth por usuario requiere más clics, pero es estrictamente mejor.
Lecturas relacionadas
- Qué es un MCP Gateway: arquitectura y casos de uso — la introducción arquitectónica en la que se basa este artículo
- Control de acceso a MCP: cómo proteger agentes de IA con un MCP Gateway — cómo funcionan los permisos a nivel de herramienta y de servidor
- MCP Authentication Explained — el modelo de auth entrante y saliente
- Virtual MCP Server Explained — agrupar varios servidores en un solo endpoint
- MCP Server Security Best Practices — la lista de verificación de hardening más amplia
Conclusion
Notion es lo más útil que le puedes dar a un agente y lo más difícil de delimitar, exactamente por la misma razón: es donde termina todo. El riesgo no es que un agente reescriba una página, sino que los permisos heredados del árbol de páginas entreguen silenciosamente a una herramienta de búsqueda un corpus más grande del que cualquiera consintió, y la búsqueda es muy buena encontrando las partes interesantes de un corpus grande.
OAuth por usuario resuelve eso: hace que el alcance del agente sea función de la persona para la que actúa, no una configuración que alguien estableció una vez. Ejecutar Notion como un MCP gestionado en TrueFoundry añade el resto: conmutadores por herramienta en lugar de acceso de todo o nada, puertas de aprobación en las escrituras, guardrails en las peticiones y respuestas, y un registro trazado de cada lectura.
TrueFoundry AI Gateway ofrece una latencia de entre 3 y 4 ms, gestiona más de 350 RPS en una vCPU, se escala horizontalmente con facilidad y está listo para la producción, mientras que LitellM presenta una latencia alta, tiene dificultades para superar un RPS moderado, carece de escalado integrado y es ideal para cargas de trabajo ligeras o de prototipos.



Controle, implemente y rastree la IA en su propia infraestructura
Blogs recientes
Preguntas frecuentes
¿Qué es el servidor MCP de Notion?
Un servidor remoto de Model Context Protocol para Notion que expone un workspace como herramientas invocables: buscar, obtener páginas y bases de datos, crear y actualizar páginas, y leer y publicar comentarios. Los agentes se conectan mediante una URL y se autorizan con OAuth2 en lugar de ejecutar nada en local. Notion también expone MCP Resources como una primitiva independiente.
¿Qué herramientas expone el servidor MCP de Notion?
Búsqueda, obtención de contenido, creación y actualización de páginas, lecturas y escrituras en bases de datos, y comentarios, con nombres que siguen la convención notion-*, como notion-search, notion-fetch, notion-create-pages y notion-update-page. La lista completa aparece en la pestaña Tools una vez autorizado; cada herramienta lleva la etiqueta Read-only o Destructive y se configura de forma individual.
¿Es seguro usar el servidor MCP de Notion en una empresa?
Sí, con un alcance bien definido, y la cuestión es la amplitud de lectura, no las escrituras maliciosas. Los permisos de Notion se heredan hacia abajo en los árboles de páginas, por lo que una sola concesión puede exponer mucho más de lo previsto. Ejecútelo detrás de un gateway que aplique OAuth por usuario en lugar de un token de integración compartido, desactive las herramientas de escritura que un agente no necesite, condicione el resto a una aprobación humana y trace cada llamada junto con el usuario que la realiza.
¿Puedo desplegar TrueFoundry en mi propia VPC o en on-prem?
Sí. TrueFoundry se ejecuta en su VPC, on-prem, en entornos air-gapped o híbridos, de modo que los prompts y las respuestas nunca salen de su dominio, incluso cuando enruta entre muchos proveedores.
¿Admite TrueFoundry MCP y agentes de IA en general?
Sí. Incluye un MCP Gateway, un Agent Gateway y un MCP & Agents Registry con control de acceso a nivel de herramienta. Los agentes creados con LangGraph, CrewAI, AutoGen o un framework propio pueden gobernarse de forma centralizada.
¿Se integra con mi pila de observabilidad existente?
Sí. La pasarela es compatible con OpenTelemetry y se integra con Grafana, Datadog, Prometheus o tu pila preferida. Rastrea cada solicitud desde la instrucción (prompt) hasta la ejecución de la herramienta y el modelo, así obtienes un registro unificado sin tener que reemplazar lo que ya tienes en funcionamiento.











.webp)





.webp)
.webp)
.png)

.png)
.png)
.png)
.png)
.png)
.webp)
.webp)






