Notion MCP: Der umfassende Leitfaden zur Anbindung von KI an deinen Workspace

Was ist Notion MCP?

MCP (Model Context Protocol) ist ein offener Standard, mit dem KI-Assistenten externe Tools und Datenquellen nutzen können. Notion MCP ist Notions offizielle, gehostete Implementierung dieses Standards: ein Server zwischen deinem KI-Tool und deinem Workspace, der Notion als eine Reihe typisierter Tools bereitstellt — suchen, Seite lesen, Seite bearbeiten, Datenbank abfragen — statt als rohe API, mit der sich der Agent selbst zurechtfinden müsste.

In der Praxis liegen Welten zwischen diesem Ansatz und dem bisherigen Workflow mit Integrationstoken. Du authentifizierst dich einmal über OAuth, der Agent erkennt die verfügbaren Tools automatisch, und Seiteninhalte werden als Markdown übertragen — damit können Modelle leichter arbeiten, und die Übertragung benötigt deutlich weniger Tokens als Notions Block-JSON.

Gehosteter oder selbst gehosteter Server

Es gibt zwei offizielle Möglichkeiten für den Betrieb — und eine klare Standardempfehlung:

Nutze den gehosteten Server, sofern du nicht ausdrücklich eine Beschränkung auf Lesezugriff oder eine vom Netzwerk isolierte Umgebung brauchst. Notion hat klar gesagt, dass der quelloffene notion-mcp-server auf GitHub keine Priorität mehr hat und möglicherweise eingestellt wird.

Einrichtung: Claude Code, Claude Desktop, Cursor, ChatGPT

Claude Code (ein Befehl)

claude mcp add --transport http notion https://mcp.notion.com/mcp

Beim nächsten Start öffnet Claude Code den OAuth-Ablauf. Erlaube den Zugriff, und die Notion-Tools erscheinen automatisch.

Claude Desktop

Einstellungen → Konnektoren → Notion aus dem Verzeichnis hinzufügen (ein Klick), oder einen benutzerdefinierten Konnektor mit der URL https://mcp.notion.com/mcp hinzufügen.

Cursor

Füge Folgendes zu .cursor/mcp.json (Projekt) oder zu den globalen MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" }
  }
}

ChatGPT und andere

Jedes Tool, das als MCP-Client fungieren kann, lässt sich verbinden — ChatGPT unterstützt das über Konnektoren. Tools ohne MCP-Unterstützung können Notion MCP überhaupt nicht nutzen. Das ist der häufigste Grund, warum eine Einrichtung „nicht funktioniert“.

Selbst gehostete Variante

Erstelle unter notion.so/profile/integrations eine interne Integration, gewähre ihr Zugriff auf die Seiten, die du zugänglich machen möchtest, und starte dann den Server mit deinem Token:

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_****" }
    }
  }
}

Was Agenten tatsächlich können

• Suchen auf deinen Seiten und in verbundenen Inhalten — der Agent findet den Kontext, statt dass du ihn einfügst.
• Seiten als Markdown lesen — den gesamten Seiteninhalt mit einem Aufruf abrufen, tokensparend und inklusive Transkripten aus Besprechungsnotizen.
• Schreiben und bearbeiten — Seiten erstellen, Inhalte überschreiben oder gezielt per Suchen und Ersetzen bearbeiten.
• Mit Datenbanken arbeiten — Datenquellen mit Filtern und Sortierungen abfragen, Eigenschaften aktualisieren, Einträge erstellen.
• Verschieben und organisieren — Seiten einer anderen übergeordneten Seite zuordnen, die Struktur verwalten.

In der Praxis deckt das den gesamten Kreislauf eines LLM-Wikis ab: Der Agent liest Quellen ein, schreibt Zusammenfassungen zurück in Notion, verknüpft Seiten miteinander und beantwortet Fragen anhand dessen, was er bereits aufgebaut hat. Wir nutzen genau diese Einrichtung täglich — Anleitungen zum Kopieren und Einfügen findest du in Claude Code + Notion: Fünf Workflows, und die vollständige Beschreibung des Aufbaus samt ehrlicher Darstellung der Grenzen in LLM-Wiki für Notion.

Sicherheit und Berechtigungen

• Deine Berechtigungen setzen die Obergrenze. Ein über Notion MCP verbundener Agent kann auf genau das zugreifen, worauf auch dein Konto Zugriff hat — auf nichts darüber hinaus. Berechtigungen auf Seitenebene kann er nicht umgehen.
• Die Untergrenze bestimmst du. Der gehostete Server handelt immer mit deinen vollen Zugriffsrechten. Überlege also gut, bevor du einen experimentellen Agenten mit einem Workspace mit sensiblen Daten verbindest. Für reinen Lesezugriff nutze den selbst gehosteten Server mit einem Integrationstoken, das nur „Inhalte lesen“ erlaubt.
• Kontrollmöglichkeiten für Enterprise. Workspace-Admins im Enterprise-Tarif können MCP Governance aktivieren: eine Liste zugelassener KI-Apps, die Prüfung von Verbindungen und einen Schalter zum Trennen aller Verbindungen.
• Daten fließen an das Modell. Alles, was der Agent liest, wird Teil seines Kontexts — beziehe daher auch die Datenrichtlinie des KI-Tools selbst in deine Sicherheitsbewertung ein.

Die fehlende Karte: Was MCP dir nicht gibt

MCP gibt einem Agenten Hände — zum Suchen, Lesen und Schreiben. Es gibt ihm keine Augen. Jede Abfrage ist ein Blick durchs Schlüsselloch: Der Agent sieht die Seiten, die er in diesem Durchgang abgerufen hat, nicht die Struktur des Workspace — welche Seiten zentrale Knotenpunkte sind, welche Cluster es gibt und wo die verwaisten Seiten liegen. Das ist ein Graphproblem, kein Problem des Informationsabrufs.

Genau diese Ebene ergänzt IVGraph bei einer Einrichtung mit Notion + MCP: Für dich wird der Workspace als interaktiver 3D-Wissensgraph dargestellt, und dieselbe Struktur wird Agenten über die IVGraph LLM API programmatisch zugänglich gemacht — mit Suche, Knotennachbarschaften und kürzesten Pfaden zwischen Seiten. Der Agent bearbeitet Inhalte über MCP; der Graph zeigt euch beiden, wie der Workspace tatsächlich aussieht.

FAQ