# Werkzeuge · Community und Struktur

> MCP-Tools für die Struktur der Community: der Kontext der Verbindung, Abschnitte und Bereiche, einen aus der App kopierten Link öffnen, Abschnitte und Bereiche anlegen, bearbeiten, neu ordnen und löschen, wer jeden sieht, einen Bereich in einen anderen Abschnitt verschieben, die Community-Einstellungen (auch die Sprache) und die E-Mail für die Verkaufsbenachrichtigungen.

Der Startpunkt jedes Gesprächs und die Form der Community: in welcher Community und mit welcher Rolle der Assistent arbeitet, welche Abschnitte und Bereiche es gibt, und diese Struktur anlegen, neu ordnen, anpassen oder löschen, auch wer jeden Bereich sieht. Hier versteht der Assistent auch einen Link, den du ins Gespräch einfügst, und hier sieht und ändert er die Community-Einstellungen (Name, Farben, Logo, SEO, Sprache und Zugangsregeln) und die E-Mail, die die Verkaufsbenachrichtigungen bekommt.

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 |
|---|---|---|---|
| [`get_community_context`](#get-community-context) | Community, Rolle, Abschnitte und Bereiche mit IDs: der Startpunkt | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_connection_diagnostics`](#get-connection-diagnostics) | Ob die Tool-Liste des Assistenten aktuell ist | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_spaces`](#list-spaces) | Abschnitte und Bereiche, mit Filter nach Modul | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`open_link`](#open-link) | Sagt, was ein aus der App kopierter Link (oder eine ID) ist | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_section`](#create-section) | Legt einen Menüabschnitt an | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`create_space`](#create-space) | Legt einen Bereich in einem Abschnitt an | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_space`](#update-space) | Ändert Name, Beschreibung, Symbol oder Sichtbarkeit eines Bereichs oder verschiebt ihn in einen anderen Abschnitt | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_section`](#update-section) | Ändert Name, Beschreibung, Symbol eines Abschnitts oder macht ihn zum Startabschnitt | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`reorder_sections`](#reorder-sections) | Bringt die Menüabschnitte in eine neue Reihenfolge | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`reorder_spaces`](#reorder-spaces) | Bringt die Bereiche eines Abschnitts in eine neue Reihenfolge | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_space_access`](#update-space-access) | Wer einen Bereich oder einen Abschnitt sieht und wer im Bereich postet | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_section`](#delete-section) | Löscht einen Abschnitt samt seinen Bereichen | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`delete_space`](#delete-space) | Löscht einen Bereich | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`get_community_settings`](#get-community-settings) | Die Community-Einstellungen: Name, Farben, Bilder, SEO, Sprache, Zugang | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_community_settings`](#update-community-settings) | Ändert Name, Farben, Logo, Favicon, SEO, Sprache und Zugangsregeln | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`get_notification_settings`](#get-notification-settings) | Die E-Mail, die die Verkaufsbenachrichtigungen bekommt | Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_notification_settings`](#update-notification-settings) | Ändert oder deaktiviert die E-Mail für Verkaufsbenachrichtigungen | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |

## `get_community_context`

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

**Kontext der Community.** Der Startpunkt: Sagt, mit welcher Community die Verbindung besteht, mit welcher Rolle, und listet die Abschnitte und Bereiche mit IDs. *Mindestrolle: alle.*

Parameter: keine.

**Liefert:** die Community (ID, Name, Adresse), dich (Rolle und Name), die Scopes der Verbindung (`read`, `write`), die Abschnitte (ID, Titel, ob Startabschnitt, Sichtbarkeit) mit ihren Bereichen (ID, Titel, Modul, Sichtbarkeit) die Reihenfolge, in der Dinge angelegt werden müssen, und die verfügbaren Symbole für Bereiche (`available_icons`, mit dem Einsatzzweck jedes Symbols).

**Frag so:** *„Mit welcher Community bist du verbunden, und mit welcher Rolle?"* · *„Welche Bereiche hat die Community?"*

**Hinweise:** Die Assistenten rufen dieses Tool meist von selbst am Anfang jedes Gesprächs auf. Die gelieferte Reihenfolge ist dieselbe wie unter [Reihenfolge der Erstellung](/api/ordem-de-criacao).

## `list_spaces`

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

**Abschnitte und Spaces auflisten.** Die Abschnitte und Bereiche mit ID, Modul und Sichtbarkeit, mit Filter nach Modul. *Mindestrolle: alle; jeder sieht, was er sehen darf.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `module` | Text | Nein | `feed`, `content`, `courses`, `events`, `storefront`, `gallery` … Liefert nur Abschnitte mit Bereichen dieses Moduls |

**Liefert:** die Abschnitte mit den Bereichen, wie bei `get_community_context`.

**Frag so:** *„Welcher ist der Kurs-Bereich?"* · *„Liste die Event-Bereiche auf."*

## `open_link`

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

**Link aus der App öffnen.** Nimmt einen Link deiner Community (oder eine lose ID oder einen Slug) und sagt, was dahintersteht, mit ID, Titel, Bereich und einer Zusammenfassung. *Mindestrolle: alle.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `link` | Text | Ja | Die Adresse aus der App, ein Pfad wie `/aprender/cursos/excel`, eine ID oder ein Slug |

Versteht die Adressen der App: Bereich (`/abschnitt/bereich`), Beitrag, Event, Kurs, Zertifikat (aus dem Bereich oder von der öffentlichen Prüfseite), Call for Papers und Vorschlag (`?proposal=`), Plan (`/pricing/…`) und Abonnement (`/billing?subscription=…`), auch die alten Adressen, die die App weiterleitet.

**Frag so:** *„Was ist das für ein Link? https://deinecommunity.de/aprender/cursos/excel-do-zero"*

**Hinweise:** Funktioniert nur mit Links der verbundenen Community. Ein Link einer anderen Community liefert *„Dieser Link gehört zu einer anderen Community"*, auch wenn du beide verwaltest: Verbinde die andere separat.

## `create_section`

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

**Abschnitt anlegen.** Legt einen Menüabschnitt an, etwa *Lernen* oder *Community*. Die Bereiche liegen in den Abschnitten. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `title` | Text, bis 255 | Ja | Der Name im Menü |
| `description` | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `visibility` | `public`, `members`, `plan`, `private` | Nein | Wer den Abschnitt sieht. Siehe [Sichtbarkeit und Zugriff](/conceitos/visibilidade-e-acesso) |

**Liefert:** den angelegten Abschnitt mit der ID, die `create_space` braucht.

**Frag so:** *„Lege einen Abschnitt Lernen an, nur für Mitglieder sichtbar."*

## `create_space`

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

**Space anlegen.** Legt einen Bereich in einem Abschnitt an, mit dem Modul, das bestimmt, was er ist. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `section_id` | ID | Ja | Aus `get_community_context` oder `create_section` |
| `title` | Text, bis 255 | Ja | |
| `module` | `feed`, `content`, `courses`, `events`, `storefront`, `gallery`, `ranking`, `url`, `certificates`, `call4papers` | Ja | Feed, Inhalt, Kurse, Events, Shop, Galerie, Ranking, Link, Zertifikate oder Call for Papers. Siehe [Module](/conceitos/modulos) |
| `external_url` | Webadresse | Nein | Nur im Modul `url`: die Adresse, die der Bereich öffnet |
| `icon` | eines der Symbole aus der Liste | Nein | Das Symbol des Bereichs. Siehe [Symbole](#symbole). Ohne Angabe wählt Memberfy eines nach Titel und Modul |
| `description` | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `visibility` | `public`, `members`, `plan`, `private` | Nein | |

**Liefert:** den angelegten Bereich mit ID und Symbol.

**Frag so:** *„Lege einen Feed-Bereich Ankündigungen im Abschnitt Community an, mit dem Megafon-Symbol."*

**Hinweise:** Für einen vollständigen Kurs oder ein Event legen `create_course` und `create_event` den Bereich gleich mit an. In einem Call-for-Papers-Bereich ist der vorgeschlagene nächste Schritt, den ersten Call zu eröffnen ([`create_call_for_papers`](/mcp/ferramentas-chamada#create-call-for-papers)). Bereiche haben kein Titelbild.

## `update_space`

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

**Space bearbeiten.** Ändert Name, Beschreibung, Symbol oder Sichtbarkeit eines bestehenden Bereichs oder verschiebt ihn in einen anderen Abschnitt. Nur, was gesendet wird, ändert sich. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `space_id` | ID | Ja | Aus `list_spaces` |
| `title` | Text, bis 255 | Nein | |
| `description` | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `icon` | eines der Symbole aus der Liste | Nein | Das Symbol des Bereichs. Siehe [Symbole](#symbole). Ohne Angabe wählt Memberfy eines nach Titel und Modul |
| `visibility` | `public`, `members`, `plan`, `private` | Nein | Für einen privaten Bereich mit Gruppen, Produkten oder Plänen nimm [`update_space_access`](#update-space-access) |
| `section_id` | ID | Nein | Verschiebt den Bereich in diesen Abschnitt |

**Liefert:** den aktualisierten Bereich.

**Frag so:** *„Ersetz das Symbol des Bereichs Jobs durch einen Aktenkoffer."* · *„Gib jedem Bereich im Abschnitt Lernen ein anderes Symbol, passend zum Thema."*

## `update_section`

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

**Abschnitt bearbeiten.** Benennt einen Menüabschnitt um, ändert Beschreibung oder Symbol oder macht ihn zum Startabschnitt. Nur, was gesendet wird, ändert sich. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `section` | ID, Adresse oder Name | Ja | Aus `get_community_context` |
| `title` | Text, bis 255 | Nein | |
| `description` | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
| `icon` | Text | Nein | |
| `is_home` | ja oder nein | Nein | Der Abschnitt, der zuerst geöffnet wird |

**Frag so:** *„Benenne den Abschnitt Lernen in Kurse um und mach ihn zum Startabschnitt.“*

**Hinweise:** Wer den Abschnitt sieht, ändert sich mit [`update_space_access`](#update-space-access).

## `reorder_sections`

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

**Abschnitte neu ordnen.** Bringt die Menüabschnitte in eine neue Reihenfolge, von oben nach unten. Die nicht genannten behalten ihre Reihenfolge, nach diesen. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `section_ids` | Liste von IDs | Ja | Aus `get_community_context`, in der neuen Reihenfolge |

**Frag so:** *„Setz den Abschnitt Events direkt hinter Community.“*

## `reorder_spaces`

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

**Bereiche neu ordnen.** Bringt die Bereiche eines Abschnitts in eine neue Reihenfolge. Die nicht genannten behalten ihre Reihenfolge, nach diesen. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `section` | ID, Adresse oder Name | Ja | Der Abschnitt |
| `space_ids` | Liste von IDs | Ja | Aus `list_spaces`, in der neuen Reihenfolge |

**Frag so:** *„Setz im Abschnitt Lernen den Bereich Excel von null an an die erste Stelle.“*

**Hinweise:** Um einen Bereich in einen anderen Abschnitt zu verschieben, nimm [`update_space`](#update-space) mit `section_id`.

## `update_space_access`

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

**Ändern, wer den Bereich sieht.** Legt fest, wer einen Bereich oder einen ganzen Abschnitt sieht und, in einem Bereich, wer posten darf. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `space` oder `section` | ID, Link, Adresse oder Name | Eines von beiden | Der Bereich oder der Abschnitt |
| `visibility` | `public`, `members`, `plan`, `private` | Nein | Öffentlich, Mitglieder, jedes aktive Abonnement oder privat |
| `group_ids` | Liste von IDs | Nein | Bei privat: die Gruppen, die Zugriff bekommen (aus `list_groups`) |
| `product_ids` | Liste von IDs | Nein | Bei privat: die Produkte, deren Kauf den Zugriff freigibt (aus `list_products`) |
| `plan_ids` | Liste von IDs | Nein | Bei privat: die Pläne, deren Abonnement den Zugriff freigibt (aus `list_plans`) |
| `can_create` | `anyone`, `staff`, `admins` | Nein | Nur Bereich: **Alle**, **Team** oder **Admins** dürfen posten |

**Liefert:** den aktualisierten Bereich oder Abschnitt.

**Frag so:** *„Mach den Bereich Excel von null an nur für alle sichtbar, die das Kursprodukt gekauft haben oder den Plan Schüler abonnieren.“*

**Hinweise:** Die gesendeten Gruppen, Produkte und Pläne ersetzen die bisherigen; eines davon genügt, damit die Person Zugriff hat. Ein Bereich ist nie offener als sein Abschnitt. Das ändert sofort, wer was sieht: Bitte den Assistenten, dir vorher zu zeigen, was sich ändert, wenn du es prüfen willst. Siehe [Sichtbarkeit und Zugriff](/conceitos/visibilidade-e-acesso).

## `delete_section`

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

**Abschnitt löschen.** Löscht einen Menüabschnitt und die Bereiche darin. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `section` | ID, Adresse oder Name | Ja | |

**Liefert:** beim ersten Aufruf den Abschnitt und die Liste der Bereiche, die mit gelöscht werden, sowie den Bestätigungscode.

## `delete_space`

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

**Bereich löschen.** Löscht einen Bereich und was er enthält aus dem Menü. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `space` | ID, Link, Adresse oder Name | Ja | |

**Liefert:** beim ersten Aufruf den Bereich, das Modul und den Abschnitt sowie den Bestätigungscode.

## `get_community_settings`

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

**Community-Einstellungen ansehen.** Die Einstellungen der Community, so wie sie sind. *Mindestrolle: Administrator.*

Parameter: keine.

**Liefert:** Name, Beschreibung, Farben (Primär- und Sekundärfarbe in Hex sowie die ganze Skala), Logo, Favicon, Teilen-Bild, SEO, Zugangsregeln (offene Registrierung, Registrierungsmodell, Besucher), Moderation und Rangliste. Keine Geheimnisse wie Integrationen oder DNS.

**Frag so:** *„Welche Farben und welches SEO hat die Community gerade?“*

## `update_community_settings`

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

**Community-Einstellungen ändern.** Ändert die Einstellungen; nur was gesendet wird, ändert sich. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `name`, `description` | Text | Nein | Name und Beschreibung der Community |
| `primary_color`, `secondary_color` | Farbe in Hex (`#RRGGBB`) | Nein | Die ganze Skala von 50 bis 950 wird daraus erzeugt. Siehe [Farben](/configuracoes/cores) |
| `reset_colors` | ja oder nein | Nein | Zurück zu den Standardfarben des Produkts |
| `mobile_bar_color` | Farbe in Hex | Nein | Die Farbe der Browserleiste auf dem Handy |
| `seo_title`, `seo_description` | Text | Nein | Siehe [Bilder und SEO](/configuracoes/imagens-e-seo) |
| `signup_open` | ja oder nein | Nein | Jeder darf sich registrieren |
| `signup_model` | `FREE`, `PAID` | Nein | |
| `guest_access` | ja oder nein | Nein | Besucher sehen, was öffentlich ist |
| `content_moderation` | ja oder nein | Nein | |
| `global_ranking` | ja oder nein | Nein | |
| `language` | `pt-BR`, `pt-PT`, `en-US`, `es-ES`, `es-MX`, `es-AR`, `it-IT`, `de-DE`, `de-AT`, `de-CH` | Nein | Die Sprache der Community: die der E-Mails und die für alle, die noch keine Sprache gewählt haben. Siehe [Sprachen](/configuracoes/idiomas) |
| `linkedin_id` | Zahl | Nein | Die ID der LinkedIn-Seite der Community, für die Zertifikate |
| `logo_url` oder `logo_base64` | Link oder Datei | Nein | Das Logo |
| `favicon_url` oder `favicon_base64` | Link oder Datei | Nein | Das Favicon |
| `share_image_url` oder `share_image_base64` | Link oder Datei | Nein | Das Bild, das erscheint, wenn jemand den Link teilt |

**Liefert:** die übernommenen Einstellungen, mit **vorher → nachher** für jedes Feld.

**Frag so:** *„Ändere die Primärfarbe auf #4F46E5 und nimm dieses Logo: https://…“*

**Hinweise:** All das sieht die ganze Community, sobald der Aufruf läuft; zum Rückgängigmachen bitte erneut mit dem alten Wert, der im **vorher → nachher** steht. Domain und Integrationen lassen sich hier nicht ändern. Siehe [Allgemeine Einstellungen](/configuracoes/configuracoes-gerais).

## `get_notification_settings`

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

**Verkaufsbenachrichtigungen ansehen.** Wohin die Benachrichtigungen der Community gehen: die E-Mail, die bei jedem Verkauf eine Benachrichtigung bekommt. *Mindestrolle: Administrator.*

Parameter: keine.

**Frag so:** *„Wer bekommt die Benachrichtigung, wenn ein Verkauf eingeht?“*

## `update_notification_settings`

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

**E-Mail für Verkaufsbenachrichtigungen ändern.** Legt die E-Mail fest, die bei jedem Verkauf eine Benachrichtigung bekommt. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `sales_notification_email` | E-Mail | Ja | Leer (`""`) schaltet die Benachrichtigungen ab |

**Frag so:** *„Schick die Verkaufsbenachrichtigungen an financeiro\@memberfy.net.“*

Siehe [Verkaufsbenachrichtigungen](/notificacoes/avisos-de-venda).

## Symbole

Die Bereiche nutzen dieselben Symbole wie die Auswahl im Dashboard. Der Assistent bekommt die Liste mit dem Einsatzzweck jedes Symbols (in `get_community_context`, Feld `available_icons`, und in der Beschreibung der Tools) und soll nach dem Thema wählen, ohne immer dasselbe zu nehmen. Wählt er keines, wählt Memberfy nach dem Titel (*Agenda de lives* bekommt `calendar`, *Vagas* bekommt `briefcase`) oder, ohne Hinweis im Titel, nach dem Modul (Kurse bekommt `book-open`, Galerie bekommt `image`).

Einige Beispiele: `calendar` (Events, Termine), `book-open` (Kurse, Lektionen), `graduation-cap` (Weiterbildung, Mentoring), `megaphone` (Ankündigungen), `message-square` (Forum, Fragen), `briefcase` (Karriere, Jobs), `image` (Galerie, Fotos), `trophy` (Ranking, Challenges), `shopping-bag` (Shop), `crown` (Premium, VIP), `lock` (privat).

## `get_connection_diagnostics`

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

**Diagnose der Verbindung.** Sagt, ob die Tool-Liste, die der Assistent verwendet, aktuell ist. *Mindestrolle: Administrator (Eigentümer oder Administrator).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `connection_id` | ID | Nein | Ohne Angabe die Verbindung dieses Gesprächs |

**Liefert:** den Assistenten, wer ihn wann autorisiert hat, die Serverversion und die Liste, die die Verbindung jetzt bekäme (Code der Liste und Anzahl der Tools), was sie zuletzt bekommen hat, den letzten Aufruf und den letzten Versuch, ein Tool zu nutzen, das sie nicht hat, sowie `listUpToDate`. Ist `listUpToDate` falsch, nutzt der Assistent die alte Liste: Öffne ein neues Gespräch oder verbinde den Connector neu.

**Frag so:** *„Ein Aufruf von dir ist fehlgeschlagen. Ist deine Tool-Liste von Memberfy aktuell?“*

## Verwandte Artikel

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