MCP-Tools
Die Tools des MCP-Servers einzeln: was sie tun, welches schreibt, und in welcher Reihenfolge du sie am besten aufrufst.
Die Tools
| Tool | Was es macht | Schreibt? |
|---|---|---|
| get_workspace_context | Die genaue Zeit in UTC, die Zeitzone des Nutzers und der Name des Arbeitsbereichs. | nein |
| list_workspaces | Listet die Arbeitsbereiche des Nutzers auf und markiert den, in dem die Verbindung arbeitet. | nein |
| switch_workspace | Stellt die Verbindung auf einen anderen Arbeitsbereich um. Danach arbeiten alle Werkzeuge dort. | ja |
| list_integrations | Die verbundenen Kanäle mit ID, @Handle und Status. | nein |
| list_groups | Die Kundengruppen. | nein |
| get_integration_schema | Die Regeln eines Kanals und das für das Konto aufgelöste Zeichenlimit. | nein |
| get_channel_options | Plattformspezifische Auswahlwerte für einen Kanal. | ja |
| preview_post | Zeigt pro Kanal, was rausgehen würde. Schreibt nichts. | nein |
| list_posts | Der Kalender, in UTC und Ortszeit, mit Kanalnamen. | nein |
| delete_post | Löscht einen nicht veröffentlichten Beitrag (einen Kanal), mit allChannels: true die ganze Gruppe. Einen, der schon online ist, lehnt es ab. | ja |
| create_post | Entwurf, Planung oder sofortige Veröffentlichung. | ja |
| upload_media_from_url | Ein Bild oder Video von einer URL oder Data-URL in die Mediathek. | ja |
| create_upload_link | Ein Browser-Link, auf den der Nutzer eine Datei von seinem eigenen Rechner zieht. Gilt zwei Stunden. | ja |
| list_upload_link_files | Was über den Upload-Link eingegangen ist, mit einer URL, die in einen Beitrag passt. | nein |
| fotoai_list_models | Die Bild- und Videomodelle von FotoAI mit Parametern und Preis in Credits. | nein |
| fotoai_quote | Der genaue Preis einer FotoAI-Generierung. Verbraucht nichts. | nein |
| fotoai_generate | Generiert mit den FotoAI-Credits des Nutzers zum bestätigten Angebot; das Ergebnis landet in der Mediathek. | ja |
| fotoai_get_generation | Der Status einer Generierung und, wenn fertig, die URLs der in der Mediathek gespeicherten Dateien für den Beitrag. | ja |
| get_plans | Die vier Tarife mit Preisen in Forint, Euro, Schweizer Franken und US-Dollar, die Limits, die Regel der Testphase und der aktuelle Tarif. Nur wenn der Nutzer fragt. | nein |
| subscribe | Ein Stripe-Checkout-Link für den gewählten Tarif. Der Nutzer öffnet ihn und zahlt mit seiner eigenen Wallet. Nur über eine angemeldete (OAuth) Verbindung, für den Inhaber. | ja |
| get_subscription | Der Status des Abonnements und ein unbezahlter Checkout. Nach der Zahlung bestätigt der Agent damit, dass der Tarif aktiv ist. | nein |
| manage_subscription | Ein Link zum Stripe-Abrechnungsportal: Tarifwechsel, Kündigung, Rechnungen, Karte. Nur über eine OAuth-Verbindung, für den Zahlenden. | ja |
| open_posty | Öffnet die Posty App: Kalender, Editor und Kanäle. Sie ist auch in der Seitenleiste von ChatGPT. | nein |
| open_posty_panel | Dieselbe App in der Seitenleiste eines ChatGPT Gesprächs. Die App ruft es auf, nicht das Modell. | nein |
| read_settings | Die Einstellungen des Nutzers: Zeitzone und der Arbeitsbereich dieser Verbindung, mit den wählbaren Werten. | nein |
| update_settings | Speichert die Zeitzone oder stellt die Verbindung auf einen anderen Arbeitsbereich um. Die Plugin Einstellungen in ChatGPT rufen es auf. | ja |
| search_mentions | Kanäle und kommende Beiträge für das @ Menü der ChatGPT Desktop App. Die App ruft es auf, nicht das Modell. | nein |
| get_post | Ein Beitrag vollständig (Thread-Beiträge oder Kommentare, Medien, Einstellungen) für den Editor der Posty App. Die App ruft es auf, nicht das Modell. | nein |
| update_post | Ändert einen geplanten, Entwurfs- oder fehlgeschlagenen Beitrag aus dem Editor der Posty App. Ein veröffentlichter Beitrag wird abgelehnt. Die App ruft es auf, nicht das Modell. | ja |
Welche schreiben
Von den 29 Tools ändern 12 etwas. Die anderen lesen nur und können keinen Schaden anrichten.
create_post kann einen Entwurf anlegen, planen und sofort veröffentlichen. Das Letztere lässt sich nicht rückgängig machen. Wenn du vom Agenten nur Entwürfe willst, verlass dich nicht auf den Prompt. Gib ihm einen Schlüssel ohne Veröffentlichungsrecht. Schau dazu auf die Seite Authentifizierung.
delete_postlöscht nur unveröffentlichte Beiträge. Einen schon veröffentlichten lehnt es ab. Es löscht einen Beitrag (einen Kanal); mitallChannels: truelöscht es die ganze Gruppe auf allen Kanälen.preview_postzeigt, was je Kanal rausgehen würde, und schreibt nichts. Vor dem Planen lohnt sich das.
In welcher Reihenfolge
- 1get_workspace_contextDie genaue Zeit in UTC, deine Zeitzone und der Name des Arbeitsbereichs. Ohne das würde der Agent nach einer Zeit planen, die er sich selbst ausdenkt.
- 2list_integrationsDie Kanäle mit ID. Jeder weitere Aufruf braucht diese IDs.
- 3get_integration_schemaDie Regeln des Zielkanals und das Zeichenlimit, das für das Konto gilt, bevor Text geschrieben wird.
- 4list_postsDen Kalender, damit nicht auf einen schon belegten Termin geplant wird.
- 5preview_post, dann create_postSchau zuerst, was rausgehen würde, und schreib erst danach.
Arbeitsbereiche
Eine Verbindung arbeitet in einem Arbeitsbereich: in dem, den du beim Verbinden gewählt hast, oder in dem, in dem der MCP-Schlüssel erstellt wurde. Hast du mehrere, listet list_workspaces alle auf und markiert den aktuellen.
switch_workspace stellt die Verbindung auf einen anderen um. Das gilt für die Verbindung, nicht für einen einzelnen Aufruf: Ab dann arbeitet jedes Werkzeug dort, in jedem Gespräch, das dieselbe Verbindung nutzt, bis du zurückwechselst. Wechseln kannst du nur in einen Arbeitsbereich, in dem du Inhaber bist und dessen Tarif API-Zugang enthält. Eine mit einem MCP-Schlüssel hergestellte Verbindung wechselt nicht: Der Schlüssel bleibt in dem Arbeitsbereich, in dem er erstellt wurde; für den anderen erstellst du dort einen Schlüssel. Kanal-IDs gehören zu einem Arbeitsbereich, daher list_integrations nach dem Wechsel erneut aufrufen.
Zeit und Zeitzone
Der MCP-Server arbeitet in UTC, und get_workspace_context liefert deine Zeitzone. list_posts gibt beides zurück: UTC und Ortszeit, zusammen mit dem Kanalnamen, damit der Agent nicht umrechnen muss.
Für Daten gilt dieselbe Regel wie überall sonst. Schau dazu auf die Seite Planung.
Das Manifest
Die Tool-Liste ist auch ohne Authentifizierung im Manifest lesbar:
https://posty.hu/.well-known/mcp.json
Das ist dieselbe Liste, die wir zurückgeben. Wenn ein Client vor der Verbindung wissen will, was der Server kann, liest er das.