MCP-szerver

MCP-eszközök

Az MCP-szerver eszközei egyenként: mit csinálnak, melyik ír, és milyen sorrendben érdemes hívni őket.

Az eszközök

Eszköz	Mit csinál	Ír?
get_workspace_context	A pontos idő UTC-ben, a felhasználó időzónája és a munkaterület neve.	nem
list_workspaces	Felsorolja a felhasználó munkaterületeit, és megjelöli azt, amelyiken a kapcsolat dolgozik.	nem
switch_workspace	Másik munkaterületre állítja a kapcsolatot. Ezután minden eszköz ott dolgozik.	igen
list_integrations	A bekötött csatornák azonosítóval, @handle-lel és állapottal.	nem
list_groups	Az ügyfélcsoportok.	nem
get_integration_schema	Egy csatorna szabályai és a fiókra feloldott karakterkorlát.	nem
get_channel_options	Platformspecifikus választható értékek egy csatornához.	igen
preview_post	Megmutatja, mi menne ki, csatornánként. Nem ír semmit.	nem
list_posts	A naptár, UTC és helyi idővel, csatornanévvel.	nem
delete_post	Egy nem közzétett poszt törlése (egy csatorna), allChannels: true esetén a teljes csoporté. A már kint lévőt visszautasítja.	igen
create_post	Piszkozat, ütemezés vagy azonnali közzététel.	igen
upload_media_from_url	Kép vagy videó a médiatárba URL-ből vagy data URL-ből.	igen
create_upload_link	Fotó vagy videó feltöltése a gépről vagy a telefonról: feltöltőkártya a csevegésben és egy link, amely két óráig él. Videó legfeljebb 1 GB, mp4 vagy mov.	igen
list_upload_link_files	Ami a feltöltési linken beérkezett, a posztba tehető címmel.	nem
fotoai_list_models	A FotoAI kép- és videómodelljei paraméterekkel és kreditárral.	nem
fotoai_quote	Egy FotoAI-generálás pontos ára. Nem költ semmit.	nem
fotoai_generate	Generálás a felhasználó FotoAI-kreditjeiből a jóváhagyott árajánlattal; az eredmény a médiatárba kerül.	igen
fotoai_get_generation	Egy generálás állapota, és ha kész, a médiatárba mentett fájlok posztba tehető címe.	igen
get_plans	A négy csomag ára forintban, euróban, svájci frankban és dollárban, a korlátok, a próbaidőszak szabálya és a jelenlegi csomag. Csak ha a felhasználó kérdezi.	nem
subscribe	Stripe Checkout link a választott csomagra. A felhasználó nyitja meg és a saját tárcájával fizet. Csak bejelentkezett (OAuth) kapcsolaton, a tulajdonosnak.	igen
get_subscription	Az előfizetés állapota és a ki nem fizetett checkout. Fizetés után ezzel erősíti meg az ügynök, hogy a csomag él.	nem
manage_subscription	Link a Stripe számlázási portálra: csomagváltás, lemondás, számlák, kártya. Csak OAuth-kapcsolaton, a fizetőnek.	igen
open_posty	Megnyitja a Posty alkalmazást: naptár, bejegyzésíró és csatornák. A ChatGPT oldalsávjában is ott van.	nem
open_posty_panel	Ugyanez az alkalmazás egy ChatGPT beszélgetés oldalpaneljén. Csak az alkalmazás hívja, a modell nem.	nem
read_settings	A felhasználó beállításai: időzóna és a munkaterület, amelyiken a kapcsolat dolgozik, a választható értékekkel.	nem
update_settings	Elmenti az időzónát, vagy másik munkaterületre állítja a kapcsolatot. A ChatGPT bővítmény beállításai ezt hívják.	igen
search_mentions	Csatornák és következő bejegyzések a ChatGPT asztali alkalmazás @ menüjéhez. Csak az alkalmazás hívja.	nem
get_post	Egy bejegyzés teljes egészében (thread bejegyzések vagy hozzászólások, média, beállítások) a Posty alkalmazás szerkesztőjének. Csak az alkalmazás hívja.	nem
update_post	Módosít egy ütemezett, piszkozat vagy hibás bejegyzést a Posty alkalmazás szerkesztőjéből. Megjelent bejegyzést nem módosít. Csak az alkalmazás hívja.	igen

Amelyik ír

A 29 eszközből 12 változtat valamin. A többi csak olvas, és nem tud kárt tenni.

A create_post azonnal is közzétehet

A create_post tud piszkozatot, ütemezést és azonnali közzétételt is. Az utóbbi visszafordíthatatlan. Ha az ügynöködtől csak piszkozatot vársz, ne a promptra bízd: adj neki olyan kulcsot, ami közzétenni nem tud. Lásd a Hitelesítés oldalt.

A delete_post csak nem közzétett bejegyzést töröl. A már kintlévőt visszautasítja. Egy bejegyzést töröl (egy csatornát); az allChannels: true a teljes csoportot törli minden csatornáról.
A preview_post megmutatja, mi menne ki csatornánként, és nem ír semmit. Ütemezés előtt ezt érdemes lefuttatni.

Milyen sorrendben

1
get_workspace_context
A pontos idő UTC-ben, a te időzónád és a munkaterület neve. Enélkül az ügynök a saját elképzelt idejéhez ütemezne.
2
list_integrations
A csatornák azonosítóval. Minden további hívás ezeket az azonosítókat kéri.
3
get_integration_schema
A célcsatorna szabályai és a fiókra feloldott karakterkorlát, mielőtt szöveget írna.
4
list_posts
A naptár, hogy ne ütemezzen egy már foglalt időpontra.
5
preview_post, majd create_post
Előbb nézzétek meg, mi menne ki, és csak utána írjatok.

Munkaterületek

Egy kapcsolat egy munkaterületen dolgozik: azon, amelyet a csatlakozáskor kiválasztottál, vagy amelyhez az MCP-kulcs készült. Ha több munkaterületed van, a list_workspaces mindet felsorolja, és megjelöli az aktuálisat.

A switch_workspace átállítja a kapcsolatot egy másik munkaterületre. A váltás a kapcsolatra vonatkozik, nem csak egyetlen hívásra. Ezután minden eszköz ott dolgozik, minden olyan beszélgetésben is, amely ugyanezt a kapcsolatot használja, amíg vissza nem váltasz. Csak olyan munkaterületre válthatsz, amelynek tulajdonosa vagy, és amelynek csomagjában van API-hozzáférés. MCP-kulccsal létrehozott kapcsolat nem váltható: a kulcs abban a munkaterületben marad, ahol készült, a másikhoz ott készíts kulcsot. A csatornaazonosítók munkaterülethez tartoznak, ezért váltás után újra meg kell hívni a list_integrations eszközt.

Idő és időzóna

Az MCP-szerver UTC-ben dolgozik, és a get_workspace_context adja meg a te időzónádat. A list_posts mindkettőt visszaadja: UTC-t és helyi időt, csatornanévvel együtt, hogy az ügynöknek ne kelljen átszámolnia.

A dátumkezelés ugyanaz a szabály, mint mindenhol máshol: lásd az Ütemezés oldalt.

A manifeszt

Az eszközök listája hitelesítés nélkül is olvasható a manifesztből:

https://posty.hu/.well-known/mcp.json

Ez ugyanaz a lista, amit a szerveren visszaadunk. Ha egy kliens csatlakozás előtt tudni akarja, mire képes a szerver, ezt olvassa.

Hiányzik valami erről az oldalról? Írj a [email protected] címre, vagy használd a Segítség oldal űrlapját.