# Nechte své vlastní agenty pracovat v Demanderu, ve stejných mantinelech

> Osobní API tokeny s omezenými oprávněními pro REST API a vzdálený MCP server přes Streamable HTTP s dvanácti nástroji, které čtou, navrhují a schvalují změny přes stejnou schvalovací bránu jako dashboard.

Vše v dashboardu běží na REST API a stejné API je AI agentům k dispozici jako MCP server. Agent se přihlásí osobním API tokenem, vidí jen nástroje, které mu povolují jeho oprávnění, a každá změna, o kterou požádá, prochází stejnou schvalovací bránou jako požadavek člověka.

## 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

- **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í.
- **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í.
- **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í.
- **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

```bash
# 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](https://demander.to/cs/features/guardrails/).

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.

> **Zatím není k dispozici.** Vlastní konektory v claude.ai se přihlašují přes OAuth, který endpoint zatím nenabízí. Připojte se z Claude Code, přes Messages API nebo z libovolného klienta, který umí poslat bearer token.

## 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.

## Související

- [Mantinely a autonomie](https://demander.to/cs/features/guardrails/)
- [Bezpečnost a data](https://demander.to/cs/security/)
- [Rozpočet a bidding](https://demander.to/cs/features/budget-optimisation/)
- [Atribuce](https://demander.to/cs/features/attribution/)
- [Jak to funguje](https://demander.to/cs/how-it-works/)

---
Zdroj: https://demander.to/cs/features/api-and-mcp/ · Demander · zkontrolováno 2026-10-02