Notion MCP Server

Notion MCP Server

Ein Model Context Protocol (MCP)-Server, der Claude und andere KI-Assistenten mit Ihrem Notion-Arbeitsbereich verbindet. Diese Integration ermöglicht KI-Assistenten die Interaktion mit Ihren Notion-Datenbanken, -Seiten und -Blöcken.

Was ist das?

Dieses Tool fungiert als Brücke zwischen KI-Assistenten (wie Claude) und Ihrem Notion-Arbeitsbereich. Es ermöglicht der KI:

• Anzeigen und Durchsuchen Ihrer Notion-Datenbanken
• Seiten erstellen und aktualisieren
• Inhaltsblöcke verwalten
• Und vieles mehr!

Schritt-für-Schritt-Installationsanleitung

Voraussetzungen

• Node.js (Version 14 oder höher)
• Ein Notion-Konto
• Claude Desktop-App (bei Verwendung mit Claude)

1. Erhalten Sie Ihren Notion-API-Schlüssel

1. Gehen Sie zu https://www.notion.so/my-integrations
2. Klicken Sie auf die blaue Schaltfläche „+ Neue Integration“
3. Geben Sie die Details ein:
   • Name : Wählen Sie einen Namen wie „Claude Assistant“ oder „AI Helper“
   • Logo : Optional
   • Zugehöriger Arbeitsbereich : Wählen Sie Ihren Notion-Arbeitsbereich aus
4. Klicken Sie auf „Senden“.
5. Suchen Sie auf der nächsten Seite den Abschnitt „Internes Integrationstoken“
6. Klicken Sie auf „Anzeigen“ und kopieren Sie das Token (es beginnt mit secret_ ).

2. Einrichten dieses Servers

Laden Sie das Repository herunter

Option A: Download als ZIP (Für Anfänger empfohlen)

1. Gehen Sie zum GitHub-Repository: https://github.com/Sjotie/notionMCP/
2. Klicken Sie oben rechts auf den grünen Button „Code“
3. Wählen Sie „ZIP herunterladen“
4. Extrahieren Sie die ZIP-Datei nach dem Download an einen Speicherort auf Ihrem Computer
   • Windows: Klicken Sie mit der rechten Maustaste auf die ZIP-Datei und wählen Sie „Alle extrahieren“
   • Mac: Doppelklicken Sie auf die ZIP-Datei, um sie zu entpacken

Option B: Klonen mit Git (Für Benutzer, die mit Git vertraut sind)

1. Öffnen Sie eine Eingabeaufforderung oder ein Terminal
   • Windows: Drücken Sie Win+R , geben Sie cmd ein und drücken Sie die Eingabetaste
   • Mac: Öffnen Sie Terminal über Programme > Dienstprogramme
2. Navigieren Sie zu dem Ort, an dem Sie das Repository speichern möchten
   cd path/to/desired/location
3. Klonen Sie das Repository
   git clone https://github.com/Sjotie/notionMCP/

Navigieren Sie zum Projektverzeichnis

Nach dem Herunterladen oder Klonen müssen Sie mit dem Befehl cd (Verzeichnis ändern) zum Projektordner navigieren:

Wenn Sie die ZIP-Datei heruntergeladen haben (Option A):

1. Öffnen Sie eine Eingabeaufforderung oder ein Terminal
2. Navigieren Sie mit dem Befehl cd zu dem Ort, an dem Sie die ZIP-Datei extrahiert haben:
   cd path/to/extracted/folder/notionMCP
   Zum Beispiel:
   • Unter Windows: cd C:\Users\YourName\Downloads\notionMCP
   • Auf dem Mac: cd /Users/YourName/Downloads/notionMCP

Wenn Sie mit Git geklont haben (Option B):

1. Das Repository sollte in einen Ordner mit dem Namen „notionMCP“ geklont worden sein.
2. Wenn Sie sich nach dem Klonen immer noch im selben Terminalfenster befinden, geben Sie einfach Folgendes ein:
   cd notionMCP

So erkennen Sie, dass Sie sich im richtigen Verzeichnis befinden:

• Nachdem Sie den Befehl cd verwendet haben, können Sie Ihren aktuellen Standort überprüfen:
  • Unter Windows: Geben Sie dir ein und drücken Sie die Eingabetaste. Sie sollten Dateien wie server.js sehen.
  • Auf dem Mac: Geben Sie ls ein und drücken Sie die Eingabetaste. Sie sollten Dateien wie server.js sehen.

Abhängigkeiten installieren

Sobald Sie sich im Verzeichnis notionMCP befinden, installieren Sie die erforderlichen Abhängigkeiten:

