Verwende Notion von deinem Terminal aus mit Notion CLI (beta)

In diesem Hilfedokument

Lerne die Grundlagen der Verwendung von Notion über die Befehlszeile kennen, einschließlich der Einrichtung und häufiger Fehlerbehebungen.

Das Notion CLI ntn ist ein Tool, mit dem Entwickler/-innen und KI-Programmieragenten in Notion arbeiten können, indem sie Befehle in deinem Terminal eingeben. Du kannst den Notion-Inhalt lesen und schreiben sowie (sofern du Zugriff hast) Workers über die Befehlszeile verwalten.

Du kannst Workers auch in Notion mit dem Entwicklermodus anzeigen und Protokolle lesen. Verwende das CLI, wenn du Workers bereitstellen oder deren Code oder Einrichtung ändern musst.

Dieser Artikel ist ein allgemeiner Überblick. Informationen zur technischen Einrichtung findest du in der Entwicklerdokumentation.

Das solltest du wissen, bevor du loslegst

Das CLI wurde für Entwickler/-innen und technische Expert/-innen entwickelt.
Das CLI ist in allen Plänen verfügbar. Für die Bereitstellung und Verwaltung von Notion Workers ist jedoch ein Business oder Enterprise Plan erforderlich.
Für einige Funktionen der Developer Platform, die du über das CLI nutzt, sind möglicherweise bestimmte Pläne oder die Aktivierung durch einen Admin erforderlich.
Wenn etwas nicht in Ordnung zu sein scheint, stelle zunächst sicher, dass du die neueste Version des CLI verwendest.
Wenn du einen Worker nur anzeigen, Protokolle lesen, ihn deaktivieren oder löschen möchtest, kannst du das in Notion tun, nachdem du den Entwicklermodus aktiviert hast.

Installiere das CLI

Das CLI funktioniert auf Mac, Linux und Windows. Auf all diesen Systemen kannst du es mit npm install -g ntn installieren.

Weitere Informationen zur Installation findest du in der Entwicklerdokumentation.

Wenn etwas nicht funktioniert

Beginne mit diesen schnellen Überprüfungen:

Aktualisiere das CLI, dann Erneut versuchen. Das CLI wurde so konzipiert, dass es stets auf dem neuesten Stand ist, und ältere Versionen können sich anders verhalten.
Stelle sicher, dass du beim richtigen Notion-Konto angemeldet bist. Wenn du mehrere Konten oder Workspaces hast, melde dich ab und wieder an.
Überprüfe zuerst deinen Zugriff in Notion. Wenn du die Seite oder Datenbank in Notion nicht öffnen kannst, kann auch das CLI sie weder lesen noch ändern.
Wenn du versuchst, Workers-Befehle zu verwenden, stelle sicher, dass Workers aktiviert sind. Der Zugriff auf Workers kann von deinem Plan abhängen und davon, ob ein Workspace-Besitzer/-in sie aktiviert hat.
Kommst du immer noch nicht weiter? Verwende die Entwicklerdokumentation für den genauen Fehler und die Behebung, da die Schritte für jeden Befehl unterschiedlich sein können.

FAQs

Benötige ich das CLI, um Notion zu verwenden?

Nein. Das CLI ist optional und für Entwickler-Workflows gedacht.

Funktioniert das CLI auf Mobilgeräten?

Nein. Es wird in einem Terminal auf dem Desktop ausgeführt.

Wo finde ich die vollständige Befehlsliste?

Die vollständige Befehlsliste findest du in der Dokumentation für Entwickler/-innen .

Funktioniert das CLI unter Windows?

Ja. Das CLI funktioniert unter Windows, Mac und Linux gleich. Workers, die du auf einer Plattform erstellst, werden überall gleich angezeigt.

Kann ich Workers in Notion anstatt über das CLI verwalten?

Teilweise. In Notion kannst du Workers anzeigen, Protokolle lesen, Workers deaktivieren und /löschen, wenn du den Entwicklermodus aktiviert hast. Verwende das CLI, um Workers bereitzustellen oder deren Code oder Einrichtung zu ändern.