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 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: 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_certificate_templates | Vorlagen eines Zertifikate-Bereichs | Moderator oder Administrator | Nur lesen |
get_certificate_template | Eine Vorlage, mit der Vorschau als Bild | Moderator oder Administrator | Nur lesen |
create_certificate_template | Legt eine Vorlage an, im Design der Plattform oder mit dem Design der Marke | Moderator oder Administrator | Ändert |
update_certificate_template | Ändert Texte, Unterzeichnende, Felder und Design | Moderator oder Administrator | Ändert |
activate_certificate_template | Aktiviert oder archiviert eine Vorlage | Moderator oder Administrator | Ändert |
issue_certificate | Stellt für Personen, Gruppen und Tags aus, nach einem Probelauf | Moderator oder Administrator | Ändert |
list_issued_certificates | Die ausgestellten, mit Status und Suche | Moderator oder Administrator | Nur lesen |
revoke_certificate | Widerruft ein Zertifikat | Administrator | Mit Bestätigung |
reissue_certificate | Stellt mit dem aktuellen Namen neu aus | Administrator | Ändert |
delete_certificate | Löscht ein widerrufenes oder fehlgeschlagenes Zertifikat | Administrator | Mit Bestätigung |
duplicate_certificate_template | Kopiert eine Vorlage als neuen Entwurf | Moderator oder Administrator | Ändert |
update_certificate_space_settings | Wer im Bereich ausstellt: das Team oder nur die Administratoren | Administrator | Ändert |
resend_certificate_email | Sendet die E-Mail des Zertifikats erneut | Moderator oder Administrator | Ändert |
retry_certificate | Erzeugt ein fehlgeschlagenes Zertifikat neu | Moderator oder Administrator | Ändert |
list_my_certificates | Deine Zertifikate, mit Code und Links | Alle | Nur lesen |
set_certificate_indexing | Zeigt oder verbirgt eines deiner Zertifikate in Suchmaschinen | Alle | Ändert |
list_certificate_templates
Nur lesen
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
Nur lesen
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
Ändert
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 und Zertifikate.
update_certificate_template
Ändert
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
Ändert
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
Ändert
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.
list_issued_certificates
Nur lesen
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
Mit Bestätigung
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
Ändert
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
Mit Bestätigung
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
Ändert
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
Ändert
Ä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
Ändert
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
Ändert
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
Nur lesen
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
Ändert
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 |