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

1. Descargue este repositorio a su computadora
   • Si tienes Git: git clone [repository-url]
   • O descargue y extraiga el archivo ZIP
2. 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
3. Navega a la carpeta donde descargaste este repositorio:
   cd path/to/notion-mcp-server
4. Instale las dependencias necesarias:
   npm install
5. Crear un archivo de configuración:
   • Haz una copia de .env.example y llámala .env
   • Abra el archivo .env en un editor de texto
   • Reemplace your_notion_api_key_here con el token que copió anteriormente
   • Guardar el archivo

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 correctamente
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)