Tutorials

Cursor IDE mit Notion verbinden: Ein Leitfaden für effizientes Coding

Melden

Hier ist ein detailliertes Tutorial, wie du die Cursor IDE (den beliebten KI-gestützten Code-Editor) mit deinen Notion-Inhalten verbindest.

Die Kombination aus Cursor (einem Fork von VS Code mit tief integrierter KI) und Notion (deinem Wissensmanagement) ermöglicht es dir, deine Dokumentationen, Anforderungen oder API-Guides direkt in den Entwicklungsprozess einzubinden.

Da Cursor nativ (noch) keine direkte "Login mit Notion"-Schaltfläche hat, nutzen wir die leistungsstarke "External Documentation"-Funktion von Cursor. Damit kann die KI deine Notion-Seiten lesen und als Kontext für Code-Vorschläge nutzen.

Methode 1: Notion-Seiten als Dokumentation einbinden (Empfohlen)

Diese Methode ist ideal, wenn du Projektdokumentationen oder Styleguides in Notion hast, auf die die Cursor-KI zugreifen soll.

Schritt 1: Notion-Seite vorbereiten

  1. Öffne die gewünschte Seite in Notion.
  2. Klicke oben rechts auf "Share" (Teilen).
  3. Aktiviere "Publish to web" (Im Web veröffentlichen).
  4. Kopiere den Link der veröffentlichten Seite.
    • Hinweis: Stelle sicher, dass keine sensiblen Passwörter auf dieser Seite stehen, da sie über den Link (theoretisch) öffentlich zugänglich ist.

Schritt 2: In Cursor hinzufügen

  1. Öffne die Cursor IDE.
  2. Gehe in die Einstellungen: Drücke Strg + Shift + J (Windows/Linux) oder Cmd + Shift + J (Mac), um die Cursor Settings zu öffnen.
  3. Navigiere zum Reiter "General" und suche den Bereich "Documentation".
  4. Klicke auf den Button "+ Add new doc".
  5. Im Feld URL fügst du deinen Notion-Link ein.
  6. Gib der Dokumentation einen Namen (z. B. "Projekt-Doku" oder "Notion-Coding-Standards").
  7. Cursor wird nun die Seite indexieren.

Schritt 3: Die Notion-Daten im Chat nutzen

Jetzt kannst du die KI gezielt nach Inhalten aus Notion fragen:

  1. Öffne den Cursor-Chat (Cmd + L oder Strg + L).
  2. Tippe das @-Symbol.
  3. Wähle aus der Liste deine hinzugefügte Notion-Dokumentation aus.
  4. Stelle deine Frage, z. B.: "Erstelle eine Funktion basierend auf den Anforderungen in @Projekt-Doku."

Methode 2: Export-Import (Für private/sensible Daten)

Wenn du deine Notion-Seiten nicht veröffentlichen möchtest, kannst du sie lokal in dein Projekt integrieren.

  1. Gehe in Notion auf die drei Punkte oben rechts (...).
  2. Wähle "Export".
  3. Wähle als Format Markdown & CSV.
  4. Entpacke die ZIP-Datei direkt in einen Ordner innerhalb deines Projekts (z. B. /docs).
  5. Cursor erkennt diese Dateien automatisch. Du kannst sie im Chat mit @Files oder einfach durch Markieren des Textes referenzieren.

Methode 3: Für Fortgeschrittene – Notion API & Cursor Rules

Du kannst Cursor anweisen, wie er sich verhalten soll, indem du eine .cursorrules-Datei in deinem Projekt-Root erstellst. Wenn du ein Skript hast, das Daten aus der Notion API zieht, kannst du Cursor beibringen, diese Daten zu nutzen.

  1. Erstelle eine Datei namens .cursorrules.
  2. Schreibe hinein, wie Cursor mit deinen Notion-Inhalten umgehen soll:
    Beziehe dich bei Architektur-Fragen immer auf die Markdown-Dateien im Ordner /notion-export. 
Halte dich strikt an die dort definierten Benennungskonventionen.

Tipps für die beste Erfahrung

  • Struktur zählt: Die KI in Cursor versteht gut strukturierte Notion-Seiten (mit Überschriften H1, H2, H3) deutlich besser als unstrukturierten Text.
  • Aktualisierung: Wenn du deine Notion-Seite änderst, musst du in den Cursor-Einstellungen bei der Dokumentation auf "Resync" (das kleine Refresh-Icon) klicken, damit die KI die neuesten Informationen erhält.
  • Gezielte Abfragen: Nutze im Chat immer das @-Symbol, um Cursor zu zwingen, in der Notion-Doku zu suchen, anstatt nur auf allgemeines Training-Wissen zurückzugreifen.

Fazit

Durch das Einbinden von Notion als External Doc in Cursor schließt du die Lücke zwischen Dokumentation und Code. Dein KI-Assistent weiß nun nicht nur, wie man programmiert, sondern versteht auch die spezifischen Anforderungen deines Projekts.

0