Notion MCP: la guía completa para conectar la IA a tu espacio de trabajo

¿Qué es Notion MCP?

MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA utilizar herramientas y fuentes de datos externas. Notion MCP es la implementación oficial de este estándar, alojada por Notion: un servidor que actúa como intermediario entre tu herramienta de IA y tu espacio de trabajo y ofrece acceso a Notion mediante un conjunto de herramientas tipadas —buscar, leer páginas, editar páginas, consultar bases de datos— en lugar de una API en bruto que el agente tendría que aprender a utilizar por su cuenta.

En la práctica, la diferencia con el antiguo flujo de trabajo basado en tokens de integración es abismal. Te autenticas una sola vez mediante OAuth, el agente descubre automáticamente las herramientas disponibles y el contenido de las páginas se transmite en markdown, un formato más fácil de procesar para los modelos y mucho más económico en tokens que el JSON de bloques de Notion.

Servidor alojado frente a servidor autoalojado

Hay dos formas oficiales de ejecutarlo, y una opción claramente preferible por defecto:

Utiliza el servidor alojado, salvo que necesites específicamente limitar el acceso a solo lectura o una configuración aislada de la red. Notion ha afirmado claramente que el proyecto de código abierto notion-mcp-server en GitHub ya no es la prioridad y podría retirarse.

Configuración: Claude Code, Claude Desktop, Cursor, ChatGPT

Claude Code (un comando)

claude mcp add --transport http notion https://mcp.notion.com/mcp

La próxima vez que lo ejecutes, Claude Code abrirá el flujo de OAuth; autoriza el acceso y las herramientas de Notion aparecerán automáticamente.

Claude Desktop

Configuración → Conectores → añade Notion desde el directorio (un clic), o añade un conector personalizado con la URL https://mcp.notion.com/mcp.

Cursor

Añade lo siguiente a .cursor/mcp.json (proyecto) o a la configuración global de MCP:

{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" }
  }
}

ChatGPT y otras herramientas

Cualquier herramienta que pueda actuar como cliente MCP puede conectarse; ChatGPT lo admite mediante conectores. Las herramientas sin compatibilidad con MCP no pueden utilizar Notion MCP en absoluto, lo que constituye la razón más habitual por la que una configuración «no funciona».

Variante autoalojada

Crea una integración interna en notion.so/profile/integrations, concédele acceso a las páginas concretas que quieras hacer accesibles y ejecuta el servidor con tu token:

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_****" }
    }
  }
}

Qué pueden hacer realmente los agentes

• Buscar en tus páginas y en el contenido conectado: el agente encuentra el contexto sin que tengas que pegarlo.
• Leer páginas en markdown: todo el contenido de una página en una sola llamada, con un uso eficiente de tokens, incluidas las transcripciones de notas de reuniones.
• Escribir y editar: crear páginas, sobrescribir contenido o realizar cambios concretos mediante búsquedas y reemplazos.
• Trabajar con bases de datos: consultar fuentes de datos con filtros y criterios de ordenación, actualizar propiedades y crear entradas.
• Mover y organizar: cambiar la página de la que dependen otras páginas y gestionar la estructura.

En la práctica, esto cubre todo el ciclo de una wiki con LLM: el agente incorpora fuentes, guarda resúmenes en Notion, enlaza páginas entre sí y responde preguntas a partir de lo que ya ha construido. Usamos esta misma configuración a diario: encontrarás instrucciones listas para copiar y pegar en Claude Code + Notion: cinco flujos de trabajo, y el proceso completo de creación, con sus limitaciones explicadas sin rodeos, en Wiki con LLM para Notion.

Seguridad y permisos

• Tus permisos marcan el límite máximo. Un agente conectado mediante Notion MCP puede acceder exactamente a lo mismo que tu cuenta, nada más, y no puede eludir los permisos de cada página.
• El límite mínimo lo decides tú. El servidor alojado siempre actúa con todos tus permisos de acceso, así que piénsalo antes de conectar un agente experimental a un espacio de trabajo con datos sensibles. Para un acceso de solo lectura, utiliza el servidor autoalojado con un token de integración que solo tenga el permiso «Leer contenido».
• Controles de Enterprise. Los administradores de espacios de trabajo con el plan Enterprise pueden activar la gobernanza de MCP: una lista de aplicaciones de IA aprobadas, auditoría de conexiones y un control para desconectarlas todas.
• Los datos se transmiten al modelo. Todo lo que lee el agente pasa a formar parte de su contexto: considera la política de datos de la propia herramienta de IA como parte de tu perímetro de seguridad.

El mapa que falta: lo que MCP no te ofrece

MCP le da manos a un agente: buscar, leer, escribir. No le da ojos. Cada consulta es como mirar por el ojo de una cerradura: el agente ve las páginas que ha recuperado en ese turno, no la estructura del espacio de trabajo: qué páginas son centros de conexión, qué grupos existen o dónde están las páginas huérfanas. Es un problema de grafos, no de recuperación de información.

Esta es precisamente la capa que IVGraph añade a una configuración de Notion + MCP: el espacio de trabajo representado como un grafo de conocimiento 3D interactivo para ti, y esa misma estructura accesible de forma programática para los agentes mediante la API LLM de IVGraph, con búsquedas, vecindarios de nodos y las rutas más cortas entre páginas. El agente edita mediante MCP; el grafo os muestra a ambos cómo es realmente el espacio de trabajo.

Preguntas frecuentes