Servidor MCP de Notion

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a Claude y a 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 puente entre los asistentes de IA (como Claude) y tu espacio de trabajo de Notion. Permite a la IA:

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

Guía de configuración paso a paso

Prerrequisitos

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

1. Cómo obtener tu clave API de Notion

1. Vaya a https://www.notion.so/my-integrations
2. Haga clic en el botón azul "+ Nueva integración".
3. Complete los datos:
   • Nombre : Elija un nombre como "Claude Assistant" o "AI Helper"
   • Logotipo : Opcional
   • Espacio de trabajo asociado : Seleccione su espacio de trabajo de Notion
4. Haga clic en "Enviar"
5. En la página siguiente, busque la sección "Token de integración interna".
6. Haga clic en "Mostrar" y copie el token (comienza con secret_ )

2. Configuración de este servidor

Descargar el Repositorio

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

1. Vaya al repositorio de GitHub: https://github.com/Sjotie/notionMCP/
2. Haga clic en el botón verde "Código" en la parte superior derecha
3. Seleccione "Descargar ZIP"
4. Una vez descargado, extraiga el archivo ZIP a una ubicación en su computadora
   • Windows: haga clic derecho en el archivo ZIP y seleccione "Extraer todo"
   • Mac: Haga doble clic en el archivo ZIP para extraerlo

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

1. Abra un símbolo del sistema o una terminal
   • Windows: Presione Win+R , escriba cmd y presione Enter
   • Mac: Abra la Terminal desde Aplicaciones > Utilidades
2. Navegue hasta donde desea almacenar el repositorio
   cd path/to/desired/location
3. Clonar el repositorio
   git clone https://github.com/Sjotie/notionMCP/

Navegar al directorio del proyecto

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

Si descargaste el ZIP (Opción A):

1. Abra un símbolo del sistema o una terminal
2. Utilice el comando cd para navegar hasta donde extrajo 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 clonó con Git (Opción B):

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

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

• Después de usar el comando cd , puedes verificar tu ubicación actual:
  • En Windows: Escriba dir y presione Entrar; debería ver archivos como server.js
  • En Mac: Escriba ls y presione Enter; debería ver archivos como server.js

Instalar dependencias

Una vez que esté en el directorio notionMCP, instale las dependencias necesarias:

Esto instalará todos los paquetes de Node.js necesarios. Debería ver una barra de progreso y, finalmente, un mensaje indicando que la instalación ha finalizado. Podría decir algo como "X paquetes buscan financiación". Esto es completamente normal y significa que funcionó.

3. Conexión a páginas de Notion

Por seguridad, Notion requiere que usted otorgue explícitamente acceso a cada página o base de datos:

1. Abra Notion y navegue hasta una página o base de datos a la que desea que acceda la IA
2. Haga clic en "•••" (tres puntos) en la esquina superior derecha
3. Seleccione "Agregar conexiones"
4. Busque y seleccione la integración que creó anteriormente
5. Repita este procedimiento para cualquier otra página o base de datos que desee hacer accesible.

4. Conexión a Claude Desktop

1. Localice el archivo de configuración de Claude Desktop:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json (Escriba esta ruta en la barra de direcciones del Explorador de archivos)
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (En el Finder, presione Cmd+Shift+G y pegue esta ruta)
2. Abra el archivo en un editor de texto. Si no existe, créelo 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. Reemplazar:
   • C:\\path\\to\\notion-mcp-server\\server.js con la ruta real al archivo server.js
     • Windows: utilice barras invertidas dobles (\\) en la ruta
     • Mac: utilice barras diagonales (/)
   • your_notion_api_key_here con su clave API de Notion
4. Guarde el archivo y reinicie Claude Desktop

5. Prueba de la conexión

1. Iniciar una nueva conversación en Claude
2. Pídele 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"
   • Crear 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 : Crea una nueva base de datos
• update-database : Modificar una estructura de 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
• Buscar : Encuentra contenido en tu espacio de trabajo

Solución de problemas

Problemas comunes:

1. "Error de conexión" en Claude
   • Asegúrese de que la ruta del servidor en claude_desktop_config.json sea correcta
   • Comprueba que tu clave API de Notion sea válida
   • Asegúrese 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
   • Comprueba que tu clave API tenga los permisos necesarios
3. El servidor no se inicia
   • Asegúrese de que todas las dependencias estén instaladas ( npm install )
   • Comprueba que el archivo .env exista con tu clave API

Obtener ayuda

Si encuentra problemas que no se abordan aquí, por favor:

• Verifique la salida de la consola para ver si hay mensajes de error
• Asegúrese de que su clave API de Notion sea válida
• Verifique que su integración tenga acceso a las páginas/bases de datos

Licencia

Instituto Tecnológico de Massachusetts (MIT)