Woodander-API-Token erstellen
Token in den Workspace-Einstellungen anlegen, die richtigen Scopes wählen, ein Ablaufdatum setzen und den Token sicher aufbewahren.
Ein Token ist der Schlüssel, mit dem Ihr Assistent mit Woodander spricht. Sie erstellen ihn im Workspace, kopieren ihn einmal und tragen ihn in Ihrem Client ein.
Token erstellen #
- Melden Sie sich an und öffnen Sie den Workspace.
- Gehen Sie zu Settings → API & MCP.
- Legen Sie einen Token an: Name vergeben (zum Beispiel "Claude Code Laptop"), die nötigen Scopes anhaken und optional ein Ablaufdatum setzen.
- Kopieren Sie den Token sofort. Woodander zeigt ihn nur einmal und speichert nur einen Hash. Haben Sie ihn verloren, widerrufen Sie ihn und erstellen einen neuen.
Tokens sehen so aus: wdr_....
Sehen Sie die Seite nicht oder nur einen Upgrade-Hinweis, hat Ihr Tarif keinen API-Zugang. Siehe Limits und Fehler.
Scopes: nur so viel wie nötig #
Ein Scope ist eine Berechtigung. Ein Token mit read:seo liest Ihre SEO-Daten und sonst nichts. Haken Sie so wenige an wie möglich.
| Scope | Was er erlaubt |
|---|---|
read:products |
Ihre Discover-Projekte, Projektseiten, Leads und Bewertungen lesen. |
read:analytics |
Google-Analytics-Daten (GA4) und Projektstatistik lesen (Aufrufe, Klicks, Besucher, Leads, Referrer). |
read:seo |
Ihre Sites, Search-Console-Daten, Audits, Uptime-Status und White-Label-Berichte lesen. |
read:media |
Ihre Artikel und Entwürfe lesen, inklusive Markdown-Text. |
read:keywords |
Keyword-Ideen, getrackte Keywords und Ranking-Verlauf. Opt-in, standardmäßig nicht angehakt. |
read:gtm |
Ihre Google-Tag-Manager-Container, Tracking-Analyse, Site-Scan und Änderungsanfragen lesen. |
write:gtm |
Änderungen im Tag Manager anfordern: Tags, Trigger, Variablen, Versionen. Im Modus Manual werden sie zu Vorschlägen. Standardmäßig nicht angehakt. |
publish:gtm |
Erlaubt dem Token, eine Tag-Manager-Version ohne Sie zu veröffentlichen, aber nur im Modus Autonomous. Standardmäßig nicht angehakt. |
write:products |
Änderungen an Ihrem Discover-Projekt anfordern: Seitentext, Screenshots, Briefs, Antworten auf Bewertungen, Lead-Status. Standardmäßig nicht angehakt. |
Wichtig zu wissen:
- Schreib-Scopes sind nie vorausgewählt. Sie vergeben sie bewusst.
publish:gtmbewirkt in den Modi Manual und Hybrid nichts. Dort wartet das Veröffentlichen immer auf Sie. Mehr unter Modi und Freigaben.- Das Formular startet mit angehakten Lese-Scopes (Projekte, Analytics, SEO, Artikel). Keywords, Tag Manager und alle Schreib-Scopes bleiben ungehakt, bis Sie sie anhaken.
- Mit nur einem Project-Pro-Pass kann Ihr Token ausschließlich
read:products,write:products,read:marketundwrite:markettragen. Die Seite zeigt nur diese vier. - Ein Lese-Scope reicht nie, um etwas zu ändern. Ein Token nur mit
read:seokann den Tag Manager nicht anfassen.
Ablaufdatum wählen #
Das Ablaufdatum ist optional, aber wir empfehlen es. Sie können 30, 90, 180 oder 365 Tage oder keinen Ablauf wählen; vorgewählt sind 90 Tage. Ein Token für einen einmaligen Audit kann kurz leben, einer auf Ihrem eigenen Laptop länger. Ist ein Token abgelaufen, antworten Aufrufe mit 401, und Sie erstellen einen neuen. Sie können bis zu 20 Tokens gleichzeitig haben.
Prüfen, was ein Token darf #
Bitten Sie Ihren Assistenten nach der Verbindung, whoami aufzurufen. Das Tool liefert den Nutzer hinter dem Token, den Tarif, den Rest jedes Tariflimits sowie Name, Scopes, Ablaufdatum und letzte Nutzung des Tokens.
Token widerrufen #
Unter Settings → API & MCP sehen Sie jeden Token mit dem Zeitpunkt der letzten Nutzung. Dort widerrufen Sie ihn, und er funktioniert sofort nicht mehr. Tun Sie das, wenn ein Laptop verloren geht, jemand das Team verlässt oder Sie einen Token versehentlich in einen Chat kopiert haben.
Geheim halten #
- Committen Sie einen Token nie in Git und legen Sie ihn nie in ein öffentliches Repo.
- Speichern Sie ihn in der Konfiguration Ihres Clients oder in einer Umgebungsvariable.
- Nutzen Sie einen Token pro Werkzeug und Rechner. So widerrufen Sie einen, ohne die anderen zu stören.
- Fügen Sie ihn nicht in geteilte Dokumente oder Screenshots ein.
Nächster Schritt #
Verbinden Sie Ihren Client: Claude Code, Claude Desktop oder Cursor.