Notion mantiene en developers.notion.com/prompts/setup una guía oficial pensada para que la lea un agente de IA, no una persona: le explica cómo usar el servidor MCP de Notion como memoria compartida y duradera entre distintos asistentes. La versión vigente, la 0.0.4, figura con fecha del 13/10/2026 y da por hecho que la conexión con Notion ya está creada.
Las claves de la guía de Notion para agentes en 30 segundos
- La página es un conjunto de instrucciones para agentes, no un manual de instalación: no incluye JSON, OAuth ni planes.
- La conexión se hace con el servidor MCP alojado de Notion, en mcp.notion.com/mcp, disponible en todos los planes.
- Outline y Docmost integran ya su propio servidor MCP; AFFiNE depende de uno de la comunidad.
- Notion pide tratar como no fiable el contenido que devuelven las herramientas, por el riesgo de inyección de prompts.
El nombre de la página induce a confusión. Quien llegue esperando una lista de prompts para copiar o un asistente de configuración para Claude o Cursor encontrará otra cosa: un documento que se comparte con el agente para que este siga los pasos por su cuenta. Notion lo presenta como una guía oficial de configuración «para agentes» y plantea un reparto de papeles claro. El agente aporta la inteligencia activa y Notion guarda el estado duradero, de forma que el contexto no quede encerrado en un chat o en un producto concreto.
Qué propone Notion y cómo se conecta un agente
La guía describe una configuración inicial que se hace una sola vez. El agente revisa el espacio de trabajo existente, ofrece importar memorias guardadas, artefactos recientes y las habilidades personales que lo admitan, y crea una página privada llamada Agent Operating Guide. Después propone un bloque de texto para pegar en las instrucciones personalizadas de la plataforma que use cada uno (ChatGPT y Claude aparecen como ejemplos), con un enlace a esa página. Se completa con una rutina diaria que importa memorias nuevas y comprueba si hay una versión más reciente de la guía, además de normas sobre cuándo leer, escribir, crear, resolver conflictos, olvidar y verificar información. Como extensión opcional, desactivada salvo aprobación expresa, sugiere una base de datos con el inventario de agentes.
Todo eso necesita una conexión previa con el servidor MCP (Model Context Protocol, el protocolo abierto que permite a un asistente de IA usar herramientas y datos externos). Si falta o es de solo lectura, la guía indica al agente que lo comunique. La página no detalla cómo crear esa conexión, ni planes, ni permisos; eso está en la documentación de desarrolladores de Notion.
El servidor MCP alojado de Notion
Notion recomienda su servidor alojado, con transporte Streamable HTTP en https://mcp.notion.com/mcp y una alternativa SSE (Server-Sent Events) en https://mcp.notion.com/sse para los clientes que no admiten el primero. La mayoría de clientes abren un flujo OAuth (el estándar de autorización delegada) para que el usuario dé acceso a su espacio de trabajo. En los planes Business y Enterprise, el propietario del espacio puede crear además un token MCP en el portal de desarrolladores, que el cliente envía como token bearer sin pasar por el navegador.
Según la documentación, el MCP de Notion funciona en todos los planes, pero con matices: la búsqueda en fuentes conectadas y las consultas SQL ilimitadas a bases de datos exigen Business o Enterprise con Notion AI, los límites de peticiones son mayores en esos planes y los invitados del espacio no pueden conectarse. Entre los clientes citados están Claude Code, Codex, Cursor, VS Code con GitHub Copilot y Devin. En Claude Code basta con un comando:
claude mcp add --transport http notion https://mcp.notion.com/mcpPara Cursor, la configuración documentada en .cursor/mcp.json es esta:
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}Los clientes que solo admiten servidores locales por stdio pueden usar el paquete mcp-remote como puente, también según la documentación oficial:
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
}
}
}Existe también un servidor de código abierto, makenotion/notion-mcp-server, publicado en npm como @notionhq/notion-mcp-server y basado en un token de integración. Notion advierte de que ya no se mantiene de forma activa y lo considera un último recurso frente al servidor alojado.
Alternativas de código abierto con servidor MCP
El esquema de Notion se puede reproducir fuera de su plataforma con tres piezas: una herramienta de documentación que exponga un servidor MCP, un cliente compatible (Claude Desktop, Claude Code, Cursor u otro) y una página que haga de guía de operación para el agente, enlazada desde sus instrucciones personalizadas. La diferencia está en la licencia, en si el servidor MCP es oficial y en si se puede autoalojar.
| Herramienta | Licencia | MCP o API | Autoalojable |
|---|---|---|---|
| Outline | BSL 1.1 (no reconocida por la OSI) | MCP oficial integrado en /mcp | Sí |
| Docmost | AGPL-3.0 | MCP oficial integrado, con licencia Business o Enterprise | Sí |
| AFFiNE | MIT, salvo el backend, con licencia propia | MCP de la comunidad (affine-mcp-server) | Sí |
| AppFlowy | AGPL-3.0 | Sin MCP oficial verificado | Sí |
Outline: MCP integrado, pero sin licencia OSI
Outline incorpora un servidor MCP en cada espacio de trabajo desde febrero de 2026, según su registro de cambios. Un administrador lo activa en los ajustes de IA y queda en la ruta /mcp del dominio, tanto en la nube como en una instalación propia. Admite OAuth y claves de API enviadas como token bearer. Hay un matiz importante: su código se publica bajo la Business Source License 1.1, que permite usarlo y modificarlo con restricciones, pero no es una licencia de código abierto aprobada por la OSI (Open Source Initiative). La configuración para Cursor sigue el mismo patrón que la de Notion:
{
"mcpServers": {
"outline": {
"url": "https://TU-SUBDOMINIO.getoutline.com/mcp"
}
}
}Docmost: AGPL, con el MCP como función de pago
Docmost publica su código bajo AGPL-3.0 (GNU Affero General Public License, que obliga a compartir las modificaciones también cuando el software se ofrece como servicio en red). Su servidor MCP está en https://TU-DOMINIO/mcp y lo activa un administrador en los ajustes de IA, pero la propia documentación aclara que requiere una licencia Business o Enterprise válida. El método principal es OAuth; para clientes sin OAuth acepta claves de API. Este es el ejemplo documentado con clave:
{
"mcpServers": {
"docmost": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://YOUR_DOCMOST_URL.com/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}AFFiNE y AppFlowy: el papel de la comunidad
El repositorio de AFFiNE usa la licencia MIT para la mayor parte del código, aunque el directorio del backend tiene una licencia propia. No ofrece un MCP oficial, pero el proyecto comunitario affine-mcp-server (licencia MIT, versión 3.11.0 en npm) funciona con AFFiNE Cloud y con instancias autoalojadas, por stdio o HTTP, y también se distribuye como imagen Docker. Se instala con npm i -g affine-mcp-server y, para Claude Desktop, su documentación propone:
{
"mcpServers": {
"affine": {
"command": "affine-mcp",
"env": {
"AFFINE_BASE_URL": "https://app.affine.pro",
"AFFINE_COOKIE": "your-complete-cookie-request-header"
}
}
}
}El propio proyecto avisa de que solo accede a espacios guardados en servidor, no a los que viven únicamente en el almacenamiento local del navegador. AppFlowy, con licencia AGPL-3.0 y opción de autoalojamiento, no tiene un servidor MCP oficial que se haya podido verificar para este artículo; quien opte por un desarrollo de terceros debería revisar su código antes de darle acceso. Obsidian, que aparece a menudo en estas comparativas, no es software de código abierto.
Para replicar la parte de «prompts» basta con crear en cualquiera de estas herramientas una página con las normas de lectura y escritura que debe seguir el agente y enlazarla desde las instrucciones personalizadas del cliente, igual que hace Notion con su Agent Operating Guide. La guía de Notion está escrita para su MCP y menciona herramientas propias como notion-get-enabled-skills, así que no sirve tal cual en otras plataformas.
Permisos mínimos e inyección de prompts
Un cliente conectado puede llegar, a través del MCP, a todo lo que puede ver la cuenta del usuario. Por eso Notion recomienda revisar los permisos de cada cliente y herramienta, conectar solo clientes de confianza y comprobar la URL del servidor antes de instalar nada desde un mercado de terceros. También pide activar la confirmación antes de cualquier acción que cambie contenido y vigilar que el cliente no envíe datos de Notion a sistemas externos. En los espacios Enterprise, los propietarios pueden restringir qué clientes conectan los miembros y revocar conexiones mediante la API (interfaz de programación de aplicaciones) de administración.
El riesgo más delicado es la inyección de prompts: una página o un comentario pueden esconder instrucciones que intenten cambiar el comportamiento del agente. Notion lo resume en una regla: tratar como no fiable el contenido que devuelven las herramientas. En las alternativas autoalojadas conviene aplicar lo mismo, usar claves de API dedicadas con el menor alcance posible y, cuando el servidor lo permita, limitar las herramientas expuestas; affine-mcp-server documenta una configuración de exposición mínima de herramientas. noticias.ai ya ha analizado por qué MCP exige más criterio para llevarlo a producción y cómo se producen las fugas de datos con IA generativa en la empresa.
Preguntas frecuentes
¿Qué es developers.notion.com/prompts/setup?
Es una guía oficial de Notion dirigida a agentes de IA para que usen Notion como memoria compartida a través de su servidor MCP. No explica cómo instalar el servidor; da por hecho que la conexión ya existe.
¿Hace falta un plan de pago para usar el MCP de Notion?
No. Según Notion funciona en todos los planes, aunque los tokens MCP, las consultas SQL ilimitadas y la búsqueda en fuentes conectadas exigen Business o Enterprise.
¿Qué alternativa de código abierto tiene MCP oficial?
Docmost, con licencia AGPL-3.0, integra un servidor MCP oficial, pero requiere licencia Business o Enterprise. Outline también lo integra, aunque su licencia BSL 1.1 no está reconocida por la OSI.
¿Sigue siendo recomendable el servidor makenotion/notion-mcp-server?
Notion indica que ya no se mantiene de forma activa y lo reserva como último recurso. Recomienda el servidor alojado en mcp.notion.com.
Fuentes:
