¿Qué es el servidor MCP de Notion para Claude?

Respuesta rápida: el servidor MCP de Notion conecta Claude directamente con tu espacio de trabajo de Notion mediante el Model Context Protocol. Una vez configurado, Claude puede leer, buscar, actualizar y crear páginas de Notion con lenguaje natural. La configuración lleva menos de 20 minutos y no requiere experiencia en programación.

La integración de Notion MCP convierte a Claude, de un asistente de IA independiente, en algo realmente útil para los equipos de B2B SaaS: una IA que puede leer tu documentación real, consultar tus bases de datos y actualizar tus páginas sin que tengas que cambiar de pestaña.

Esta guía cubre la configuración completa tanto para Claude Desktop como para Claude Code, además de los flujos de trabajo prácticos de los que más provecho sacan los equipos de SaaS una vez que todo está conectado.

¿Qué es el servidor MCP de Notion?

El servidor MCP de Notion es una integración oficial creada por Notion que usa el Model Context Protocol (un estándar abierto creado por Anthropic) para dar a Claude acceso directo a tu espacio de trabajo de Notion. En lugar de copiar y pegar contenido en Claude, Claude lee y escribe directamente en Notion.

Esto importa para los equipos de B2B SaaS porque tu espacio de trabajo de Notion probablemente contiene tus especificaciones de producto, investigación de clientes, documentos de onboarding y notas de reuniones. Conectar Claude a ese contexto lo convierte en un asistente mucho más útil que uno que trabaja desde cero.

Qué puede hacer Claude una vez conectado:

• Buscar en todo tu espacio de trabajo de Notion por palabra clave o tema
• Leer el contenido completo de cualquier página a la que tenga acceso
• Consultar entradas de bases de datos y filtrarlas por propiedades
• Crear nuevas páginas y entradas de bases de datos
• Actualizar el contenido de páginas existentes
• Resumir documentos largos cuando se lo pidas

Lo que necesitas antes de empezar

Antes de configurar la integración de Claude con Notion MCP, comprueba que tienes lo siguiente:

• Claude Desktop (gratis o Pro) o Claude Code instalado
• Una cuenta de Notion (cualquier plan)
• Node.js instalado en tu equipo (versión 18 o superior)
• Acceso de administrador a tu espacio de trabajo de Notion, o permiso para crear integraciones

Si usas Claude Code en concreto, Notion también publica un plugin oficial que incluye el servidor MCP junto con comandos slash ya preparados. Esa opción se explica por separado más abajo.

Cómo configurar Notion MCP con Claude Desktop

Paso 1: crea una integración de Notion

1. Ve a notion.so/my-integrations
2. Haz clic en New integration
3. Ponle un nombre (por ejemplo, «Claude MCP»)
4. Selecciona el espacio de trabajo al que quieres que Claude acceda
5. En capacidades, activa Read content, Update content e Insert content
6. Haz clic en Save
7. Copia el Internal Integration Token que aparece. Lo necesitarás en el paso 3.

Paso 2: conecta páginas a tu integración

Las integraciones de Notion solo acceden a las páginas que compartes con ellas de forma explícita. Es una función de seguridad, no un error.

Para cada página o base de datos de Notion a la que quieras que Claude acceda:

1. Abre la página en Notion
2. Haz clic en el menú de tres puntos (arriba a la derecha)
3. Selecciona Connections
4. Busca el nombre de tu integración y haz clic en Confirm

Puedes compartir una página de nivel superior para dar a Claude acceso a todo lo que cuelga de ella.

Paso 3: configura el servidor MCP en Claude Desktop

Abre el archivo de configuración de Claude Desktop. En Mac, se encuentra en:

~/Library/Application Support/Claude/claude_desktop_config.json

En Windows:

%APPDATA%\Claude\claude_desktop_config.json

Añade lo siguiente al archivo, sustituyendo YOUR_INTEGRATION_TOKEN por el token del paso 1:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_INTEGRATION_TOKEN\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

Paso 4: Reinicia Claude Desktop

