# Werkzeuge · Zertifikate

> MCP-Tools für Zertifikate: Vorlagen auflisten, anlegen, duplizieren und bearbeiten (im Design der Plattform oder mit dem Design der Marke, mit der Vorschau im Gespräch), aktivieren, wer im Bereich ausstellt, für Personen, Gruppen und Tags ausstellen, die E-Mail erneut senden, Fehlgeschlagenes neu erzeugen, widerrufen, neu ausstellen und löschen, und deine eigenen Zertifikate.

Alles, was der Bereich [Zertifikate](/espacos/certificados) kann, im Gespräch: die Vorlage vorbereiten (mit der Vorschau als Bild, damit du sie vorher prüfst), aktivieren, für eine ganze Klasse ausstellen und sich um bereits Ausgestelltes kümmern. Widerrufen und Löschen brauchen deine Bestätigung. Das Ausstellen läuft beim ersten Aufruf, deshalb macht der Assistent vorher einen Probelauf (`dry_run`), der sagt, wie viele Personen eines bekommen und wer ausgelassen wird.

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_certificate_templates`](#list-certificate-templates) | Vorlagen eines Zertifikate-Bereichs | Moderator oder Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_certificate_template`](#get-certificate-template) | Eine Vorlage, mit der Vorschau als Bild | Moderator oder Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_certificate_template`](#create-certificate-template) | Legt eine Vorlage an, im Design der Plattform oder mit dem Design der Marke | Moderator oder Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_certificate_template`](#update-certificate-template) | Ändert Texte, Unterzeichnende, Felder und Design | Moderator oder Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`activate_certificate_template`](#activate-certificate-template) | Aktiviert oder archiviert eine Vorlage | Moderator oder Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`issue_certificate`](#issue-certificate) | Stellt für Personen, Gruppen und Tags aus, nach einem Probelauf | Moderator oder Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_issued_certificates`](#list-issued-certificates) | Die ausgestellten, mit Status und Suche | Moderator oder Administrator | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`revoke_certificate`](#revoke-certificate) | Widerruft ein Zertifikat | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`reissue_certificate`](#reissue-certificate) | Stellt mit dem aktuellen Namen neu aus | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_certificate`](#delete-certificate) | Löscht ein widerrufenes oder fehlgeschlagenes Zertifikat | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`duplicate_certificate_template`](#duplicate-certificate-template) | Kopiert eine Vorlage als neuen Entwurf | Moderator oder Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_certificate_space_settings`](#update-certificate-space-settings) | Wer im Bereich ausstellt: das Team oder nur die Administratoren | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`resend_certificate_email`](#resend-certificate-email) | Sendet die E-Mail des Zertifikats erneut | Moderator oder Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`retry_certificate`](#retry-certificate) | Erzeugt ein fehlgeschlagenes Zertifikat neu | Moderator oder Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_my_certificates`](#list-my-certificates) | Deine Zertifikate, mit Code und Links | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`set_certificate_indexing`](#set-certificate-indexing) | Zeigt oder verbirgt eines deiner Zertifikate in Suchmaschinen | Alle | <span class="tool-kind tool-kind-write">Ändert</span> |

## `list_certificate_templates`

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

**Zertifikatsvorlagen auflisten.** Die Vorlagen eines Zertifikate-Bereichs, mit Name, Slug, Typ und Status. *Rolle: wer im Bereich Vorlagen verwaltet (Moderator oder Administrator, je nach **Wer ausstellt**).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `space` | ID oder Link | Nein | Der Zertifikate-Bereich. Ohne Angabe der einzige der Community |
| `status` | `DRAFT`, `ACTIVE`, `ARCHIVED` | Nein | Entwurf, aktiv oder archiviert |

**Liefert:** die Vorlagen, mit ID, Name, Slug, Typ (`PLATFORM`, das Design der Plattform, oder `IMAGE`, das eigene Design) und Status. Nur aktive Vorlagen stellen aus.

**Frag so:** *„Welche Zertifikatsvorlagen sind aktiv?“*

## `get_certificate_template`

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

**Zertifikatsvorlage ansehen.** Eine Vorlage mit den Texten, den Unterzeichnenden und den Feldern, und **die Vorschau als Bild**, das im Gespräch erscheint. *Rolle: wer Vorlagen verwaltet.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `template` | ID oder Slug | Ja | Die Vorlage |
| `space` | ID oder Link | Nein | Der Zertifikate-Bereich |

**Liefert:** die Vorlage und das Vorschaubild, mit einem Testnamen.

**Frag so:** *„Zeig mir, wie die Vorlage Kursabschluss aussieht.“*

## `create_certificate_template`

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

**Zertifikatsvorlage anlegen.** Legt eine Vorlage **als Entwurf** an und liefert die Vorschau als Bild, im Gespräch, damit du sie prüfen kannst. *Rolle: wer im Bereich Vorlagen verwaltet.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `name` | Text | Ja | Der interne Name der Vorlage |
| `title` | Text, bis 255 | Ja | Der gedruckte Titel, z. B. *Abschlusszertifikat* |
| `type` | `PLATFORM`, `IMAGE` | Nein | Standard: `PLATFORM`, das Design von Memberfy mit dem Logo und den Farben der Community. `IMAGE` nutzt das Design deiner Marke |
| `description` | Text, bis 5.000 | Nein | Der Text, mit `{nome}`, `{assunto}` und `{cargaHoraria}`. Ein Abschnitt in eckigen Klammern entfällt, wenn seine Variable leer ist: *„hat[ {assunto}] abgeschlossen, mit {cargaHoraria} Stunden“* |
| `workload_hours` | Zahl | Nein | |
| `slug` | Text | Nein | Die Kurzadresse der Vorlage |
| `language`, `timezone` | Text | Nein | Z. B. `from-DE`, `Europe/Berlin`. Standard: die der Community |
| `signers` | Liste, bis 2 | Nein | Je mit `name`, `role` und der Unterschrift über `signature_url` (ein PNG mit transparentem Hintergrund) oder `signature_base64` |
| `image_url` oder `image_base64` | Link oder Datei | Bei `IMAGE` | Das Design, PNG oder JPEG, mindestens 2.000 px breit |
| `layout` | Liste von Feldern | Nein | Nur bei `IMAGE`: wo jedes Feld hinkommt (`recipientName`, `issuedAt`, `qr`, `title`, `description`, `workload`, `subjectTitle`, `code`, `signer1`, `signer2`), in % des Designs, mit Schrift, Größe, Farbe und Ausrichtung. Ohne Angabe gelten die **Standardfelder**: der Name in der Mitte, das Datum unten links und der QR-Code unten rechts |
| `font` | `inter`, `montserrat`, `lora`, `playfair-display`, `eb-garamond`, `great-vibes`, `noto-sans` | Nein | Die Schrift des Namens in den Standardfeldern |
| `text_color` | Farbe in Hex | Nein | Die Textfarbe in den Standardfeldern |

**Liefert:** die angelegte Vorlage, als Entwurf, und das Vorschaubild.

**Frag so:** *„Leg eine Zertifikatsvorlage mit dem Design unserer Marke an: https://…/design.png. Titel Abschlusszertifikat.“*

**Hinweise:** Zum Ausstellen aktivierst du sie mit `activate_certificate_template`. Siehe das Rezept [Eine Vorlage mit dem Design der Marke anlegen](/mcp/receitas#12-eine-vorlage-mit-dem-design-der-marke-anlegen) und [Zertifikate](/espacos/certificados).

## `update_certificate_template`

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

**Zertifikatsvorlage bearbeiten.** Ändert Texte, Stundenumfang, Unterzeichnende, Layoutfelder, Sprache, Zeitzone und das Design. Liefert die neue Vorschau. *Rolle: wer Vorlagen verwaltet.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `template` | ID oder Slug | Ja | Die Vorlage |
| Die übrigen | | Nein | Dieselben wie bei `create_certificate_template`, außer `type`; nur Gesendetes ändert sich |

**Liefert:** die Vorlage und das Vorschaubild.

**Frag so:** *„Setz den Namen etwas höher und mach das Datum grau.“*

**Hinweise:** Hat die Vorlage schon ausgestellt, steigt die Version, und bereits ausgestellte Zertifikate bleiben, wie sie herausgegangen sind.

## `activate_certificate_template`

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

**Vorlage aktivieren oder archivieren.** Aktiviert eine Vorlage (nur aktive Vorlagen stellen aus) oder archiviert sie. *Rolle: wer Vorlagen verwaltet.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `template` | ID oder Slug | Ja | Die Vorlage |
| `space` | ID oder Link | Nein | |
| `action` | `activate`, `archive` | Nein | Standard: `activate` |

**Frag so:** *„Du kannst die Vorlage aktivieren.“*

## `issue_certificate`

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

**Zertifikate ausstellen.** Stellt Zertifikate einer aktiven Vorlage für Personen, Gruppen und Tags aus, mit Thema und Stundenumfang. *Rolle: wer im Bereich ausstellt.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `template` | ID oder Slug | Ja | Eine aktive Vorlage |
| `people` | Liste von Profil-IDs, bis 1.000 | Nein | Aus `list_members` |
| `groups` | Liste von IDs, bis 100 | Nein | Aus `list_groups` |
| `tags` | Liste von Namen, bis 100 | Nein | |
| `subject` | Text | Nein | Was abgeschlossen wurde, z. B. *Excel von null* (das `{assunto}` im Text) |
| `workload_hours` | Zahl | Nein | |
| `send_email` | ja oder nein | Nein | Standard: ja |
| `issue_anyway` | ja oder nein | Nein | Stellt auch für alle aus, die schon ein gültiges Zertifikat dieser Vorlage haben. Standard: nein |
| `dry_run` | ja oder nein | Nein | Nur der **Probelauf**: sagt, wer eines bekommt und wer ausgelassen wird, ohne etwas auszustellen. Standard: nein |
| `space` | ID oder Link | Nein | |

**Liefert:** mit `dry_run: true` den **Probelauf**: wie viele Personen eines bekommen, wer ausgelassen wird und warum (zum Beispiel, wer schon ein gültiges hat). Es wird nichts ausgestellt. Ohne `dry_run` die Ausstellung.

**Frag so:** *„Stell das Abschlusszertifikat für die Gruppe Klasse März aus, Thema Excel von null, 40 Stunden.“*

**Hinweise:** Jede Person bekommt eine E-Mail, deshalb macht der Assistent zuerst den Probelauf, zeigt, wer eines bekommt und wer ausgelassen wird, und stellt erst nach deinem Okay aus. Wer in mehreren Gruppen oder Tags ist, bekommt nur ein Zertifikat. Siehe das Rezept [Zertifikate für die Klasse ausstellen](/mcp/receitas#11-zertifikate-fur-die-klasse-ausstellen).

## `list_issued_certificates`

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

**Ausgestellte Zertifikate auflisten.** Die Zertifikate eines Bereichs, mit Filter nach Vorlage und Status und Suche nach Name oder Code. *Rolle: wer im Bereich ausstellt.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `space` | ID oder Link | Nein | |
| `template` | ID oder Slug | Nein | |
| `status` | `PENDING`, `ISSUED`, `FAILED`, `REVOKED` | Nein | Wird erzeugt, ausgestellt, fehlgeschlagen, widerrufen |
| `search` | Text | Nein | Name oder Code |
| `page`, `limit` | Zahl | Nein | Seitenweise |

**Frag so:** *„Ist ein Zertifikat der Klasse März fehlgeschlagen?“*

## `revoke_certificate`

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

**Zertifikat widerrufen.** Widerruft ein Zertifikat, mit einer internen Begründung. Die öffentliche Verifizierungsseite zeigt dann, dass es widerrufen wurde. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `certificate` | ID oder Link | Ja | |
| `reason` | Text | Ja | Intern; niemand von außen sieht sie |

**Frag so:** *„Widerrufe das Zertifikat K7Q3-9XWD-2MFA, es wurde versehentlich ausgestellt.“*

## `reissue_certificate`

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

**Zertifikat neu ausstellen.** Stellt es erneut aus, mit dem aktuellen Namen der Person. Das alte bleibt widerrufen und ist mit dem neuen verknüpft. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `certificate` | ID oder Link | Ja | |
| `send_email` | ja oder nein | Nein | Standard: ja |

**Frag so:** *„Ana hat ihren Namen im Profil korrigiert; stell ihr Zertifikat neu aus.“*

## `delete_certificate`

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

**Zertifikat löschen.** Löscht ein widerrufenes oder fehlgeschlagenes Zertifikat. Ein gültiges Zertifikat muss vorher widerrufen werden. *Mindestrolle: Administrator.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `certificate` | ID oder Link | Ja | |

**Frag so:** *„Lösche die Zertifikate, die bei der gestrigen Ausstellung fehlgeschlagen sind.“*

## `duplicate_certificate_template`

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

**Zertifikatvorlage duplizieren.** Kopiert eine Vorlage als neuen Entwurf, damit du sie anpassen kannst, ohne das Original anzufassen. *Rolle: wer im Bereich ausstellt.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `template_id` | ID | Ja | Aus `list_certificate_templates` |

**Frag so:** *„Dupliziere das Abschlusszertifikat, damit ich die Version für die Teilnahme machen kann.“*

## `update_certificate_space_settings`

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

**Ändern, wer Zertifikate ausstellt.** Legt in einem Zertifikate-Bereich fest, wer ausstellt: das Team (ab Moderator) oder nur die Administratoren. *Mindestrolle: Administrator.*

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

**Hinweise:** Das ändert sofort, wer was tun darf.

## `resend_certificate_email`

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

**Zertifikat-E-Mail erneut senden.** Sendet die E-Mail *„Dein Zertifikat ist da“* eines ausgestellten Zertifikats noch einmal. *Rolle: wer im Bereich ausstellt.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `certificate` | ID oder Link | Ja | |

**Frag so:** *„Ana findet die E-Mail mit dem Zertifikat nicht; schick sie noch einmal.“*

## `retry_certificate`

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

**Fehlgeschlagenes Zertifikat neu erzeugen.** Erzeugt ein Zertifikat, dessen Erstellung fehlgeschlagen ist, noch einmal und schickt standardmäßig die E-Mail, sobald es fertig ist. *Rolle: wer im Bereich ausstellt.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `certificate` | ID oder Link | Ja | |
| `send_email` | ja oder nein | Nein | Standard: ja |

## `list_my_certificates`

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

**Meine Zertifikate.** Deine Zertifikate in der Community, mit dem Prüfcode und den Links. *Mindestrolle: alle.*

Parameter: keine.

**Frag so:** *„Gib mir den Link zu meinem Zertifikat von Excel von null an.“*

## `set_certificate_indexing`

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

**Zertifikat in Suchmaschinen zeigen.** Schaltet **In Suchmaschinen anzeigen** auf der öffentlichen Prüfseite eines deiner Zertifikate ein oder aus. *Rolle: wer das Zertifikat erhalten hat.*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `certificate_id` | ID | Ja | Aus `list_my_certificates` |
| `indexable` | ja oder nein | Ja | |

## Verwandte Artikel

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