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)