Notion

Conecta asistentes de IA a tu espacio de trabajo de Notion para buscar y gestionar páginas, bases de datos y contenido.

GitHub
11
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Notion

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a Claude y otros asistentes de IA con tu espacio de trabajo de Notion. Esta integración permite que los asistentes de IA interactúen con tus bases de datos, páginas y bloques de Notion.

¿Qué es esto?

Esta herramienta actúa como un puente entre los asistentes de IA (como Claude) y tu espacio de trabajo de Notion. Permite que la IA pueda:

  • Ver y buscar en tus bases de datos de Notion
  • Crear y actualizar páginas
  • Gestionar bloques de contenido
  • ¡Y mucho más!

Guía de Configuración Paso a Paso

Requisitos Previos

  • Node.js (versión 14 o superior)
  • Una cuenta de Notion
  • Aplicación de Claude Desktop (si se usa con Claude)

1. Obtener tu Clave de API de Notion

  1. Ve a https://www.notion.so/my-integrations
  2. Haz clic en el botón azul "+ Nueva integración"
  3. Completa los detalles:
    • Nombre: Elige un nombre como "Asistente de Claude" o "Ayudante de IA"
    • Logotipo: Opcional
    • Espacio de trabajo asociado: Selecciona tu espacio de trabajo de Notion
  4. Haz clic en "Enviar"
  5. En la página siguiente, busca la sección "Token de integración interna"
  6. Haz clic en "Mostrar" y copia el token (comienza con secret_)

2. Configuración de Este Servidor

Descargar el Repositorio

Opción A: Descargar como ZIP (Recomendado para principiantes)

  1. Ve al repositorio de GitHub: https://github.com/Sjotie/notionMCP/
  2. Haz clic en el botón verde "Code" en la parte superior derecha
  3. Selecciona "Download ZIP"
  4. Una vez descargado, extrae el archivo ZIP a una ubicación en tu computadora
    • Windows: Haz clic derecho en el archivo ZIP y selecciona "Extraer todo"
    • Mac: Haz doble clic en el archivo ZIP para extraerlo

Opción B: Clonar con Git (Para usuarios familiarizados con Git)

  1. Abre un símbolo del sistema o terminal
    • Windows: Presiona Win+R, escribe cmd y presiona Enter
    • Mac: Abre Terminal desde Aplicaciones > Utilidades
  2. Navega a donde quieras almacenar el repositorio 
    cd path/to/desired/location
  3. Clona el repositorio 
    git clone https://github.com/Sjotie/notionMCP/

Navegar al Directorio del Proyecto

Después de descargar o clonar, necesitas navegar a la carpeta del proyecto usando el comando cd (cambiar directorio):

Si descargaste el ZIP (Opción A):

  1. Abre un símbolo del sistema o terminal

  2. Usa el comando cd para navegar a donde extrajiste el archivo ZIP:

    cd path/to/extracted/folder/notionMCP

    Por ejemplo:

    • En Windows: cd C:\Users\YourName\Downloads\notionMCP
    • En Mac: cd /Users/YourName/Downloads/notionMCP

Si clonaste con Git (Opción B):

  1. El repositorio debería haberse clonado en una carpeta llamada "notionMCP"
  2. Si todavía estás en la misma ventana de terminal después de clonar, simplemente escribe: 
    cd notionMCP

Cómo saber si estás en el directorio correcto:

  • Después de usar el comando cd, puedes verificar tu ubicación actual:
    • En Windows: Escribe dir y presiona Enter - deberías ver archivos como server.js
    • En Mac: Escribe ls y presiona Enter - deberías ver archivos como server.js

Instalar Dependencias

Una vez que estés en el directorio notionMCP, instala las dependencias requeridas:

npm install

Esto instalará todos los paquetes necesarios de Node.js. Deberías ver una barra de progreso y eventualmente un mensaje que indique que la instalación ha terminado. Podría decir algo como "X paquetes están buscando financiamiento" - esto es completamente normal y significa que funcionó.

3. Conexión a Páginas de Notion

Por seguridad, Notion requiere que concedas acceso explícito a cada página o base de datos:

  1. Abre Notion y navega a una página o base de datos a la que quieras que la IA tenga acceso
  2. Haz clic en "•••" (tres puntos) en la esquina superior derecha
  3. Selecciona "Agregar conexiones"
  4. Encuentra y selecciona la integración que creaste anteriormente
  5. Repite para cualquier otra página o base de datos que quieras hacer accesible

4. Conexión a Claude Desktop

  1. Localiza tu archivo de configuración de Claude Desktop:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json (Escribe esta ruta en la barra de direcciones del Explorador de archivos)
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (En Finder, presiona Cmd+Shift+G y pega esta ruta)

  2. Abre el archivo en un editor de texto. Si no existe, créalo con el siguiente contenido:

    {
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "C:\\path\\to\\notion-mcp-server\\server.js"
      ],
      "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
      }
    }
  }
}

  3. Reemplaza:

    • C:\\path\\to\\notion-mcp-server\\server.js con la ruta real al archivo server.js
      • Windows: Usa dobles barras invertidas (\\) en la ruta
      • Mac: Usa barras inclinadas (/)
    • your_notion_api_key_here con tu clave de API de Notion

  4. Guarda el archivo y reinicia Claude Desktop

5. Prueba de la Conexión

  1. Inicia una nueva conversación en Claude
  2. Pide a Claude que interactúe con tu espacio de trabajo de Notion, por ejemplo:
    • "Muéstrame una lista de mis bases de datos de Notion"
    • "Crea una nueva página en mi base de datos de Tareas con el título 'Tarea de prueba'"

Herramientas Disponibles

El servidor proporciona estas herramientas a los asistentes de IA:

  • list-databases: Ver todas las bases de datos accesibles
  • query-database: Obtener entradas de una base de datos
  • create-page: Agregar una nueva página a una base de datos
  • update-page: Modificar una página existente
  • create-database: Crear una nueva base de datos
  • update-database: Modificar la estructura de una base de datos
  • get-page: Ver una página específica
  • get-block-children: Ver bloques de contenido
  • append-block-children: Agregar contenido a una página
  • update-block: Editar bloques de contenido
  • get-block: Ver un bloque específico
  • search: Buscar contenido en todo tu espacio de trabajo

Solución de Problemas

Problemas Comunes:

  1. "Conexión fallida" en Claude

    • Asegúrate de que la ruta del servidor en claude_desktop_config.json sea correcta
    • Verifica que tu clave de API de Notion sea válida
    • Asegúrate de que Node.js esté instalado

  2. "Acceso denegado" al acceder al contenido de Notion

    • Asegúrate de haber compartido la página/base de datos con tu integración
    • Verifica que tu clave de API tenga los permisos necesarios

  3. El servidor no se inicia

    • Asegúrate de que todas las dependencias estén instaladas (npm install)
    • Verifica que el archivo .env exista con tu clave de API

Obtener Ayuda

Si encuentras problemas no cubiertos aquí, por favor:

  • Revisa la salida de la consola para ver mensajes de error
  • Asegúrate de que tu clave de API de Notion sea válida
  • Verifica que tu integración tenga acceso a las páginas/bases de datos

Licencia

MIT