Notion MCP einrichten: OAuth, Seiten und Zugriff

Wenn eine Notion-Verbindung steht, aber die gesuchte Seite fehlt, muss nicht die Installation falsch sein. Entscheidend sind das angemeldete Konto, der ausgewählte Workspace und der Zugriff auf genau diese Seite. Dieser Leitfaden führt vom Verbindungsweg zu einem kleinen Lesetest. Bereiten Sie dafür eine unkritische Testseite mit eindeutigem Titel und einer kurzen, bekannten Textzeile vor. So lässt sich ein tatsächlicher Inhaltsabruf von einem bloßen Suchtreffer unterscheiden.

Den gehosteten Verbindungsweg wählen

Notion dokumentiert https://mcp.notion.com/mcp als Streamable-HTTP-Endpunkt. Die Anmeldung erfolgt über OAuth. Der gehostete Dienst und das ältere lokal betriebene Paket sind unterschiedliche Wege; Notion bezeichnet das lokale Paket inzwischen als nicht mehr aktiv gepflegt. Prüfen Sie deshalb zuerst, welchem Weg Ihre Anleitung folgt. Eine alte Paketkonfiguration lässt sich nicht allein durch den Austausch eines Tokens in eine Remote-Verbindung verwandeln.

Wählen Sie im Client eine entfernte HTTP-Verbindung und übernehmen Sie den Endpunkt aus der Herstelleranleitung. Die Clientübersicht hilft bei den unterschiedlichen Konfigurationsformaten. Für den Unterschied zwischen Prozess und URL steht der Transportleitfaden bereit. Prüfen Sie anschließend in der Anmeldemaske bewusst Konto und Workspace, besonders wenn Sie mehrere Arbeitsbereiche verwenden.

Workspace, Seite und Ergebnis auseinanderhalten

Legen Sie vor dem Test fest, ob Sie nach einem Titel suchen oder eine bereits bekannte Seite abrufen möchten. Ein Titel kann mehrfach vorkommen; notieren Sie deshalb zusätzlich die Seitenadresse. Stimmen Adresse und Titel, aber der Text fehlt, ist der Inhaltsschritt gesondert zu prüfen. Halten Sie den Umfang der Antwort fest und verwechseln Sie eine Vorschau nicht mit der vollständigen Seite. Übertragen Sie diesen Befund nicht ungeprüft auf Datenbanken oder Anhänge.

Den ersten Lesezugriff nachvollziehbar prüfen

1. Öffnen Sie die Testseite zuerst direkt in Notion mit dem Konto, das Sie verbinden möchten. Notieren Sie Titel, Adresse und erwartete Textzeile.

2. Verbinden Sie den Client, schließen Sie OAuth ab und prüfen Sie die angebotenen Werkzeuge. Brechen Sie einen unerwarteten Workspace-Wechsel ab.

3. Suchen oder lesen Sie die vorbereitete Seite. Vergleichen Sie die zurückgegebene Adresse und den Inhalt mit Ihrer Vorlage.

4. Vermerken Sie Datum, Client und Ergebnis. Ein späterer Schreibtest bekommt eine eigene Testseite und eine gesonderte Prüfung der Änderung.

Fehlende Seiten gezielt eingrenzen

Wenn bereits die Werkzeugliste fehlt, beginnen Sie mit der MCP-Fehlersuche. Wenn nur eine Seite fehlt, prüfen Sie zuerst den direkten Zugriff im gleichen Konto und die Workspace-Auswahl. Eine erneute Installation ist erst sinnvoll, wenn der Startweg selbst scheitert. Vergleichen Sie bei Drittanbieter-Servern zusätzlich die Quelle: Die Notion-Registersuche kann mehrere Projekte finden; ein passender Name belegt keine Verbindung zum Hersteller.

Braucht der gehostete Weg ein lokales Paket?

Für den dokumentierten HTTP-Weg starten Sie keinen eigenen Notion-Server. Prüfen Sie die Remote-Unterstützung Ihres Clients.

Ist eine erfolgreiche Anmeldung ein Seitentest?

Nein. Sie bestätigt noch nicht, dass die konkrete Seite gelesen werden konnte. Vergleichen Sie deren Adresse und Inhalt.

Kann ich den Lesetest für Änderungen verwenden?

Er belegt nur den Abruf. Testen Sie Änderungen separat an einer dafür angelegten Seite und lesen Sie das Ergebnis zurück.

Warum eine bekannte Textzeile verwenden?

Sie macht die Erwartung überprüfbar. Ein plausibel klingender Text oder ein ähnlicher Titel reicht als Nachweis nicht aus.

Herstellerdokumentation abgerufen am 1. Oktober 2026. Die Testabläufe sind redaktionelle Vorschläge.

1. Notion: Connect to Notion MCP
   Abrufbefehl anzeigen

   curl -s https://developers.notion.com/guides/mcp/get-started-with-mcp

Alle Beiträge