Strumenti · Certificati
Strumenti MCP per i certificati: elencare, creare, duplicare e modificare modelli (dal design della piattaforma o con la grafica del brand, con l'anteprima nella conversazione), attivare, chi rilascia nello spazio, rilasciare a persone, gruppi e tag, reinviare l'e-mail, rifare ciò che è fallito, revocare, rilasciare di nuovo ed eliminare, e i tuoi certificati.
Tutto ciò che fa lo spazio Certificati, dalla conversazione: preparare il modello (con l'anteprima come immagine, per controllarlo prima), attivarlo, rilasciarlo a un'intera classe e gestire ciò che è già stato rilasciato. Revocare ed eliminare chiedono la tua conferma. Il rilascio avviene alla prima chiamata, per questo l'assistente fa prima una prova (dry_run) che dice quante persone lo ricevono e chi resta fuori.
Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
list_certificate_templates | Modelli di uno spazio Certificati | Moderatore o Admin | Solo lettura |
get_certificate_template | Un modello, con l'anteprima come immagine | Moderatore o Admin | Solo lettura |
create_certificate_template | Crea un modello, dal design della piattaforma o con la grafica del brand | Moderatore o Admin | Modifica |
update_certificate_template | Cambia testi, firmatari, caselle e grafica | Moderatore o Admin | Modifica |
activate_certificate_template | Attiva o archivia un modello | Moderatore o Admin | Modifica |
issue_certificate | Rilascia a persone, gruppi e tag, dopo una prova | Moderatore o Admin | Modifica |
list_issued_certificates | I rilasciati, con stato e ricerca | Moderatore o Admin | Solo lettura |
revoke_certificate | Revoca un certificato | Admin | Chiede conferma |
reissue_certificate | Rilascia di nuovo con il nome attuale | Admin | Modifica |
delete_certificate | Elimina un certificato revocato o fallito | Admin | Chiede conferma |
duplicate_certificate_template | Copia un modello come nuova bozza | Moderatore o Admin | Modifica |
update_certificate_space_settings | Chi rilascia nello spazio: lo staff o solo gli Admin | Admin | Modifica |
resend_certificate_email | Invia di nuovo l'e-mail del certificato | Moderatore o Admin | Modifica |
retry_certificate | Rifà un certificato fallito | Moderatore o Admin | Modifica |
list_my_certificates | I tuoi certificati, con codice e link | Qualsiasi | Solo lettura |
set_certificate_indexing | Mostra o nasconde un tuo certificato nei motori di ricerca | Qualsiasi | Modifica |
list_certificate_templates
Solo lettura
Elencare i modelli di certificato. I modelli di uno spazio Certificati, con nome, slug, tipo e stato. Ruolo: chi gestisce i modelli nello spazio (moderatore o Admin, secondo Chi rilascia).
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | No | Lo spazio Certificati. Senza, l'unico della community |
status | DRAFT, ACTIVE, ARCHIVED | No | Bozza, attivo o archiviato |
Restituisce: i modelli, con id, nome, slug, tipo (PLATFORM, il design della piattaforma, o IMAGE, la grafica propria) e stato. Solo i modelli attivi rilasciano.
Chiedi così: "Quali modelli di certificato sono attivi?"
get_certificate_template
Solo lettura
Vedere un modello di certificato. Un modello con i testi, i firmatari e le caselle, e l'anteprima come immagine, che compare nella conversazione. Ruolo: chi gestisce i modelli.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
template | id o slug | Sì | Il modello |
space | id o link | No | Lo spazio Certificati |
Restituisce: il modello e l'immagine dell'anteprima, con un nome di prova.
Chiedi così: "Mostrami com'è il modello Completamento del corso."
create_certificate_template
Modifica
Creare un modello di certificato. Crea un modello in bozza e restituisce l'anteprima come immagine, nella conversazione, perché tu possa controllarla. Ruolo: chi gestisce i modelli nello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name | testo | Sì | Il nome interno del modello |
title | testo, fino a 255 | Sì | Il titolo stampato, es.: Certificato di completamento |
type | PLATFORM, IMAGE | No | Predefinito: PLATFORM, il design di Memberfy con il logo e i colori della community. IMAGE usa la grafica del tuo brand |
description | testo, fino a 5.000 | No | Il testo, con {nome}, {assunto} e {cargaHoraria}. Un tratto tra parentesi quadre sparisce quando la sua variabile è vuota: "ha concluso[ {assunto}], con un carico di {cargaHoraria} ore" |
workload_hours | numero | No | |
slug | testo | No | L'indirizzo breve del modello |
language, timezone | testo | No | Es.: it-IT, Europe/Rome. Predefiniti: quelli della community |
signers | elenco, fino a 2 | No | Ognuno con name, role e la firma tramite signature_url (un PNG con sfondo trasparente) o signature_base64 |
image_url o image_base64 | link o file | Con IMAGE | La grafica, PNG o JPEG, larga almeno 2.000 px |
layout | elenco di caselle | No | Solo con IMAGE: dove va ogni campo (recipientName, issuedAt, qr, title, description, workload, subjectTitle, code, signer1, signer2), in % della grafica, con font, dimensione, colore e allineamento. Senza, valgono le caselle predefinite: il nome al centro, la data in basso a sinistra e il QR in basso a destra |
font | inter, montserrat, lora, playfair-display, eb-garamond, great-vibes, noto-sans | No | Il font del nome nelle caselle predefinite |
text_color | colore in hex | No | Il colore del testo nelle caselle predefinite |
Restituisce: il modello creato, in bozza, e l'immagine dell'anteprima.
Chiedi così: "Crea un modello di certificato con la grafica del nostro brand: https://…/grafica.png. Titolo Certificato di completamento."
Note: per rilasciare, attivalo con activate_certificate_template. Vedi la ricetta Creare un modello con la grafica del brand e Certificati.
update_certificate_template
Modifica
Modificare un modello di certificato. Cambia testi, carico orario, firmatari, caselle del layout, lingua, fuso orario e la grafica. Restituisce la nuova anteprima. Ruolo: chi gestisce i modelli.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
template | id o slug | Sì | Il modello |
| Gli altri | No | Gli stessi di create_certificate_template, tranne type; cambia solo ciò che viene inviato |
Restituisce: il modello e l'immagine dell'anteprima.
Chiedi così: "Alza un po' il nome e metti la data in grigio."
Note: se il modello ha già rilasciato certificati, la versione sale, e i certificati già rilasciati restano come sono usciti.
activate_certificate_template
Modifica
Attivare o archiviare un modello. Attiva un modello (solo i modelli attivi rilasciano) o lo archivia. Ruolo: chi gestisce i modelli.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
template | id o slug | Sì | Il modello |
space | id o link | No | |
action | activate, archive | No | Predefinito: activate |
Chiedi così: "Puoi attivare il modello."
issue_certificate
Modifica
Rilasciare certificati. Rilascia certificati di un modello attivo a persone, gruppi e tag, con l'argomento e il carico orario. Ruolo: chi rilascia nello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
template | id o slug | Sì | Un modello attivo |
people | elenco di id di profilo, fino a 1.000 | No | Da list_members |
groups | elenco di id, fino a 100 | No | Da list_groups |
tags | elenco di nomi, fino a 100 | No | |
subject | testo | No | Ciò che è stato concluso, es.: Excel da zero (l'{assunto} del testo) |
workload_hours | numero | No | |
send_email | sì o no | No | Predefinito: sì |
issue_anyway | sì o no | No | Rilascia anche a chi ha già un certificato valido di questo modello. Predefinito: no |
dry_run | sì o no | No | Solo la prova: dice chi riceve e chi resta fuori, senza rilasciare nulla. Predefinito: no |
space | id o link | No |
Restituisce: con dry_run: true, la prova: quante persone lo ricevono, chi viene saltato e perché (per esempio chi ne ha già uno valido). Non viene rilasciato nulla. Senza dry_run, il rilascio.
Chiedi così: "Rilascia il certificato di completamento al gruppo Classe di marzo, argomento Excel da zero, 40 ore."
Note: ogni persona riceve un'e-mail, per questo l'assistente esegue prima la prova, mostra chi riceve e chi resta fuori, e rilascia solo dopo il tuo ok. Chi è in più gruppi o tag riceve un solo certificato. Vedi la ricetta Rilasciare certificati alla classe.
list_issued_certificates
Solo lettura
Elencare i certificati rilasciati. I certificati di uno spazio, con filtro per modello e stato e ricerca per nome o codice. Ruolo: chi rilascia nello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | No | |
template | id o slug | No | |
status | PENDING, ISSUED, FAILED, REVOKED | No | In generazione, rilasciato, fallito, revocato |
search | testo | No | Nome o codice |
page, limit | numero | No | Paginazione |
Chiedi così: "Qualche certificato della classe di marzo è fallito?"
revoke_certificate
Chiede conferma
Revocare un certificato. Revoca un certificato, con un motivo interno. La pagina pubblica di verifica inizia a dire che è stato revocato. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
certificate | id o link | Sì | |
reason | testo | Sì | Interno; nessuno da fuori lo vede |
Chiedi così: "Revoca il certificato K7Q3-9XWD-2MFA, rilasciato per errore."
reissue_certificate
Modifica
Rilasciare di nuovo un certificato. Lo rilascia di nuovo, con il nome attuale della persona. Il vecchio resta revocato e collegato al nuovo. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
certificate | id o link | Sì | |
send_email | sì o no | No | Predefinito: sì |
Chiedi così: "Ana ha corretto il nome nel profilo; rilascia di nuovo il suo certificato."
delete_certificate
Chiede conferma
Eliminare un certificato. Elimina un certificato revocato o fallito. Un certificato valido va revocato prima. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
certificate | id o link | Sì |
Chiedi così: "Elimina i certificati falliti nel rilascio di ieri."
duplicate_certificate_template
Modifica
Duplica modello di certificato. Copia un modello come nuova bozza, per sistemarlo senza toccare l'originale. Ruolo: chi rilascia nello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
template_id | id | Sì | Da list_certificate_templates |
Chiedi così: "Duplica il Certificato di completamento, così preparo la versione di partecipazione."
update_certificate_space_settings
Modifica
Cambia chi emette certificati. Stabilisce, in uno spazio Certificati, chi rilascia: lo staff (dal moderatore in su) o solo gli Admin. Ruolo minimo: Admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id, link, indirizzo o nome | Sì | |
who_can_issue | staff, admins | Sì |
Note: cambia subito chi può fare cosa.
resend_certificate_email
Modifica
Reinvia e-mail del certificato. Invia di nuovo l'e-mail "Il tuo certificato è arrivato" di un certificato rilasciato. Ruolo: chi rilascia nello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
certificate | id o link | Sì |
Chiedi così: "Ana non trova l'e-mail del certificato; rimandagliela."
retry_certificate
Modifica
Riprova certificato fallito. Genera di nuovo un certificato la cui generazione è fallita e, per impostazione predefinita, invia l'e-mail quando è pronto. Ruolo: chi rilascia nello spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
certificate | id o link | Sì | |
send_email | sì o no | No | Predefinito: sì |
list_my_certificates
Solo lettura
I miei certificati. I tuoi certificati nella community, con il codice di verifica e i link. Ruolo minimo: qualsiasi.
Parametri: nessuno.
Chiedi così: "Dammi il link del mio certificato di Excel da Zero."
set_certificate_indexing
Modifica
Mostra certificato nei motori di ricerca. Attiva o disattiva Mostra nei motori di ricerca nella pagina pubblica di verifica di un tuo certificato. Ruolo: chi ha ricevuto il certificato.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
certificate_id | id | Sì | Da list_my_certificates |
indexable | sì o no | Sì |