Werkzeuge

Der MCP-Server von Memberfy hat 188 Tools, die alle Module der Community abdecken: Der Assistent tut, was die App der verbundenen Person erlaubt, mit ihrer Rolle. Er wählt anhand deiner Anfrage selbst, welches er nutzt; diese Seite und die Seiten der einzelnen Themen zeigen dir, was er kann, mit welcher Rolle und wie du fragst. Die Namen sind auf Englisch, so wie der Assistent sie sieht, und in jeder Sprache gleich; der Titel, den Claude oder ChatGPT anzeigt, kommt in der Sprache der Person, die verbunden hat.

#Nach Thema

Jedes Tool hat ein Siegel: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung.

#Alle Tools

Mindestrolle: die kleinste Rolle, mit der das Tool erscheint. „Alle" schließt das Mitglied ein. Finanzen ist gesondert aufgeführt, weil die Rolle nicht in der Stufenfolge der anderen steht.

#Wie viele jede Rolle sieht

Die 40 des Call for Papers erscheinen für alle, weil Verantwortliche eines Calls ganz normale Mitglieder sein können und jedes Mitglied einreicht, begutachtet oder abstimmt, wenn der Call es zulässt. Memberfy prüft jeden Call nach der Regel des Moduls. Siehe Call for Papers.

Eine Verbindung, die nur zum Lesen autorisiert ist, sieht nur die Lese-Tools der Rolle.

Dass ein Tool in der Liste steht, heißt nicht, dass jeder Aufruf durchgeht: Memberfy prüft jede Aktion so, als käme sie vom Bildschirm. Ein Mitglied sieht create_post, aber in einem Bereich mit Wer posten darf = Team wird das Posten abgelehnt. Siehe Rollen und Berechtigungen.

#Gemeinsame Regeln

#Die IDs

Die Tools arbeiten mit IDs, und wo sie eine ID verlangen, akzeptieren sie auch den aus der App kopierten Link (siehe open_link). Fast jedes Gespräch beginnt mit get_community_context, das die Abschnitte und Bereiche mit IDs liefert; die Listen liefern die IDs dessen, was sie auflisten. Die Beschreibung jedes Tools sagt, woher jede ID kommt, und der Assistent verkettet selbst: Du bittest „poste im Bereich Ankündigungen", er sucht die ID des Bereichs Ankündigungen und postet.

#Seitenweise Abfrage

Die Listen akzeptieren page (die Seite, ab 1) und limit (wie viele pro Seite). Die Antwort enthält die Einträge und die Gesamtzahl, damit der Assistent weiß, ob er die nächste Seite holen muss.

#Zuerst Entwurf

Alles, was verkauft wird, entsteht als Entwurf: create_product, das Produkt von create_course, das Ticket von create_event und die Optionen von create_plan. Nichts geht ohne publish_product (oder publish: true im kombinierten Tool) in den Verkauf. So prüfst du vorher.

Das Anlegen hängt nicht von genehmigten Geschäftsinformationen ab; das Veröffentlichen schon. In einer Community ohne Genehmigung macht das kombinierte Tool, das veröffentlichen sollte, nichts rückgängig: Kurs, Event oder Plan bleiben als Entwurf, die Antwort nennt den Grund in publish_blocked, und der vorgeschlagene nächste Schritt ist, die Geschäftsinformationen auszufüllen und später zu veröffentlichen. Siehe Entwurf vor der Genehmigung.

#Idempotenz bei den kombinierten Tools

Die drei kombinierten Tools akzeptieren idempotency_key (bis zu 100 Zeichen). Wird der Aufruf mit demselben Schlüssel wiederholt, kommt das Ergebnis des ersten zurück, ohne erneut etwas anzulegen. Das hilft, wenn die Verbindung mittendrin abbricht und der Assistent nicht weiß, ob der Aufruf durchging.

#Rückgängig machen, wenn ein Schritt fehlschlägt

Die kombinierten Tools legen der Reihe nach an und entfernen, wenn ein Schritt fehlschlägt, was sie schon angelegt hatten (außer wenn das Veröffentlichen ohne genehmigte Geschäftsinformationen fehlschlug: dann bleibt alles als Entwurf), vom neuesten zum ältesten, und sagen, welcher Schritt fehlgeschlagen ist: „Der Schritt "módulo 2" ist fehlgeschlagen, und alles, was dieser Aufruf erstellt hatte, wurde rückgängig gemacht." Lässt sich etwas nicht rückgängig machen, listet die Antwort auf, was übrig ist, damit du es im Dashboard prüfst.

#Nächste Schritte

