Notion MCP Server

Dieses Projekt implementiert einen MCP-Server für die Notion-API .

Installation

1. Integration in Notion einrichten:

Gehen Sie zu https://www.notion.so/profile/integrations und erstellen Sie eine neue interne Integration oder wählen Sie eine vorhandene aus.

Obwohl wir den Umfang der verfügbaren Notion-APIs einschränken (z. B. können Sie Datenbanken nicht über MCP löschen), besteht ein nicht zu vernachlässigendes Risiko für Arbeitsbereichsdaten, wenn diese LLMs ausgesetzt werden. Sicherheitsbewusste Benutzer sollten die Funktionen der Integration weiter konfigurieren.

Sie können beispielsweise ein schreibgeschütztes Integrationstoken erstellen, indem Sie auf der Registerkarte „Konfiguration“ nur den Zugriff „Inhalte lesen“ gewähren:

2. Inhalte mit Integration verknüpfen:

Stellen Sie sicher, dass relevante Seiten und Datenbanken mit Ihrer Integration verbunden sind.

Besuchen Sie dazu diese Seite, klicken Sie auf die drei Punkte und wählen Sie „Mit Integration verbinden“.

3. Hinzufügen der MCP-Konfiguration zu Ihrem Client:

Verwenden von npm:

Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json )

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Docker verwenden:

Es gibt zwei Möglichkeiten, den MCP-Server mit Docker auszuführen:

Option 1: Verwenden des offiziellen Docker Hub-Image:

Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "mcp/notion"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

Dieser Ansatz:

• Verwendet das offizielle Docker Hub-Image

• Behandelt JSON-Escape über Umgebungsvariablen ordnungsgemäß

• Bietet eine zuverlässigere Konfigurationsmethode

Option 2: Lokales Erstellen des Docker-Images:

Sie können das Docker-Image auch lokal erstellen und ausführen. Erstellen Sie zunächst das Docker-Image:

docker-compose build

Fügen Sie dann Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server"
      ]
    }
  }
}

Vergessen Sie nicht ntn_**** durch Ihr Integrationsgeheimnis zu ersetzen. Sie finden es auf der Registerkarte „Integrationskonfiguration“:

Beispiele

1. Mit der folgenden Anleitung

Comment "Hello MCP" on page "Getting started"

Die KI plant zwei API-Aufrufe, v1/search und v1/comments , korrekt, um die Aufgabe zu erfüllen

2. In ähnlicher Weise führt die folgende Anweisung dazu, dass der übergeordneten Seite „Entwicklung“ eine neue Seite mit dem Namen „Notion MCP“ hinzugefügt wird.

Add a page titled "Notion MCP" to page "Development"

3. Sie können die Inhalts-ID auch direkt referenzieren

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

Entwicklung

Bauen

npm run build

Ausführen

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Veröffentlichen

npm publish --access public