Cierra Claude Desktop por completo y vuelve a abrirlo. Cuando la aplicación cargue, deberías ver un icono de martillo en la parte inferior izquierda de la interfaz del chat. Eso confirma que el servidor MCP está activo y que Claude tiene acceso a las herramientas.

Paso 5: Prueba la conexión

Escribe esto en Claude:

"Search my Notion workspace for pages about [a topic you know exists]."

Si Claude devuelve resultados de tu espacio de trabajo, la integración funciona.

Cómo configurar Notion MCP con Claude Code

Los usuarios de Claude Code tienen una opción algo distinta (y más rápida): el plugin oficial de Notion para Claude Code.

Opción A: instala el plugin oficial de Notion

El plugin oficial (publicado en makenotion/claude-code-notion-plugin en GitHub) incluye el servidor MCP junto con skills y comandos slash ya preparados. Es la vía recomendada si usas Claude Code como interfaz principal.

Pasos de instalación:

1. Abre Claude Code
2. Ejecuta el siguiente comando en la terminal:

claude mcp add notionhq/notion-mcp-server

1. Cuando te lo pida, pega tu token de integración de Notion
2. Confirma la conexión

El plugin añade comandos slash como /notion-search, /notion-create y /notion-update directamente a tu flujo de trabajo de Claude Code.

Opción B: configuración manual mediante claude.json

Si prefieres la configuración manual o necesitas una configuración personalizada, añade el servidor MCP de Notion a tu archivo claude.json con la misma estructura JSON que se muestra en la sección de Claude Desktop más arriba.

Flujos de trabajo prácticos para equipos de B2B SaaS

Poner la integración en marcha es solo el primer paso. Aquí es donde realmente da resultados.

Consultar tus bases de datos de Notion

Los equipos de SaaS suelen guardar datos de clientes, solicitudes de funcionalidades o tareas de sprint en bases de datos de Notion. Una vez que Claude tiene acceso, puedes consultar esas bases de datos en lenguaje natural.

Ejemplos de prompts:

• «Encuentra todas las entradas de la base de datos de mi roadmap de producto cuyo estado sea "In Review"»
• «Muéstrame todas las páginas etiquetadas con el nombre de cliente Acme Corp»
• «Enumera todas las tareas asignadas a [nombre] que estén marcadas como de alta prioridad»

Claude lee las propiedades de la base de datos y filtra los resultados sin que tengas que crear vistas personalizadas.

Resumir documentos largos

Las especificaciones de producto, los informes de investigación de clientes y las guías de onboarding tienden a alargarse. Claude puede resumir en segundos cualquier página de Notion conectada.

Ejemplos de prompts:

• «Resume en 5 viñetas la página de investigación de clientes del segundo trimestre»
• «Dame las decisiones clave del registro de decisiones de arquitectura de nuestro sistema de facturación»
• «¿Cuáles son las principales objeciones recogidas en nuestro playbook de ventas?»

Esto es especialmente útil antes de llamadas con clientes o revisiones internas, cuando necesitas un resumen rápido. Los equipos que construyen una documentación más estructurada y flujos de contenido repetibles suelen combinar este tipo de configuración con el apoyo de sólidas agencias de content marketing para B2B SaaS para convertir el conocimiento interno en activos que generen pipeline.

Actualizar páginas sin salir de tu flujo de trabajo

Claude puede escribir contenido en Notion, no solo leerlo. Para los equipos de SaaS, esto elimina la fricción de cambiar de contexto entre tu asistente de IA y tu herramienta de documentación.

Ejemplos de prompts:

• «Añade una nueva sección a nuestra checklist de onboarding para clientes enterprise sobre la configuración de SSO»
• «Actualiza la propiedad de estado de la página de la funcionalidad "API rate limiting" a "Shipped"»
• «Crea una nueva página en nuestra base de datos de notas de reuniones con la fecha de hoy y el siguiente resumen: [pega las notas]»

Crear una base de conocimiento viva