Wenn eine Fortsetzung passt, bringt die Antwort des Tools next_steps mit: bis zu drei vorgeschlagene Aktionen, jede mit dem Tool, dem Grund (in der Sprache der Person, die verbunden hat) und manchmal den fertigen Argumenten. Sie hängen davon ab, was zurückkam, und von deiner Rolle: Es kommen nur Tools vor, die du nutzen darfst. Der Assistent bietet diese Aktionen an, bevor er etwas anderes vorschlägt, und keine passiert, ohne dass du darum bittest.

#Fehler

Wenn Memberfy ablehnt, bekommt der Assistent die Meldung von Memberfy, dieselbe wie auf dem Bildschirm:

#Version des Servers und der Liste

Jedes Deployment von Memberfy ändert die Serverversion, und die Werkzeugliste, die eine Verbindung bekommt, hat einen eigenen Fingerabdruck. So erkennst du, ob ein Assistent eine aktuelle Liste hat.

Der Aufruf eines Werkzeugs, das nicht in der Liste der Verbindung steht, liefert einen Werkzeugfehler (isError), der darum bittet, ein neues Gespräch zu öffnen oder neu zu verbinden; ist der Name einer der alten portugiesischen, enthält die Antwort renamed_to mit dem neuen Namen. Der Aufruf landet im Audit-Protokoll als tool.unknown.

Inhaber und Admins vergleichen die letzte Liste, die eine Verbindung bekommen hat, mit der aktuellen unter GET /api/oauth/connections/{id}/diagnostics: Das Feld listUpToDate sagt, ob sie aktuell ist. Siehe Audit-Protokoll.

#Mit Bestätigung

Eine Bestätigung brauchen nur die Tools, die Geld bewegen, und die, die löschen (die mit delete_, remove_, revoke_, withdraw_ oder cancel_ beginnen). Mit dem Siegel Mit Bestätigung handeln sie nicht beim ersten Aufruf: Sie liefern eine Zusammenfassung und einen Code und handeln erst, wenn der Assistent den Aufruf nach deinem Ja mit dem Code wiederholt. Alle anderen, auch Einladungen, Rollenwechsel, Einstellungen und das Ausstellen von Zertifikaten, laufen beim ersten Aufruf. Die Tabelle oben zeigt das Siegel jedes Tools. Siehe Geld und Bestätigung.

#Text in Markdown

Der Assistent schreibt und liest den Text von Memberfy in Markdown. Memberfy wandelt ihn auf dem Hinweg in den formatierten Text der App um und auf dem Rückweg wieder in Markdown: Der Beitrag erscheint in der App mit Fettdruck und Liste, nicht mit Sternchen.

Was nicht in die App übernommen wird:

• Ein Bild im Text wird zu einem Link auf das Bild. Für das Titelbild eines Beitrags oder das Banner einer Veranstaltung nimm image_url (siehe Bilder).
• Eine Tabelle wird zu Textzeilen, eine pro Tabellenzeile.
• Skripte, Event-Attribute und javascript:-Links werden entfernt.

Fertiges HTML wird auch angenommen und durchläuft denselben Filter. Beim Lesen liefern die Tools den formatierten Text in Markdown und markieren das Ergebnis mit text_format: "markdown". Denselben Text zu lesen und wieder zu speichern ändert nichts.

#Bilder

create_post, add_gallery_image, create_course, create_event, update_post, update_event und update_course nehmen das Bild auf zwei Arten an:

• image_url: der Link zu einem Bild im Internet. Memberfy lädt es herunter und speichert es, als hättest du es im Dashboard hochgeladen.
• image_base64 (mit image_type, optional): die Datei selbst, bis 5 MB. Das ist der Weg für ein Bild, das der Assistent im Gespräch selbst erzeugt hat. SVG wird angenommen und in PNG umgewandelt; ein SVG, das auf externe Dateien verweist, wird abgelehnt.

Ein Link zu einer Seite (und nicht zum Bild selbst) wird abgelehnt mit „die Datei ist kein JPEG-, PNG-, WebP- oder GIF-Bild".

Bei den kombinierten Tools macht ein unbrauchbares Bild den Rest nicht rückgängig: Der Kurs oder das Event wird ohne Titelbild angelegt, und die Antwort nennt den Grund in warnings („Das Bild von … konnte nicht verwendet werden: Das Bild ist größer als 10 MB."). Frag mit einem anderen Link erneut, oder lade das Bild im Dashboard hoch. Bei den Tools für eine einzelne Sache (create_post, add_gallery_image) verhindert ein unbrauchbares Bild das Anlegen.

#Verwandte Artikel

• Rezepte
• Geld und Bestätigung
• Sicherheit und Grenzen