Was jeder Token-Scope erlaubt
Die Scopes sind voneinander unabhängig: write schließt read nicht ein. Ein Agent, der vorschlagen, aber nie entscheiden soll, bekommt read und write, und eine Person gibt in der Inbox frei.
| Scope | REST-API | MCP-Tools |
|---|---|---|
| read | GET-Routen, außerdem das Erstellen eines Account-Briefings | Überblick, Aktionen auflisten und erklären, Accounts, Account-Briefing, Attribution, Kampagnen |
| write | Alle anderen Änderungen, jede durch das Gate | Kampagnenbudget festlegen, Optimierung ausführen |
| approve | Aktionen in der Inbox freigeben, ablehnen und zurücksetzen | Eine Aktion freigeben, ablehnen und zurücksetzen |
| admin | Wird nie an einen Token vergeben | Keine |
Workspace-Einstellungen (Autonomiestufe und Leitplanken), Integrationen, Mitglieder, Abrechnung und die Tokens selbst erfordern immer eine angemeldete Sitzung. So kann ein kompromittierter Token das Gate nicht abschalten.
Persönliche API-Tokens
-
01
Handelt in Ihrem Namen
Ein Token gilt in einem Workspace, im Rahmen Ihrer Rolle und der Scopes, die Sie auswählen. Der Token eines Nutzers mit der Rolle Viewer kann nicht schreiben, unabhängig von seinen Scopes.
-
02
Einmal angezeigt, als Hash gespeichert
Sie erstellen ihn in den Einstellungen unter „API-Tokens“. Der Token (dmd_ und 43 Zeichen) wird einmal angezeigt; Demander speichert nur seinen SHA-256-Hash und zeigt Präfix, Scopes, letzte Nutzung und Ablaufdatum an.
-
03
Läuft ab und erlischt mit Ihrer Mitgliedschaft
Die Gültigkeit beträgt 1 bis 365 Tage, standardmäßig 90, mit bis zu 20 aktiven Tokens pro Person und Workspace. Jede Anfrage prüft Ihre Mitgliedschaft erneut, und ein Token, dessen Inhaber ausgeschieden ist, wird sofort widerrufen.
-
04
Mit Ratenlimit
Jeder Token hat sein eigenes Anfragekontingent pro Minute, zusätzlich zu den Limits pro IP-Adresse. Sie können einen Token jederzeit widerrufen.
Einen Agenten verbinden
# Claude Code
claude mcp add --transport http demander https://app.demander.to/v1/mcp \
--header "Authorization: Bearer dmd_…"
# Clients that only speak stdio: bridge with mcp-remote
npx mcp-remote https://app.demander.to/v1/mcp --header "Authorization: Bearer dmd_…"Der MCP-Connector der Messages API verwendet dieselbe URL, mit dem Token als Autorisierungstoken. Auf Seiten von Anthropic ist keine Freigabe nötig.
Die zwölf MCP-Tools
| Tool | Was es tut | Scope |
|---|---|---|
| demander_get_overview | Werbeausgaben, Klicks, Leads, Kosten pro Lead, identifizierte Sitzungen, Accounts nach Phase, Pipeline, Umsatz, CAC und ROAS der letzten N Tage, auch pro Plattform | read |
| demander_list_actions | Die Entscheidungs-Inbox, nach Status gefiltert | read |
| demander_explain_action | Begründung, Datengrundlage, erwarteter Wert, Konfidenz, Risiko und die Entscheidung des Gates samt Gründen | read |
| demander_list_accounts | Unternehmen mit Lifecycle-Phase und Scores für Passung, Kaufabsicht und Engagement | read |
| demander_get_account_brief | Ein kurzes Vertriebsbriefing: Zusammenfassung, warum gerade jetzt, Gesprächspunkte und ein Einstiegssatz | read |
| demander_get_attribution | Pipeline und Umsatz nach Kanal, Kampagne, Persona, Botschaft oder Creative, nach einem gewählten Modell | read |
| demander_list_campaigns | Kampagnen mit Tagesbudget sowie Ausgaben, Klicks und Leads der letzten 30 Tage | read |
| demander_set_campaign_budget | Schlägt ein neues Tagesbudget vor, das durch das Gate läuft | write |
| demander_run_optimization | Führt sofort Creative-Bandits, Budgetverteilung, Neugewichtung der Personas und Zustandsprüfungen aus | write |
| demander_approve_action | Gibt frei und führt aus; die festen Grenzen werden vorher erneut geprüft | approve |
| demander_reject_action | Lehnt ab, optional mit einer Notiz, die im Änderungsprotokoll gespeichert wird | approve |
| demander_revert_action | Wendet die gespeicherte Rücksetzung einer ausgeführten Aktion an | approve |
Der Remote-Endpunkt
POST /v1/mcp spricht MCP 2025-11-25 über Streamable HTTP, die neueste Revision, die das offizielle TypeScript-SDK implementiert, im zustandslosen Modus mit JSON-Antworten. Es wird keine Session-ID vergeben, und GET und DELETE antworten mit 405. Der Token legt den Workspace fest, und Tools außerhalb seiner Scopes werden gar nicht erst angeboten.
Tool-Aufrufe laufen im selben Prozess gegen dieselben REST-Routen, die auch das Dashboard nutzt, mit demselben Bearer-Token. Authentifizierung, Scopes, Mitgliedschaft und Rolle, das Gate, Ratenlimits und das Änderungsprotokoll sind deshalb identisch mit einer Anfrage aus dem Dashboard. Eine Anfrage mit Origin-Header muss von einem erlaubten Origin kommen, was vor DNS-Rebinding schützt; serverseitige Clients senden keinen.
Die REST-API selbst hat rund 150 Endpunkte unter /v1, von Produkten, Personas und Creatives bis zu Kampagnen, Zielgruppen, Sequenzen, Conversions und Analysen. Außerdem gibt es einen lokalen stdio-MCP-Server, der die API mit demselben Token aufruft.
Ein Agent hat genau die Befugnisse, die das Gate zulässt
Schreibzugriffe erstellen vorgeschlagene Aktionen oder entscheiden über sie. Die Budgetänderung eines Agenten kann sofort ausgeführt werden, auf Freigabe warten (etwa eine Verschiebung über dem täglichen Änderungslimit von 20 Prozent) oder durch ein Limit, den Not-Aus oder fehlerhaftes Tracking blockiert werden. Das Tool-Ergebnis nennt, was davon zutrifft, mit Begründung. Auf Autonomiestufe 1 wartet ein Agent weiterhin auf eine Person. Mehr dazu unter Leitplanken.
Jede Änderung eines Agenten landet im Änderungsprotokoll unter dem Inhaber des Tokens, mit Sicherung und der Möglichkeit zum Zurücksetzen. Hat ein Agent eine Reihe von Änderungen vorgenommen, die Sie nicht wollen, machen Sie alles, was er in den letzten Stunden getan hat, in einem Schritt rückgängig.
Häufige Fragen
Kann ein Agent meine Leitplanken oder meine Autonomiestufe ändern?
Nein. Einstellungen, Integrationen, Mitglieder und Tokens erfordern den Scope admin, den kein Token haben kann. Sie lassen sich nur aus einer angemeldeten Sitzung im Dashboard ändern.
Was passiert, wenn ein Token in falsche Hände gerät?
Widerrufen Sie ihn in den Einstellungen, dann funktioniert er sofort nicht mehr. Bis dahin kann er nur, was seine Scopes und Ihre Rolle erlauben, jede Änderung läuft weiterhin durch das Gate, und er läuft an dem von Ihnen festgelegten Datum ab.
Kann ich einen Agenten Änderungen vorschlagen, aber nie freigeben lassen?
Ja. Geben Sie seinem Token nur read und write. Seine Vorschläge landen wie alle anderen in der Inbox, und eine Person mit Freigaberecht entscheidet.
Brauche ich eine Freigabe von Anthropic, um Claude zu verbinden?
Nein. Erstellen Sie einen Token, fügen Sie den Endpunkt in Claude Code hinzu oder übergeben Sie ihn an den MCP-Connector der Messages API, und der Agent kann loslegen.