El caso de uso más duradero de claude notion mcp en un contexto de B2B SaaS es tratar Notion como una capa de memoria persistente para Claude. En lugar de volver a explicar tu producto, tus clientes o tus procesos en cada conversación, Claude lee ese contexto desde Notion al comienzo de cada sesión.

Para configurarlo:

1. Crea una página «Claude Context» en Notion con tu ICP, el posicionamiento de tu producto y la terminología clave
2. Comparte esa página con tu integración
3. Empieza cada sesión de Claude con: «Lee mi página Claude Context en Notion antes de empezar»

Montarlo lleva unos 30 minutos y ahorra mucho tiempo en cada sesión posterior. En los equipos más grandes, este tipo de proceso pasa a formar parte de unas marketing operations para B2B SaaS más amplias, sobre todo cuando la documentación, la ejecución de campañas y los informes deben mantenerse alineados.

Solución de problemas habituales de configuración

Claude dice que no encuentra ninguna herramienta de Notion
El servidor MCP no se ha cargado. Cierra Claude Desktop por completo y reinícialo. Revisa tu archivo claude_desktop_config.json por si hay errores de sintaxis JSON (una coma o un corchete que falte romperá todo el archivo).

Claude puede buscar, pero no devuelve resultados
Tu integración no se ha conectado a ninguna página. Vuelve al paso 2 y comparte las páginas correspondientes con tu integración.

Errores de autenticación cuando Claude intenta acceder a Notion
Es probable que hayas introducido mal el token de la integración. Vuelve a notion.so/my-integrations, regenera el token y actualiza tu archivo de configuración.

Claude puede leer páginas, pero no puede actualizarlas
Revisa las capacidades de tu integración. Ve a notion.so/my-integrations, abre tu integración y confirma que «Update content» e «Insert content» están activados.

Claude Desktop vs Claude Code: ¿cuál deberías usar?

Ambas opciones usan el mismo servidor MCP de Notion y ofrecen un acceso idéntico a tu espacio de trabajo. La diferencia es una cuestión de preferencia de interfaz, no de capacidad.

Preguntas frecuentes

¿Qué es el servidor MCP de Notion y cómo funciona con Claude?
El servidor MCP de Notion es una integración oficial que usa el Model Context Protocol para dar a Claude acceso directo de lectura y escritura a tu espacio de trabajo de Notion. Claude envía solicitudes al servidor MCP, que las traduce en llamadas a la API de Notion. Así, Claude puede buscar, leer, crear y actualizar contenido de Notion con lenguaje natural, sin copiar y pegar de forma manual.

¿La integración de Claude con Notion MCP es gratuita?
El servidor de Notion MCP es gratuito y de código abierto. Necesitas un plan de Claude que admita el uso de herramientas MCP (Claude Pro o superior para Claude Desktop, o Claude Code, que tiene su propia tarifa). El plan gratuito de Notion admite integraciones, así que no hace falta un plan de pago de Notion.

¿Cómo añado Notion MCP a Claude Code en concreto?
Ejecuta claude mcp add notionhq/notion-mcp-server en el terminal de Claude Code y sigue las instrucciones para introducir el token de tu integración de Notion. También puedes instalar el plugin oficial de Notion para Claude Code desde el makenotion/claude-code-notion-plugin repositorio de GitHub, que añade el servidor MCP y comandos slash predefinidos en un solo paso.

¿Claude puede editar mis páginas de Notion o solo leerlas?
Claude puede leer, crear y actualizar páginas y entradas de bases de datos de Notion, siempre que tu integración tenga activadas las capacidades correspondientes. Ve a notion.so/my-integrations y comprueba que «Update content» e «Insert content» estén activadas en tu integración.

¿Es seguro conectar Claude a mi espacio de trabajo de Notion?
Las integraciones de Notion solo acceden a las páginas que compartes con ellas de forma expresa. Claude no puede ver ninguna página fuera de las que hayas conectado. El token de tu integración debe mantenerse en privado y guardarse solo en tu archivo de configuración local, nunca en un repositorio compartido o público.