Vai al contenuto

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

StrumentoCosa faRuolo minimoTipo
list_certificate_templatesModelli di uno spazio CertificatiModeratore o AdminSolo lettura
get_certificate_templateUn modello, con l'anteprima come immagineModeratore o AdminSolo lettura
create_certificate_templateCrea un modello, dal design della piattaforma o con la grafica del brandModeratore o AdminModifica
update_certificate_templateCambia testi, firmatari, caselle e graficaModeratore o AdminModifica
activate_certificate_templateAttiva o archivia un modelloModeratore o AdminModifica
issue_certificateRilascia a persone, gruppi e tag, dopo una provaModeratore o AdminModifica
list_issued_certificatesI rilasciati, con stato e ricercaModeratore o AdminSolo lettura
revoke_certificateRevoca un certificatoAdminChiede conferma
reissue_certificateRilascia di nuovo con il nome attualeAdminModifica
delete_certificateElimina un certificato revocato o fallitoAdminChiede conferma
duplicate_certificate_templateCopia un modello come nuova bozzaModeratore o AdminModifica
update_certificate_space_settingsChi rilascia nello spazio: lo staff o solo gli AdminAdminModifica
resend_certificate_emailInvia di nuovo l'e-mail del certificatoModeratore o AdminModifica
retry_certificateRifà un certificato fallitoModeratore o AdminModifica
list_my_certificatesI tuoi certificati, con codice e linkQualsiasiSolo lettura
set_certificate_indexingMostra o nasconde un tuo certificato nei motori di ricercaQualsiasiModifica

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).

ParametroTipoObbligatorioDescrizione
spaceid o linkNoLo spazio Certificati. Senza, l'unico della community
statusDRAFT, ACTIVE, ARCHIVEDNoBozza, 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.

ParametroTipoObbligatorioDescrizione
templateid o slugSìIl modello
spaceid o linkNoLo 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.

ParametroTipoObbligatorioDescrizione
nametestoSìIl nome interno del modello
titletesto, fino a 255SìIl titolo stampato, es.: Certificato di completamento
typePLATFORM, IMAGENoPredefinito: PLATFORM, il design di Memberfy con il logo e i colori della community. IMAGE usa la grafica del tuo brand
descriptiontesto, fino a 5.000NoIl 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_hoursnumeroNo
slugtestoNoL'indirizzo breve del modello
language, timezonetestoNoEs.: it-IT, Europe/Rome. Predefiniti: quelli della community
signerselenco, fino a 2NoOgnuno con name, role e la firma tramite signature_url (un PNG con sfondo trasparente) o signature_base64
image_url o image_base64link o fileCon IMAGELa grafica, PNG o JPEG, larga almeno 2.000 px
layoutelenco di caselleNoSolo 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
fontinter, montserrat, lora, playfair-display, eb-garamond, great-vibes, noto-sansNoIl font del nome nelle caselle predefinite
text_colorcolore in hexNoIl 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.

ParametroTipoObbligatorioDescrizione
templateid o slugSìIl modello
Gli altriNoGli 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.

ParametroTipoObbligatorioDescrizione
templateid o slugSìIl modello
spaceid o linkNo
actionactivate, archiveNoPredefinito: 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.

ParametroTipoObbligatorioDescrizione
templateid o slugSìUn modello attivo
peopleelenco di id di profilo, fino a 1.000NoDa list_members
groupselenco di id, fino a 100NoDa list_groups
tagselenco di nomi, fino a 100No
subjecttestoNoCiò che è stato concluso, es.: Excel da zero (l'{assunto} del testo)
workload_hoursnumeroNo
send_emailsì o noNoPredefinito: sì
issue_anywaysì o noNoRilascia anche a chi ha già un certificato valido di questo modello. Predefinito: no
dry_runsì o noNoSolo la prova: dice chi riceve e chi resta fuori, senza rilasciare nulla. Predefinito: no
spaceid o linkNo

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.

ParametroTipoObbligatorioDescrizione
spaceid o linkNo
templateid o slugNo
statusPENDING, ISSUED, FAILED, REVOKEDNoIn generazione, rilasciato, fallito, revocato
searchtestoNoNome o codice
page, limitnumeroNoPaginazione

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.

ParametroTipoObbligatorioDescrizione
certificateid o linkSì
reasontestoSì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.

ParametroTipoObbligatorioDescrizione
certificateid o linkSì
send_emailsì o noNoPredefinito: 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.

ParametroTipoObbligatorioDescrizione
certificateid o linkSì

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.

ParametroTipoObbligatorioDescrizione
template_ididSì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.

ParametroTipoObbligatorioDescrizione
spaceid, link, indirizzo o nomeSì
who_can_issuestaff, adminsSì

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.

ParametroTipoObbligatorioDescrizione
certificateid o linkSì

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.

ParametroTipoObbligatorioDescrizione
certificateid o linkSì
send_emailsì o noNoPredefinito: 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.

ParametroTipoObbligatorioDescrizione
certificate_ididSìDa list_my_certificates
indexablesì o noSì

Correlati