Servidor MCP de Notion

Un servidor de Protocolo de contexto de modelo (MCP) que expone el SDK oficial de Notion, lo que permite que los modelos de IA interactúen con los espacios de trabajo de Notion.

Inicio rápido

1. Configure su integración de Notion

1. Vaya a https://www.notion.so/my-integrations

2. Crear una nueva integración

3. Copiar la clave API

2. Conecte sus páginas de Notion a la integración

Para que su integración acceda al contenido de Notion, debe compartir explícitamente sus páginas o bases de datos con él:

1. Navegue a la página de Notion o la base de datos a la que desea acceder a través de la integración

2. Haga clic en el botón "Compartir" en la esquina superior derecha.

3. En el campo "Agregar personas, grupos o integraciones", seleccione su integración de la lista desplegable

4. Haga clic en "Invitar"

5. Repita esto para cada página o base de datos que desee que sea accesible

Nota: Una integración solo tiene acceso a las páginas y bases de datos que se han compartido explícitamente con ella. Las páginas secundarias heredan automáticamente el acceso de las páginas principales.

3. Añade a tu asistente de IA

Puede agregar este servidor MCP a Claude Desktop, Cursor AI o Claude.ai utilizando cualquiera de estos formatos de configuración:

Formato de línea de comandos

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

Formato de configuración JSON

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

Reemplace your-notion-integration-key con la clave API del paso 1.

Instrucciones de configuración

• Claude Desktop : Configuración > Avanzado > Protocolo de contexto del modelo

• Cursor AI : Configuración > AI > Servidores MCP

• Claude.ai (Web) : Perfil > Configuración > API e integraciones > Protocolo de contexto del modelo

Related MCP server: Notion MCP Server

Herramientas disponibles

El servidor proporciona herramientas para interactuar con Notion:

• Buscar : Encuentra páginas o bases de datos

• Bases de datos : consultar y recuperar entradas de bases de datos

• Páginas : crear, recuperar y actualizar páginas

• Bloques : Administra bloques de contenido (párrafos, listas, etc.)

• Usuarios : enumerar usuarios y obtener información de los mismos

• Comentarios : crear y listar comentarios

• Vistas previas de enlaces : crea vistas previas de enlaces para URL

Métodos de configuración alternativos

Uso de variables de entorno

En lugar de pasar la clave API directamente, puede utilizar un archivo .env :

1. Crea un archivo .env con:

NOTION_API_KEY=your-notion-integration-key

2. Ejecutar el servidor:

npx @ramidecodes/mcp-server-notion@latest -y

Configuración de JSON con variables de entorno (para Claude Desktop)

También puedes utilizar variables de entorno en el formato de configuración JSON:

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

Opciones de línea de comandos

OPTIONS:
  -h, --help              Show help message
  -v, --version           Show version information
  --verbose               Enable verbose logging
  --env-path <path>       Path to .env file
  --api-key <key>         Notion API key
  -y                      Skip confirmation prompts

Solución de problemas

Si encuentra errores de "Error al crear el cliente":

• En Windows, intente usar cmd /c antes del comando npx

• En macOS/Linux, intente usar la ruta completa a npx

• Pruebe el comando en una terminal antes de agregarlo a su asistente de IA

Problemas comunes

• Errores de "Sin acceso al recurso" : asegúrese de haber compartido la página o base de datos de Notion específica con su integración (consulte el paso 2)

• La integración no aparece en el menú para compartir : intenta actualizar la página o reiniciar tu navegador

• Capacidades limitadas : Verifique que su integración tenga las capacidades adecuadas habilitadas en la configuración de integración de Notion

Características

• Compatibilidad total con la API de Notion a través del SDK oficial

• Compatible con MCP para una integración perfecta con IA

• Herramientas integrales para todas las operaciones de Notion

• Manejo robusto de errores con mensajes detallados

• Fácil configuración con variables de entorno

Para obtener documentación detallada sobre cada herramienta, consulte la Documentación de herramientas .

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0: consulte el archivo de LICENCIA para obtener más detalles.