Co jednotlivá oprávnění tokenu povolují
Oprávnění jsou na sobě nezávislá: write nezahrnuje read. Agent, který má navrhovat, ale nikdy nerozhodovat, dostane read a write a o schválení rozhodne člověk ve frontě ke schválení.
| Oprávnění | REST API | MCP nástroje |
|---|---|---|
| read | Endpointy GET a navíc generování briefu k firmě | Přehled, výpis a vysvětlení akcí, firmy, brief k firmě, atribuce, kampaně |
| write | Ostatní změny, každá přes schvalovací bránu | Nastavení rozpočtu kampaně, spuštění optimalizace |
| approve | Schválení, zamítnutí a vrácení akcí ve frontě ke schválení | Schválení, zamítnutí a vrácení akce zpět |
| admin | Token ho nikdy nedostane | Žádné |
Nastavení pracovního prostoru (úroveň autonomie a mantinely), integrace, členové, fakturace a samotné tokeny vždy vyžadují přihlášenou relaci, takže uniklý token nemůže schvalovací bránu vypnout.
Osobní API tokeny
-
01
Jedná vaším jménem
Token funguje v jednom pracovním prostoru, v rámci vaší role a oprávnění, která zvolíte. Token uživatele s rolí jen pro čtení nemůže zapisovat, ať má jakákoli oprávnění.
-
02
Zobrazí se jednou, uloží se jako hash
Vytvoříte ho v Nastavení v části API tokeny. Token (dmd_ a 43 znaků) se zobrazí jen jednou; Demander si ponechá pouze jeho SHA-256 a zobrazuje jeho prefix, oprávnění, poslední použití a datum vypršení.
-
03
Vyprší a zanikne s vaším členstvím
Platnost je 1 až 365 dní, ve výchozím nastavení 90, a každý člověk může mít v jednom pracovním prostoru až 20 aktivních tokenů. Každý požadavek znovu ověří vaše členství a token, jehož vlastník odešel, se okamžitě zneplatní.
-
04
Omezený počet požadavků
Každý token má vlastní limit požadavků za minutu, navíc k limitům pro jednotlivé IP adresy. Token můžete kdykoli zneplatnit.
Připojení agenta
# 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_…"MCP konektor v Messages API používá stejnou URL a token zadáte jako jeho autorizační token. Na straně Anthropicu není potřeba žádné schválení.
Dvanáct MCP nástrojů
| Nástroj | Co dělá | Oprávnění |
|---|---|---|
| demander_get_overview | Výdaje, prokliky, leady, cena za lead, identifikované relace, firmy podle fáze, pipeline, tržby, CAC a ROAS za posledních N dní, i po jednotlivých platformách | read |
| demander_list_actions | Fronta ke schválení, filtrovaná podle stavu | read |
| demander_explain_action | Důvod, podklady, očekávaná hodnota, jistota, riziko a verdikt schvalovací brány s odůvodněním | read |
| demander_list_accounts | Firmy s fází životního cyklu a skóre shody, nákupního záměru a zapojení | read |
| demander_get_account_brief | Krátký brief pro obchod: shrnutí, proč právě teď, body k rozhovoru a úvodní věta | read |
| demander_get_attribution | Pipeline a tržby podle kanálu, kampaně, persony, sdělení nebo kreativy ve zvoleném modelu | read |
| demander_list_campaigns | Kampaně s denním rozpočtem a s výdaji, prokliky a leady za 30 dní | read |
| demander_set_campaign_budget | Navrhne nový denní rozpočet přes schvalovací bránu | write |
| demander_run_optimization | Hned spustí bandit algoritmy pro kreativy, alokaci rozpočtu, přepočet vah person a kontroly stavu | write |
| demander_approve_action | Schválí a provede akci; předtím znovu zkontroluje pevné limity | approve |
| demander_reject_action | Zamítne akci, volitelně s poznámkou, která zůstane v auditním logu | approve |
| demander_revert_action | Použije uložené vrácení zpět u provedené akce | approve |
Vzdálený endpoint
POST /v1/mcp komunikuje protokolem MCP 2025-11-25 přes Streamable HTTP, tedy nejnovější revizí, kterou implementuje oficiální TypeScript SDK, v bezstavovém režimu s odpověďmi v JSON. Nevydává se žádné ID relace a GET a DELETE vracejí 405. Token určuje pracovní prostor a nástroje mimo jeho oprávnění se nikdy nenabízejí.
Volání nástrojů běží v rámci stejného procesu proti stejným REST routám, které používá dashboard, se stejným bearer tokenem. Autentizace, oprávnění, členství a role, schvalovací brána, limity požadavků i auditní log jsou proto stejné jako u požadavku z dashboardu. Požadavek s hlavičkou Origin musí přijít z povoleného originu, což chrání před DNS rebindingem; klienti na straně serveru tuto hlavičku neposílají.
Samotné REST API má pod /v1 zhruba 150 endpointů, od produktů, person a kreativ po kampaně, publika, sekvence, konverze a analytiku. K dispozici je i lokální MCP server přes stdio, který volá API se stejným tokenem.
Agent má přesně takovou pravomoc, jakou mu dovolí schvalovací brána
Zápisy vytvářejí navržené akce nebo o nich rozhodují. Změna rozpočtu od agenta se může provést hned, počkat na schválení (například posun nad limit denní změny 20 %), nebo ji zablokuje limit výdajů, nouzový vypínač (kill switch) či nefunkční měření. Výsledek nástroje uvede, co z toho nastalo, včetně důvodů. Na úrovni autonomie 1 agent stále čeká na člověka. Viz Mantinely.
Každá změna od agenta se zapíše do auditního logu pod vlastníkem tokenu, se snímkem stavu a možností vrácení. Pokud agent udělal sérii změn, které nechcete, vrátíte vše, co za poslední hodiny udělal, jedním krokem.
Časté otázky
Může agent změnit mé mantinely nebo úroveň autonomie?
Ne. Nastavení, integrace, členové a tokeny vyžadují oprávnění admin, které žádný token mít nemůže. Měnit je lze jen z přihlášené relace v dashboardu.
Co když token unikne?
Zneplatněte ho v Nastavení a okamžitě přestane fungovat. Do té doby může dělat jen to, co povolují jeho oprávnění a vaše role, každá změna i tak prochází schvalovací bránou a token vyprší k datu, které jste nastavili.
Může agent změny navrhovat, ale nikdy je neschvalovat?
Ano. Dejte jeho tokenu jen read a write. Jeho návrhy přistanou ve frontě ke schválení jako všechny ostatní a rozhodne člověk s právem schvalovat.
Potřebuji k připojení Clauda schválení od Anthropicu?
Ne. Vytvořte token, přidejte endpoint do Claude Code nebo ho předejte MCP konektoru v Messages API a agent může začít.