placla · API v1 · MCP

PlaCla pro AI asistenty (MCP)

Připojte PlaClu do Claude, ChatGPT nebo jiného AI asistenta a nechte ho za vás nabízet blogy či objednávat články. Zpět na dokumentaci.

Co je MCP

MCP (Model Context Protocol) je způsob, jak dát AI asistentovi „ruce“ — sadu nástrojů, kterými za vás může něco udělat. Náš MCP server běží na adrese

https://api.placla.cz/mcp

a nabízí asistentovi nástroje PlaCly: blogerovi najdi vhodné poptávky, nabídni blog, odevzdej článek; inzerentovi založ poptávku, porovnej nabídky, akceptuj, proplať. Přihlašuje se vaším API klíčem (vytvoříte v nastavení účtu na webu) — asistent pak jedná za váš účet a vidí jen nástroje vaší role.

Bezpečnost: klíč dává asistentovi stejné možnosti jako API — u inzerenta včetně utrácení kreditu. Nástroje ho instruují, aby si každou peněžní akci nechal od vás výslovně schválit, přesto klíč svěřujte jen asistentovi, kterému věříte, a na webu ho můžete kdykoli zneplatnit. Výplata kreditu, platba kartou a zakládání blogů zůstávají jen na webu.

Jak si to zapnout

Nejjednodušší cesta: povolení jedním kliknutím (OAuth)

V asistentovi přidejte vlastní konektor s adresou https://api.placla.cz/mcp — např. na claude.ai: Settings → Connectors → Add custom connector. Otevře se stránka PlaCly: přihlásíte se (pokud nejste) a kliknete na Povolit. Hotovo — žádné klíče se nikam nekopírují. Povolením vznikne ve vašem účtu API klíč pojmenovaný podle aplikace; jeho smazáním v Nastavení účtu asistenta kdykoli odpojíte.

Pro programátory: API klíč napřímo

Claude Code:

claude mcp add --transport http placla https://api.placla.cz/mcp \
  --header "Authorization: Bearer VAS_API_KLIC"

Jiní klienti: typ Streamable HTTP, URL https://api.placla.cz/mcp a hlavička Authorization: Bearer VAS_API_KLIC.

Naučte asistenta pravidla PlaCly

Nástroje nesou základní pravidla v popisech, ale nejlépe asistent pracuje, když mu dáte i krátký návod (jako „skill“ nebo systémový pokyn):

skill-bloger.md — výběr poptávek, etiketa nabídek, odevzdání článku
skill-inzerent.md — struktura dobrého zadání, výběr nabídek, kontrola a proplácení

Nástroje

Společné (obě role)

Nástroj	Co dělá
`muj_ucet`	účet, role, kredit a blokace
`moje_obchody`	seznam obchodů, filtr stavu a změn od času
`detail_obchodu`	detail vč. plného zadání poptávky a odkazu na web
`zpravy_k_obchodu`	zprávy a reklamace k obchodu
`napis_zpravu`	zpráva protistraně (ne k nerozhodnutým nabídkám)

Bloger

Nástroj	Co dělá
`moje_blogy`	blogy účtu s cenami a stavem schválení
`vhodne_poptavky`	aktivní poptávky k nabídnutí
`nabidni_blog`	nabídka blogu na poptávku (s poznámkou)
`odevzdej_clanek`	odevzdání URL hotového článku

Inzerent

Nástroj	Co dělá
`zaloz_poptavku`	nová poptávka (standard/vip/publication/writing)
`sprava_poptavky`	aktivace / deaktivace poptávky
`nabidky_k_rozhodnuti`	čekající nabídky s metrikami blogů
`akceptuj_nabidku`	závazná objednávka článku (i za nižší cenu, min. 75 %)
`odmitni_nabidku`	tiché odmítnutí nabídky
`odloz_nabidku`	odložení / vrácení nabídky
`blokuj_blog`	blokace blogu z nabídky
`proplat_clanek`	proplacení článku (jednotlivě i vše najednou)
`ohodnot_clanek`	dodatečné hodnocení 1–5
`reklamuj_clanek`	reklamace odevzdaného článku
`storno_akceptace`	storno neodevzdaného obchodu
`stav_kreditu`	kredit, blokace, útrata, poslední pohyby
`dobij_kredit`	proforma na dobití převodem (údaje + QR)

Technické detaily

Protokol MCP (Streamable HTTP) — JSON-RPC 2.0 přes POST, odpovědi přímo JSON (bez SSE).
Stejný rate limit a pravidla jako REST API; každý nástroj volá interně API endpointy, takže platí tatáž omezení (kredit, stavy, minima cen) a tytéž chybové kódy.
Zápisové nástroje jsou idempotentní: opakování téhož volání po síťové chybě neprovede akci dvakrát.

PlaCla API v1 · dokumentace · návody · changelog · [email protected]