Dadurch werden alle benötigten Node.js-Pakete installiert. Sie sollten einen Fortschrittsbalken und schließlich eine Meldung sehen, die den Abschluss der Installation bestätigt. Möglicherweise lautet die Meldung „X Pakete suchen nach Finanzierung“ – das ist völlig normal und bedeutet, dass die Installation erfolgreich war.

3. Verbindung zu Notion-Seiten herstellen

Aus Sicherheitsgründen erfordert Notion, dass Sie jeder Seite oder Datenbank explizit Zugriff gewähren:

1. Öffnen Sie Notion und navigieren Sie zu einer Seite oder Datenbank, auf die die KI zugreifen soll
2. Klicken Sie oben rechts auf „•••“ (drei Punkte)
3. Wählen Sie „Verbindungen hinzufügen“
4. Suchen und wählen Sie die Integration aus, die Sie zuvor erstellt haben
5. Wiederholen Sie dies für alle anderen Seiten oder Datenbanken, die Sie zugänglich machen möchten

4. Verbindung mit Claude Desktop herstellen

1. Suchen Sie Ihre Claude Desktop-Konfigurationsdatei:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json (Geben Sie diesen Pfad in die Adressleiste des Datei-Explorers ein)
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (Drücken Sie im Finder Cmd+Umschalt+G und fügen Sie diesen Pfad ein)
2. Öffnen Sie die Datei in einem Texteditor. Falls sie nicht existiert, erstellen Sie sie mit folgendem Inhalt:
   { "mcpServers": { "notion": { "command": "node", "args": [ "C:\\path\\to\\notion-mcp-server\\server.js" ], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
3. Ersetzen:
   • C:\\path\\to\\notion-mcp-server\\server.js mit dem tatsächlichen Pfad zur Datei server.js
     • Windows: Verwenden Sie doppelte Backslashes (\\) im Pfad
     • Mac: Verwenden Sie Schrägstriche (/)
   • your_notion_api_key_here mit Ihrem Notion-API-Schlüssel
4. Speichern Sie die Datei und starten Sie Claude Desktop neu

5. Testen der Verbindung

1. Starten Sie eine neue Unterhaltung in Claude
2. Bitten Sie Claude, mit Ihrem Notion-Arbeitsbereich zu interagieren, zum Beispiel:
   • „Zeigen Sie mir eine Liste meiner Notion-Datenbanken“
   • „Erstelle eine neue Seite in meiner Aufgabendatenbank mit dem Titel ‚Testaufgabe‘“

Verfügbare Tools

Der Server stellt KI-Assistenten diese Tools zur Verfügung:

• list-databases : Alle zugänglichen Datenbanken anzeigen
• query-database : Einträge aus einer Datenbank abrufen
• create-page : Fügen Sie einer Datenbank eine neue Seite hinzu
• update-page : Eine bestehende Seite ändern
• create-database : Eine neue Datenbank erstellen
• update-database : Ändern einer Datenbankstruktur
• get-page : Eine bestimmte Seite anzeigen
• get-block-children : Inhaltsblöcke anzeigen
• append-block-children : Einer Seite Inhalt hinzufügen
• update-block : Inhaltsblöcke bearbeiten
• get-block : Einen bestimmten Block anzeigen
• Suche : Finden Sie Inhalte in Ihrem gesamten Arbeitsbereich

Fehlerbehebung

Häufige Probleme:

1. "Verbindung fehlgeschlagen" in Claude
   • Stellen Sie sicher, dass der Serverpfad in claude_desktop_config.json korrekt ist
   • Überprüfen Sie, ob Ihr Notion-API-Schlüssel gültig ist
   • Stellen Sie sicher, dass Node.js installiert ist
2. „Zugriff verweigert“ beim Zugriff auf Notion-Inhalte
   • Stellen Sie sicher, dass Sie die Seite/Datenbank mit Ihrer Integration geteilt haben
   • Überprüfen Sie, ob Ihr API-Schlüssel über die erforderlichen Berechtigungen verfügt
3. Server startet nicht
   • Stellen Sie sicher, dass alle Abhängigkeiten installiert sind ( npm install )
   • Überprüfen Sie, ob die .env-Datei mit Ihrem API-Schlüssel vorhanden ist

Hilfe bekommen

Wenn Sie auf Probleme stoßen, die hier nicht behandelt werden, gehen Sie bitte wie folgt vor:

• Überprüfen Sie die Konsolenausgabe auf Fehlermeldungen
• Stellen Sie sicher, dass Ihr Notion-API-Schlüssel gültig ist
• Überprüfen Sie, ob Ihre Integration Zugriff auf die Seiten/Datenbanken hat

Lizenz

MIT