# 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: <span class="tool-kind tool-kind-read">Nur lesen</span> ändert nichts, <span class="tool-kind tool-kind-write">Ändert</span> legt sofort etwas an oder ändert es, und <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao).

## Kurz gesagt

| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
| [`list_posts`](#list-posts) | Der Feed, mit Kommentaren und Reaktionen | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`search_content`](#search-content) | Sucht Beiträge, Events, Kurse, Abschnitte, Bereiche und Calls nach Titel | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_comments`](#list-comments) | Kommentare zu einem Beitrag | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_post`](#create-post) | Veröffentlicht einen Beitrag | Alle | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_post`](#update-post) | Bearbeitet Titel, Text, Titelbild und Anheften eines Beitrags | Autor oder Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_post`](#delete-post) | Löscht einen Beitrag, mit Bestätigung | Autor oder Moderator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`move_post`](#move-post) | Verschiebt einen Beitrag in einen anderen Inhalts- oder Feed-Bereich | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`create_short_post`](#create-short-post) | Veröffentlicht einen Kurzbeitrag ohne Titel in einem Feed | Mitglied (nicht Finanzen) | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`create_comment`](#create-comment) | Kommentiert oder antwortet | Alle | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_comment`](#update-comment) | Bearbeitet den Text eines Kommentars | Autor oder Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_comment`](#delete-comment) | Löscht einen Kommentar, mit Bestätigung | Autor oder Moderator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`add_reaction`](#add-reaction) | Reagiert mit einem Emoji | Alle | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`pin_post`](#pin-post) | Heftet im Feed an oder löst | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`add_gallery_image`](#add-gallery-image) | Legt ein Bild per Link in eine Galerie | Alle | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_gallery_images`](#list-gallery-images) | Die Bilder einer Galerie, mit Autor und Reaktionen | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_gallery_image`](#update-gallery-image) | Ändert Titel oder Beschreibung eines Bildes | Autor oder Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`react_to_gallery_image`](#react-to-gallery-image) | Reagiert auf ein Bild der Galerie | Alle | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_gallery_image`](#delete-gallery-image) | Löscht ein Bild aus der Galerie | Autor oder Moderator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`get_leaderboard`](#get-leaderboard) | Die Spitze des Rankings | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_my_points`](#get-my-points) | Deine Punkte und deine Position im Ranking | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_ranking_rules`](#get-ranking-rules) | Ob das Ranking an ist und die Punkte pro Aktion | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_ranking_rules`](#update-ranking-rules) | Schaltet ein, aus und ändert die Punkte | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_moderation_queue`](#list-moderation-queue) | Was auf Freigabe wartet | Moderator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`moderate_item`](#moderate-item) | Gibt einen Eintrag der Warteschlange frei oder lehnt ihn ab | Moderator | <span class="tool-kind tool-kind-write">Ändert</span> |

## `list_posts`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`](/api/referencia/feed/get-search).

**Frag so:** *„Finde den Beitrag So funktioniert die Community."*

## `list_comments`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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](/mcp/ferramentas#text-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](/mcp/ferramentas#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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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](/mcp/ferramentas#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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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](/mcp/ferramentas#text-in-markdown) |
| `visibility` | `public`, `members`, `private` | Nein | |

**Frag so:** *„Schreib in den Feed: ‚Live heute um 20 Uhr, Link im Event!‘“*

## `create_comment`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Kommentar löschen.** Mit Bestätigung. *Mindestrolle: der Autor, oder ab Moderator.* Dieselben Parameter, ohne `text`.

## `add_reaction`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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](/mcp/ferramentas#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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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](/espacos/ranking).

## `list_moderation_queue`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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](/membros/moderacao).

## Verwandte Artikel

- [Werkzeuge](/mcp/ferramentas)
- [Rezepte](/mcp/receitas)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)