Werkzeuge · Inhalte und Interaktion
MCP-Tools für das, was im Feed passiert: Beiträge suchen, lesen, veröffentlichen, bearbeiten, verschieben und löschen, Kurzbeiträge, kommentieren und antworten, Kommentare bearbeiten und löschen, reagieren, anheften, die Galerie (hinzufügen, auflisten, bearbeiten, reagieren und löschen), das Ranking und deine Punkte, und die Moderation.
Der Alltag der Community: das Ranking und die Moderationswarteschlange, einen Beitrag über den Titel finden, eine Ankündigung mit Bild posten, Fragen aus einem Live beantworten, auf Vorstellungen reagieren, Wichtiges anheften, einen Beitrag in den richtigen Bereich verschieben und die Fotos der Galerie pflegen. Beiträge und Kommentare erscheinen mit dem Namen der Person, die den Assistenten verbunden hat.
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. Siehe Geld und Bestätigung.
Kurz gesagt
| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
list_posts | Der Feed, mit Kommentaren und Reaktionen | Alle | Nur lesen |
search_content | Sucht Beiträge, Events, Kurse, Abschnitte, Bereiche und Calls nach Titel | Alle | Nur lesen |
list_comments | Kommentare zu einem Beitrag | Alle | Nur lesen |
create_post | Veröffentlicht einen Beitrag | Alle | Ändert |
update_post | Bearbeitet Titel, Text, Titelbild und Anheften eines Beitrags | Autor oder Moderator | Ändert |
delete_post | Löscht einen Beitrag, mit Bestätigung | Autor oder Moderator | Mit Bestätigung |
move_post | Verschiebt einen Beitrag in einen anderen Inhalts- oder Feed-Bereich | Moderator | Ändert |
create_short_post | Veröffentlicht einen Kurzbeitrag ohne Titel in einem Feed | Mitglied (nicht Finanzen) | Ändert |
create_comment | Kommentiert oder antwortet | Alle | Ändert |
update_comment | Bearbeitet den Text eines Kommentars | Autor oder Moderator | Ändert |
delete_comment | Löscht einen Kommentar, mit Bestätigung | Autor oder Moderator | Mit Bestätigung |
add_reaction | Reagiert mit einem Emoji | Alle | Ändert |
pin_post | Heftet im Feed an oder löst | Moderator | Ändert |
add_gallery_image | Legt ein Bild per Link in eine Galerie | Alle | Ändert |
list_gallery_images | Die Bilder einer Galerie, mit Autor und Reaktionen | Alle | Nur lesen |
update_gallery_image | Ändert Titel oder Beschreibung eines Bildes | Autor oder Moderator | Ändert |
react_to_gallery_image | Reagiert auf ein Bild der Galerie | Alle | Ändert |
delete_gallery_image | Löscht ein Bild aus der Galerie | Autor oder Moderator | Mit Bestätigung |
get_leaderboard | Die Spitze des Rankings | Alle | Nur lesen |
get_my_points | Deine Punkte und deine Position im Ranking | Alle | Nur lesen |
get_ranking_rules | Ob das Ranking an ist und die Punkte pro Aktion | Administrator | Nur lesen |
update_ranking_rules | Schaltet ein, aus und ändert die Punkte | Administrator | Ändert |
list_moderation_queue | Was auf Freigabe wartet | Moderator | Nur lesen |
moderate_item | Gibt einen Eintrag der Warteschlange frei oder lehnt ihn ab | Moderator | Ändert |
list_posts
Nur lesen
Beiträge des Feeds auflisten. Der Feed (Beiträge, Status, Events und Kurse), vom neuesten zum ältesten, mit Anzahl der Kommentare und Reaktionen. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space_id | ID | Nein | Nur ein Bereich (aus list_spaces) |
type | all, status, content, events, courses | Nein | Nur ein Eintragstyp |
page, limit | Zahl | Nein | Seitenweise Abfrage |
Liefert: die Einträge, jeder mit ID und Typ, die create_comment, add_reaction und pin_post brauchen, Autor, Titel oder Text, Zahlen und ob angeheftet.
Frag so: „Welche Beiträge wurden diese Woche am meisten kommentiert?" · „Was wurde im Bereich Ankündigungen gepostet?"
search_content
Nur lesen
Nach Titel suchen. Sucht im Titel von Beiträgen, Events, Kursen, Abschnitten, Bereichen und Calls for Papers, ohne Groß- und Kleinschreibung oder Akzente zu unterscheiden, in einer einzigen Suche über die ganze Community. Mindestrolle: alle; jede Person findet, was sie sehen darf.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
query | Text, 2 bis 200 | Ja | Ein Teil des Titels. Bei Kurzbeiträgen wird der Text durchsucht |
types | Liste: posts, events, courses, spaces, calls | Nein | Standard: alle. spaces schließt die Abschnitte ein |
limit | Zahl, bis 50 | Nein | Standard 20 |
Liefert: die Treffer, jeweils mit Typ, ID, Titel und, falls vorhanden, Bereich, Abschnitt, Modul, Datum und Status.
Hinweise: Wer nicht zum Team gehört, findet nur Veröffentlichtes und Freigegebenes; Bereiche und Abschnitte, die für die Person geschlossen sind, bleiben außen vor. Die Suche ist dieselbe wie bei GET /api/search.
Frag so: „Finde den Beitrag So funktioniert die Community."
list_comments
Nur lesen
Kommentare eines Beitrags auflisten. Die Kommentare zu einem Inhaltsbeitrag oder einem Status. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | content, status | Ja | Der Typ des Eintrags, aus list_posts |
post_id | ID | Ja | Die ID des Eintrags, aus list_posts |
Liefert: die Kommentare mit ID (die create_comment in reply_to nutzt), Autor, Text und Datum.
Frag so: „Welche Kommentare zum Willkommensbeitrag haben noch keine Antwort?"
create_post
Ändert
Beitrag veröffentlichen. Veröffentlicht einen Textbeitrag in einem Feed- oder Inhaltsbereich. Mindestrolle: jede Rolle, die in diesem Bereich posten darf.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space_id | ID | Ja | Aus list_spaces |
title | Text | Ja | |
text | Markdown | Ja | Der Text des Beitrags, in Markdown: fett, kursiv, Listen, Links, Zwischenüberschriften, Zitat und Code |
image_url | Link | Nein | Das Titelbild des Beitrags: ein öffentlicher Link (http/https) zu einem JPEG-, PNG-, WebP- oder GIF-Bild bis 10 MB. Siehe Bilder |
Liefert: den angelegten Beitrag mit ID (für pin_post) und dem Titelbild. Der Text kommt in Markdown zurück, mit text_format: "markdown".
Frag so: „Poste im Feed eine Begrüßung für alle, die diese Woche beigetreten sind, und nenn jeden beim Namen."
Hinweise: Der Beitrag erscheint mit Name und Foto der Person, die verbunden hat. Die Regel Wer posten darf des Bereichs gilt: In einem Bereich nur fürs Team wird ein Mitglied abgelehnt. Der Beitrag erscheint sofort; planen geht noch nicht. Lässt sich das Bild nicht verwenden, wird nichts veröffentlicht, und der Assistent bekommt den Grund.
update_post
Ändert
Beitrag bearbeiten. Ändert Titel, Text oder Titelbild eines Beitrags und heftet ihn an oder löst ihn. Nur, was gesendet wird, ändert sich. Mindestrolle: der Autor, oder ab Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
post | ID oder Link | Ja | |
type | content, status | Nein | Standard: content. Bei Status (kurzen Beiträgen) ändert sich nur der Text |
title | einfacher Text | Nein | |
text | Markdown | Nein | In einem Kurzbeitrag (status) nur fett, kursiv, Links und Zeilenumbrüche |
image_url oder image_base64 | Link oder Datei | Nein | Das neue Titelbild. Siehe Bilder |
remove_image | ja oder nein | Nein | Entfernt das Titelbild |
pinned | ja oder nein | Nein | Anheften oder lösen (ab Moderator) |
Frag so: „Tausch im Beitrag So funktioniert die Community das Titelbild gegen dieses Bild aus und hefte ihn oben an."
Hinweise: Der Beitrag wechselt nicht den Bereich.
delete_post
Mit Bestätigung
Beitrag löschen. Mit Bestätigung: Der erste Aufruf zeigt den Beitrag, erst der zweite löscht. Mindestrolle: der Autor, oder ab Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
post | ID oder Link | Ja | |
type | content, status | Nein | Standard: content |
move_post
Ändert
Beitrag in anderen Bereich verschieben. Bringt einen Beitrag in einen anderen Inhalts- oder Feed-Bereich der Community; sein Platz im Feed wandert mit. Mindestrolle: Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
post | ID oder Link | Ja | |
to_space | ID, Link, Adresse oder Name | Ja | Ein Inhalts- oder Feed-Bereich |
Frag so: „Dieser Jobbeitrag ist in Ankündigungen gelandet; verschieb ihn in den Bereich Jobs.“
Hinweise: Ein Bereich eines anderen Moduls (Kurse, Events…) wird abgelehnt.
create_short_post
Ändert
Kurzbeitrag veröffentlichen. Ein Kurzbeitrag mit bis zu 500 Zeichen und ohne Titel in einem Feed-Bereich, wie das Schnellfeld der App. Für einen Beitrag mit Titel und Titelbild nutzt der Assistent create_post. Rolle: Eigentümer, Administrator, Moderator oder ein Mitglied, das im Bereich posten darf.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID, Link, Adresse oder Name | Ja | Ein Feed-Bereich |
text | Text, bis 500 | Ja | Nur fett, kursiv, Links und Zeilenumbrüche, in Markdown |
visibility | public, members, private | Nein |
Frag so: „Schreib in den Feed: ‚Live heute um 20 Uhr, Link im Event!‘“
create_comment
Ändert
Kommentieren oder antworten. Kommentiert einen Feed-Eintrag oder antwortet auf einen Kommentar. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | content, status, event, course | Ja | Der Typ des Eintrags, aus list_posts |
item_id | ID | Ja | Die ID des Eintrags |
text | einfacher Text, bis 2.000 | Ja | Ohne Formatierung: Markdown-Zeichen werden entfernt |
reply_to | ID | Nein | Die ID des Kommentars, auf den geantwortet wird (aus list_comments). Nur bei Einträgen vom Typ content |
Liefert: den angelegten Kommentar.
Frag so: „Antworte auf jede unbeantwortete Frage im Beitrag zum gestrigen Live, bedank dich und sag, dass wir es im nächsten behandeln."
update_comment
Ändert
Kommentar bearbeiten. Ändert den Text eines Kommentars. Mindestrolle: der Autor, oder ab Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | content, status | Ja | |
post | ID oder Link | Ja | Der Beitrag des Kommentars |
comment_id | ID | Ja | Aus list_comments |
text | Text, bis 2.000 | Ja |
delete_comment
Mit Bestätigung
Kommentar löschen. Mit Bestätigung. Mindestrolle: der Autor, oder ab Moderator. Dieselben Parameter, ohne text.
add_reaction
Ändert
Reagieren. Reagiert auf einen Feed-Eintrag. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | content, status, event, course | Ja | |
item_id | ID | Ja | |
reaction | 👍 ❤️ 🔥 🙌 😊 👏 🎉 | Ja | Eine der sieben Reaktionen |
Liefert: die registrierte Reaktion.
Frag so: „Reagiere mit 🎉 auf die Vorstellungen der Neuen von heute."
pin_post
Ändert
Im Feed anheften. Heftet einen Eintrag oben im Feed an oder löst ihn. Mindestrolle: Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | content, status, event, course | Ja | |
item_id | ID | Ja | |
pinned | ja oder nein | Nein | Standard: anheften. Mit false wird gelöst |
Liefert: den Eintrag mit dem neuen Zustand.
Frag so: „Hefte den Beitrag mit den Community-Regeln an."
add_gallery_image
Ändert
Bild zu einer Galerie hinzufügen. Lädt ein Bild von einem Link herunter und legt es in einen Galerie-Bereich. Mindestrolle: jede Rolle, die in diesem Bereich posten darf.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space_id | ID | Ja | Ein Galerie-Bereich (list_spaces mit module: gallery) |
image_url | Link | Ja | Ein öffentlicher Link (http/https) zu einem JPEG-, PNG-, WebP- oder GIF-Bild bis 10 MB. Siehe Bilder |
title | Text, bis 255 | Nein | Der Titel des Bildes in der Galerie |
Liefert: das Bild in der Galerie, mit Adresse und Vorschaubild.
Frag so: „Leg dieses Foto vom Treffen in die Galerie Treffen: https://…/foto.jpg"
list_gallery_images
Nur lesen
Galeriebilder anzeigen. Die Bilder eines Galerie-Bereichs, vom neuesten zum ältesten, mit Titel, Autor und Reaktionen. Mindestrolle: jede Rolle, die den Bereich sieht.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID, Link, Adresse oder Name | Ja | Der Galerie-Bereich |
page, limit | Zahl | Nein | limit bis 50 |
Liefert: die Bilder, mit der ID, die die anderen Galerie-Tools verlangen.
update_gallery_image
Ändert
Galeriebild bearbeiten. Ändert Titel oder Beschreibung eines Bildes. Rolle: wer das Bild hochgeladen hat, oder ab Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
image_id | ID | Ja | Aus list_gallery_images |
title | Text, bis 255 | Nein | |
description | Text | Nein |
react_to_gallery_image
Ändert
Auf Galeriebild reagieren. Mit 👍 ❤️ 🔥 👏 😊 oder 🙌. Dieselbe Reaktion noch einmal nimmt sie zurück. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
image_id | ID | Ja | Aus list_gallery_images |
reaction | eines der sechs Emojis | Ja |
delete_gallery_image
Mit Bestätigung
Galeriebild löschen. Rolle: wer das Bild hochgeladen hat, oder ab Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
image_id | ID | Ja | Aus list_gallery_images |
Liefert: beim ersten Aufruf Titel und Autor des Bildes sowie den Bestätigungscode.
get_leaderboard
Nur lesen
Ranking ansehen. Die Spitze des Punkte-Rankings der Community. Mindestrolle: alle.
Parameter: keine.
Frag so: „Wer sind die ersten 10 im Ranking?“
get_my_points
Nur lesen
Meine Ranglistenpunkte. Deine Punkte und deine Position im Ranking der Community. Mindestrolle: alle.
Parameter: keine.
Frag so: „Wie viele Punkte habe ich, und auf welchem Platz stehe ich?“
get_ranking_rules
Nur lesen
Ranking-Regeln ansehen. Ob das Ranking eingeschaltet ist und wie viele Punkte jede Aktion bringt. Mindestrolle: Administrator.
Parameter: keine.
Frag so: „Wie viele Punkte bringt ein Kommentar?“
update_ranking_rules
Ändert
Ranking-Regeln ändern. Schaltet das Ranking ein oder aus und ändert die Punkte pro Aktion. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
enabled | ja oder nein | Nein | |
points | Aktion → Punkte | Nein | Die Aktionen kommen aus get_ranking_rules, z. B. {"comment": 10} |
Frag so: „Kommentieren bringt ab jetzt 10 Punkte.“
Siehe Rangliste.
list_moderation_queue
Nur lesen
Moderationswarteschlange. Was auf Freigabe wartet, oder die Zahlen der Moderation. Mindestrolle: Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | summary, posts, courses, events, gallery, status | Nein | Standard: posts. summary liefert die Zahlen |
Frag so: „Wartet etwas auf Freigabe?“
moderate_item
Ändert
Freigeben oder ablehnen. Gibt einen Eintrag der Moderationswarteschlange frei oder lehnt ihn ab. Mindestrolle: Moderator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
type | posts, courses, events, gallery, status | Ja | |
item_id | ID | Ja | Aus list_moderation_queue |
decision | approve, reject | Ja | |
reason | Text | Nein | Pflicht beim Ablehnen |
Frag so: „Gib die Beiträge in der Warteschlange frei, die keinen externen Link haben.“
Siehe Moderation.