Voraussetzungen
- Rolle Org Admin (oder Instance-Admin innerhalb der eigenen Organisation).
- Zugang zu den Notion-Integrationen (notion.so/my-integrations) mit Administratorrechten für den Workspace.
- Die Integration muss zuerst org-weit bereitgestellt werden, bevor sie über die Library in einem Space genutzt werden kann.
Schritt 1: OAuth-Integration in Notion anlegen
Legen Sie zunächst eine öffentliche Integration in Notion an. Daraus erhalten Sie die Client ID und das Client Secret, die Sie in Localmind hinterlegen.Integrations-Seite öffnen
Melden Sie sich bei Notion an und öffnen Sie notion.so/my-integrations.
Öffentliche Integration erstellen
Erstellen Sie eine neue öffentliche Integration und füllen Sie die erforderlichen Metadaten (Name, Logo, Beschreibung) aus. Verwenden Sie einen aussagekräftigen Namen, z.B.
Localmind Notion Connector.Für den OAuth-Flow ist eine öffentliche Integration erforderlich. Eine interne Integration (Single-Workspace-Token) lässt sich nicht für die Per-User-Anmeldung verwenden.
Capabilities aktivieren
Aktivieren Sie unter Capabilities folgende Berechtigungen:
- Read content
- Update content
- Insert content
Redirect-URI setzen
Setzen Sie unter OAuth Domain & URIs die Redirect-URI auf die OAuth-Redirect-URL Ihrer Instanz:
Die exakte URL wird nach dem Speichern auf dem Konfigurationsbildschirm in Localmind angezeigt. Ersetzen Sie
<deine-instanz> durch den Host Ihrer Localmind-Instanz und übernehmen Sie die dort angezeigte URL.Schritt 2: Konfiguration in Localmind hinterlegen
Hinterlegen Sie die Notion-Zugangsdaten in den Zugangsdaten Ihrer Organisation.Zugangsdaten öffnen
Navigieren Sie zu Einstellungen (Zahnrad-Icon unten links) → Org-Einstellungen → Zugangsdaten und klicken Sie auf die Notion-Kachel.
Felder ausfüllen
Tragen Sie die in Schritt 1 kopierten Werte ein:
| Feld | Beschreibung |
|---|---|
| Client ID | OAuth Client ID aus Notion |
| Client Secret | OAuth Client Secret aus Notion |
Schritt 3: Nutzer-Authentifizierung (Per-User OAuth)
Notion verwendet ausschließlich Per-User OAuth – jeder Nutzer verbindet sein eigenes Notion-Konto. Der Datenzugriff ist auf die Seiten und Datenbanken beschränkt, die der Nutzer während der OAuth-Anmeldung für die Integration freigibt.- Beim ersten Aufruf des Notion-Tools im Chat erscheint ein OAuth-Popup mit der Aufforderung zur Anmeldung.
- Während der Anmeldung wählt der Nutzer aus, auf welche Seiten und Datenbanken die Integration zugreifen darf.
- Nach erfolgreicher Anmeldung wird das Token gecacht – ein erneutes Login ist nicht erforderlich.
- Es gibt keinen Service-Account-Modus: Aktionen werden immer im Namen des angemeldeten Nutzers ausgeführt.
Aus Sicht der Endanwender ist dieser Schritt in Integrationen nutzen beschrieben.
Verwendung in Spaces
Nach dem org-weiten Bereitstellen ist die Integration noch nicht automatisch in jedem Space sichtbar. Ein Admin oder ein berechtigter Nutzer muss sie aus der Library in den jeweiligen Space freigeben.- Öffnen Sie die Library (Org-Navigation).
- Wählen Sie die Notion-Integration und geben Sie sie für den gewünschten Space frei.
- Danach steht das Notion-Tool den Agenten dieses Space zur Verfügung – siehe Werkzeuge.
Nächste Schritte
Integrationen nutzen
So verbinden Endanwender ihr Konto und rufen die Integration im Chat auf.
Zugangsdaten
Client ID und Secret zentral und verschlüsselt verwalten.
Library
Integrationen org-weit verfügbar machen und in Spaces freigeben.
Werkzeuge
Wie Agenten Tools und Konnektoren im Chat einsetzen.