Todos los artículos
AFFiNE
Toeverything·Publicado 20 ago 2026
Un panel de texto y un panel de lienzo conectados al mismo puerto MCP

Notion MCP: cómo funciona, conexión y límites (2026)

Lo esencial en 30 segundos

  • Notion MCP es el servidor MCP oficial de Notion: conectado una vez, Claude, ChatGPT y Cursor pueden buscar en tus páginas, consultar tus bases de datos y —donde lo permitas— crear páginas.
  • La conexión usa OAuth y toma unos minutos; no hay clave de API que copiar, sino una autorización con tu cuenta de Notion.
  • Dos límites son estructurales: el servidor oficial actual es solo alojado (sin autoalojamiento), y lo visual —pizarras, diagramas— no existe en el modelo de datos de Notion.
  • Si las decisiones de tu equipo también viven en pizarras, o el autoalojamiento no es negociable, el servidor MCP integrado de AFFiNE cubre más terreno (tabla comparativa más abajo).

Esta guía repasa qué puede hacer Notion MCP en la práctica, cómo conectarlo cliente por cliente, los límites que sorprenden y los casos donde conviene otro servidor. Si MCP todavía te suena abstracto, empieza por qué es un servidor MCP.

Qué es Notion MCP

Notion MCP es el servidor oficial alojado por Notion. En lugar de que cada aplicación de IA escriba su propia integración, expone las capacidades del workspace como herramientas tipadas que cualquier cliente MCP puede llamar: buscar páginas, leer contenido, consultar bases de datos y crear o actualizar páginas con todos los permisos del usuario de Notion que complete OAuth.

Dos premisas antes de conectar:

  • Lo aloja Notion. La autorización pasa por tu cuenta de Notion y el servidor corre en la infraestructura de Notion. Operar tú mismo el servidor oficial actual no está previsto; existió un servidor open source anterior, pero está descontinuado.
  • El usuario que inicia sesión marca el límite de acceso. El servidor alojado recibe todos los permisos del usuario de Notion que completa OAuth; no aparece un selector de páginas durante la autorización. Si necesitas menos alcance, usa una cuenta dedicada con permisos reducidos.
Flujo OAuth que lleva los permisos del usuario conectado a páginas y bases de datos mediante Notion MCP
El servidor alojado actúa con los permisos del usuario que completa OAuth; no existe un selector de páginas aparte.

Qué puedes hacer con él

El valor práctico se concentra en tres usos:

  • Preguntar sobre notas reales. «¿Qué decidimos sobre el precio del onboarding?» responde desde la página de la reunión, no desde una suposición del modelo.
  • Consultar bases de datos en lenguaje natural. Filtrar tareas vencidas, resumir el pipeline comercial, listar bloqueos del lanzamiento: consultas estructuradas formuladas en español.
  • Redactar directamente en el workspace. Donde lo permitas, los asistentes crean páginas o añaden contenido: el resumen de la reunión va a la base de datos correcta y las notas de investigación, directamente a Notion.

Cómo conectarlo, cliente por cliente

El flujo oficial es similar en todos: agrega el servidor, completa OAuth en el navegador y aprueba el cliente.

  1. Claude (Desktop y claude.ai): agrega Notion desde el directorio de conectores, o apunta un conector personalizado al endpoint MCP de Notion, y autoriza en la ventana OAuth.
  2. Claude Code: se agrega por CLI con transporte HTTP; la autenticación se completa vía /mcp en el primer uso. El patrón es el mismo de agregar servidores MCP a Claude Code.
  3. Cursor: escribe el servidor de Notion en ~/.cursor/mcp.json, reinicia y autoriza.
  4. ChatGPT: los conectores admiten servidores MCP; los personalizados requieren el modo de desarrollador. La autorización es con tu cuenta de Notion.

Después prueba con una pregunta cuya respuesta conoces: «encuentra la página donde comparamos cotizaciones de proveedores y lista los finalistas». Si no aparece, verifica primero que la cuenta conectada pueda encontrarla en Notion y luego revisa los permisos de herramientas del cliente.

Permisos y límites del plan antes de conectar

La guía de seguridad de Notion es clara: el servidor MCP alojado puede actuar con todos los permisos del usuario que inicia sesión. Los administradores de Enterprise pueden aprobar o bloquear clientes MCP, pero la cuenta OAuth sigue siendo la principal frontera cotidiana. Usa una cuenta dedicada con permisos mínimos cuando necesites reducir el alcance y revoca las conexiones que ya no uses.

La búsqueda en páginas de Notion tiene disponibilidad amplia. En cambio, buscar en fuentes conectadas como Slack, Google Drive o Jira depende de Notion AI y del plan. Las herramientas disponibles también pueden variar por workspace; consulta la lista oficial de herramientas compatibles.

Límite de permisos entre la búsqueda interna de Notion y las fuentes externas sujetas a un plan de IA
Los permisos del espacio de trabajo limitan el alcance de MCP; buscar en fuentes conectadas también puede requerir un plan de Notion AI.

