Nástroje MCP
Nástroje MCP serveru jeden po druhém: co dělají, které zapisují a v jakém pořadí je volat.
Nástroje
| Nástroj | Co dělá | Zapisuje? |
|---|---|---|
| get_workspace_context | Přesný čas v UTC, časové pásmo uživatele a název pracovního prostoru. | ne |
| list_workspaces | Vypíše pracovní prostory uživatele a označí ten, ve kterém připojení pracuje. | ne |
| switch_workspace | Přepne připojení do jiného pracovního prostoru. Všechny nástroje pak pracují tam. | ano |
| list_integrations | Připojené kanály s ID, @handle a stavem. | ne |
| list_groups | Skupiny zákazníků. | ne |
| get_integration_schema | Pravidla kanálu a limit znaků platný pro daný účet. | ne |
| get_channel_options | Hodnoty specifické pro platformu, ze kterých lze u kanálu vybírat. | ano |
| preview_post | Ukáže, co by se odeslalo, pro každý kanál zvlášť. Nic nezapisuje. | ne |
| list_posts | Kalendář v UTC i místním čase, s názvy kanálů. | ne |
| delete_post | Smaže nepublikovaný příspěvek (jeden kanál), s allChannels: true celou skupinu. Již zveřejněný odmítne. | ano |
| create_post | Koncept, naplánování nebo okamžité publikování. | ano |
| upload_media_from_url | Obrázek nebo video do knihovny médií z URL nebo data URL. | ano |
| create_upload_link | Odkaz v prohlížeči, na který uživatel přetáhne soubor ze svého počítače. Platí dvě hodiny. | ano |
| list_upload_link_files | Co přišlo přes odkaz pro nahrání, s adresou, kterou lze vložit do příspěvku. | ne |
| fotoai_list_models | Obrazové a video modely FotoAI s parametry a cenou v kreditech. | ne |
| fotoai_quote | Přesná cena generování FotoAI. Nic neutratí. | ne |
| fotoai_generate | Generuje z kreditů FotoAI uživatele podle schválené nabídky; výsledek jde do knihovny médií. | ano |
| fotoai_get_generation | Stav generování a po dokončení adresy souborů uložených v knihovně médií, připravené pro příspěvek. | ano |
| get_plans | Čtyři tarify s cenami ve forintech, eurech, švýcarských francích a amerických dolarech, limity, pravidlo zkušebního období a aktuální tarif. Jen když se uživatel zeptá. | ne |
| subscribe | Odkaz na Stripe Checkout pro zvolený tarif. Uživatel ho otevře a zaplatí vlastní peněženkou. Jen přes přihlášené (OAuth) připojení, pro vlastníka. | ano |
| get_subscription | Stav předplatného a nezaplacený checkout. Po zaplacení jím agent ověří, že tarif je aktivní. | ne |
| manage_subscription | Odkaz na fakturační portál Stripe: změna tarifu, zrušení, faktury, karta. Jen přes připojení OAuth, pro plátce. | ano |
| open_posty | Otevře aplikaci Posty: kalendář, editor příspěvků a kanály. Je také v postranním panelu ChatGPT. | ne |
| open_posty_panel | Stejná aplikace v bočním panelu konverzace v ChatGPT. Volá ji aplikace, ne model. | ne |
| read_settings | Nastavení uživatele: časové pásmo a pracovní prostor, ve kterém připojení pracuje, s hodnotami k výběru. | ne |
| update_settings | Uloží časové pásmo, nebo přepne připojení do jiného pracovního prostoru. Volá ho nastavení pluginu v ChatGPT. | ano |
| search_mentions | Kanály a nadcházející příspěvky pro nabídku @ v desktopové aplikaci ChatGPT. Volá ji aplikace, ne model. | ne |
| get_post | Celý příspěvek (příspěvky vlákna nebo komentáře, média, nastavení) pro editor aplikace Posty. Volá ji aplikace, ne model. | ne |
| update_post | Změní naplánovaný, rozpracovaný nebo neúspěšný příspěvek z editoru aplikace Posty. Publikovaný příspěvek odmítne. Volá ji aplikace, ne model. | ano |
Které zapisují
Z 29 nástrojů 12 něco mění. Zbytek jen čte a nemůže nic pokazit.
create_post umí vytvořit koncept, naplánovat příspěvek i okamžitě publikovat. Okamžité publikování je nevratné. Pokud od agenta chcete jen koncepty, nespoléhejte na prompt: dejte mu takový klíč, se kterým publikovat nemůže. Viz stránku Autentizace.
delete_postsmaže jen nepublikované příspěvky. Už publikované odmítne. Smaže jeden příspěvek (jeden kanál); sallChannels: truesmaže celou skupinu na všech kanálech.preview_postukáže, co by se na jednotlivých kanálech publikovalo, a nic nezapisuje. Před naplánováním se to vyplatí spustit.
V jakém pořadí
- 1get_workspace_contextPřesný čas v UTC, vaše časové pásmo a název pracovního prostoru. Bez toho by agent plánoval podle času, který si sám vymyslí.
- 2list_integrationsKanály a jejich identifikátory. Všechna další volání tyto identifikátory vyžadují.
- 3get_integration_schemaPravidla cílového kanálu a limit znaků pro daný účet, než agent začne psát text.
- 4list_postsKalendář, aby agent nic nenaplánoval na už obsazený čas.
- 5preview_post, pak create_postNejdřív se podívejte, co by se publikovalo, a teprve potom příspěvek vytvořte.
Pracovní prostory
Připojení pracuje v jednom pracovním prostoru: v tom, který jste vybrali při připojení, nebo v tom, kde vznikl MCP klíč. Máte-li jich více, list_workspaces vypíše všechny a označí aktuální.
switch_workspace přepne připojení na jiný. Platí to pro připojení, ne pro jedno volání: od té chvíle každý nástroj pracuje tam, v každé konverzaci, která používá totéž připojení, dokud nepřepnete zpět. Přepnout lze jen do pracovního prostoru, kde jste vlastníkem a jehož tarif zahrnuje přístup k API. Připojení vytvořené MCP klíčem přepnout nelze: klíč zůstává v prostoru, kde vznikl, pro druhý prostor si tam vytvořte klíč. ID kanálů patří k pracovnímu prostoru, proto po přepnutí znovu zavolejte list_integrations.
Čas a časové pásmo
Server MCP pracuje v UTC a get_workspace_context vrátí vaše časové pásmo. list_posts vrací obojí: UTC i místní čas, spolu s názvem kanálu, aby agent nemusel nic přepočítávat.
Pro práci s datem platí stejné pravidlo jako všude jinde. Viz stránku Plánování.
Manifest
Seznam nástrojů je čitelný z manifestu i bez autentizace:
https://posty.hu/.well-known/mcp.json
Je to stejný seznam, který vrací server. Pokud chce klient před připojením vědět, co server umí, přečte si právě tento seznam.