Private App und API-Token anlegen

Eine Private App gibt einer Integration Zugriff auf deinen Workspace. Sie bekommt einen Zugriffstoken mit dem Präfix y7_ und nur die Scopes, die du freigibst. Zum Beispiel liest ein Skript damit CRM-Datensätze.

API-Zugang ist ab Plan Business enthalten.

Private App erstellen

1. Klicke unten in der linken Leiste auf Admin.

2. Öffne Private Apps.

3. Klicke auf Private App erstellen.

4. Trage Name und optional eine Beschreibung ein.

5. Wähle mindestens einen Scope, zum Beispiel CRM lesen oder Postfach schreiben.

6. Speichere. Der Zugriffstoken erscheint genau einmal.

7. Klicke auf Token kopieren und speichere den Token sicher. Danach ist er nicht mehr abrufbar.

Postfach-Zugriff festlegen

1. Öffne die Private App und wechsle in den Tab Rechte.

2. Wähle unter Postfach-Zugriff Ausgewählte Postfächer und setze die Postfächer, die die App nutzen darf.

3. Alle Postfächer umfasst auch eingeschränkte Postfächer. Wähle das nur bewusst.

Ohne Auswahl hat die App keinen Postfach-Zugriff.

Token nutzen

• API: Sende Anfragen an https://api.yowo7.com mit dem Header Authorization: Bearer y7_….

• MCP: Verbinde deinen Client per POST https://api.yowo7.com/mcp mit demselben Token.

Token und Scopes gelten für API und MCP gleich. Im Tab Logs siehst du die Anfragen der App.

Token rotieren

1. Öffne die Private App.

2. Klicke auf Token sofort rotieren. Oder wähle Token rotieren (Übergangszeit), damit der alte Token bis zum Ablauf gültig bleibt.

3. Kopiere den neuen Token und speichere ihn sicher.

KI-Agenten verbindest du auch ohne Token: Unter Admin → Verbundene Agents kopierst du die MCP-Adresse. Der Agent fragt dich dann im Browser um Erlaubnis.