Los límites que sorprenden

  • Solo alojado. No hay ruta de autoalojamiento para el servidor oficial actual. Si el cumplimiento exige que la infraestructura de conocimiento viva en tus máquinas, el desacuerdo es estructural, no de configuración.
  • Texto y bases de datos, no lienzos. El modelo de datos de Notion son páginas y bases. Pizarras, diagramas, muros de notas adhesivas: el servidor no puede buscar lo que el producto no modela.
  • El servidor alojado no admite un Bearer Token de cuenta de servicio. El flujo compatible usa OAuth de usuario; la automatización desatendida necesita otro diseño de integración.
  • La búsqueda con IA más profunda es de pago. La búsqueda IA de Notion a través de aplicaciones externas pertenece a sus planes de IA; la conexión MCP da acceso a herramientas, no desbloquea esas funciones.

Nada de esto es letal para un equipo que vive en bases de datos. Pesa cuando el conocimiento es visual o cuando autoalojarse es un requisito.

Cuándo conviene AFFiNE MCP

AFFiNE resuelve el mismo problema —hacer legible el workspace para los asistentes— desde otro punto de partida: documentos y pizarras en un solo espacio, con el servidor MCP integrado tratando a ambos como ciudadanos de primera.

Notion MCPAFFiNE MCP
ServidorOficial, alojado por NotionOficial, integrado en el producto
AutoalojamientoNo previsto (servidor actual)Sí: el mismo servidor en instancias autoalojadas
PizarrasFuera del modelo de datosLa búsqueda indexa el texto del lienzo y devuelve ubicaciones de elementos y marcos
BúsquedaContenido de Notion dentro de todos los permisos del usuario; las fuentes externas requieren Notion AIPalabra clave + semántica sobre todo el workspace, según tus permisos
CredencialesOAuth de usuario; la conexión hereda sus permisos del workspacePor cliente, con caducidad y revocación inmediata, solo lectura por defecto
CostoConexión gratuitaGratis en Cloud y autoalojado con funciones de IA activadas

Comparación basada en capacidades documentadas públicamente, a agosto de 2026.

La diferencia que los equipos notan primero son las pizarras. Las decisiones rara vez viven solo en prosa: viven en el diagrama de la revisión de arquitectura, en las notas adhesivas de la retrospectiva. Un servidor que puede buscar donde ocurrió el pensamiento responde preguntas que un servidor de solo texto no alcanza. Y la configuración queda dentro del producto: Configuración → Integrations → MCP Server → Create credential → pegar el JSON generado en tu cliente.

Llevando la comparación al plano de producto, el corte honesto: equipos de operaciones centrados en bases de datos, con Notion; equipos cuyo conocimiento mezcla documentos con trabajo visual y que quizá necesiten autoalojamiento, con AFFiNE. Para la capa de acceso de IA, la tabla de arriba decide.

Preguntas frecuentes

¿Notion MCP es gratis?

Conectarlo es gratis con una cuenta de Notion, y el acceso básico a herramientas funciona en workspaces gratuitos. Las funciones de IA propias de Notion —como la búsqueda IA a través de aplicaciones conectadas— pertenecen a los planes de pago; la conexión MCP no las desbloquea.

¿Notion MCP funciona con ChatGPT?

Sí. ChatGPT admite MCP mediante conectores, con servidores personalizados en modo desarrollador. Claude, Claude Code, Cursor y Cline también se conectan: ese es justamente el punto de MCP, un servidor para todos los asistentes compatibles.

¿Puedo autoalojar Notion MCP?

No. El servidor oficial actual solo existe alojado por Notion, y el antiguo servidor open source está descontinuado. Si tu base de conocimiento accesible por IA debe correr en tu infraestructura, AFFiNE ofrece el mismo servidor MCP autoalojado que en su Cloud.

¿Notion MCP puede buscar en pizarras o diagramas?

No: el modelo de datos de Notion son páginas y bases de datos, así que no hay contenido de lienzo que buscar. El servidor MCP de AFFiNE indexa el texto del lienzo Edgeless y devuelve ubicaciones de elementos y marcos, con lo que diagramas y muros de notas también aparecen en la búsqueda.

¿En qué se diferencia Notion MCP de la API de Notion?

La API es la interfaz de programación de Notion, pensada para desarrolladores. El servidor MCP añade encima una capa estándar: las capacidades del workspace como herramientas tipadas que los asistentes descubren y llaman por sí solos. Usar MCP casi no requiere código: una autorización OAuth y un fragmento de configuración.

En resumen

Conecta el servidor que está donde realmente viven las decisiones de tu equipo. Si es en bases de datos, Notion MCP cumple bien. Si es en documentos y en la pizarra donde tomó forma el plan, dale ambos a tu asistente: se configura en minutos y no añade un cargo MCP cuando las funciones de IA están activadas.