# 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](/espacos/certificados), 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: <span class="tool-kind tool-kind-read">Solo lettura</span> non cambia nulla, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia qualcosa subito, e <span class="tool-kind tool-kind-confirm">Chiede conferma</span> agisce solo dopo il tuo sì a un riepilogo. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

## In sintesi

| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
| [`list_certificate_templates`](#list-certificate-templates) | Modelli di uno spazio Certificati | Moderatore o Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_certificate_template`](#get-certificate-template) | Un modello, con l'anteprima come immagine | Moderatore o Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_certificate_template`](#create-certificate-template) | Crea un modello, dal design della piattaforma o con la grafica del brand | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_certificate_template`](#update-certificate-template) | Cambia testi, firmatari, caselle e grafica | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`activate_certificate_template`](#activate-certificate-template) | Attiva o archivia un modello | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`issue_certificate`](#issue-certificate) | Rilascia a persone, gruppi e tag, dopo una prova | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_issued_certificates`](#list-issued-certificates) | I rilasciati, con stato e ricerca | Moderatore o Admin | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`revoke_certificate`](#revoke-certificate) | Revoca un certificato | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`reissue_certificate`](#reissue-certificate) | Rilascia di nuovo con il nome attuale | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_certificate`](#delete-certificate) | Elimina un certificato revocato o fallito | Admin | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`duplicate_certificate_template`](#duplicate-certificate-template) | Copia un modello come nuova bozza | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_certificate_space_settings`](#update-certificate-space-settings) | Chi rilascia nello spazio: lo staff o solo gli Admin | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`resend_certificate_email`](#resend-certificate-email) | Invia di nuovo l'e-mail del certificato | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`retry_certificate`](#retry-certificate) | Rifà un certificato fallito | Moderatore o Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_my_certificates`](#list-my-certificates) | I tuoi certificati, con codice e link | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`set_certificate_indexing`](#set-certificate-indexing) | Mostra o nasconde un tuo certificato nei motori di ricerca | Qualsiasi | <span class="tool-kind tool-kind-write">Modifica</span> |

## `list_certificate_templates`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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](/mcp/receitas#12-creare-un-modello-con-la-grafica-del-brand) e [Certificati](/espacos/certificados).

## `update_certificate_template`

<span class="tool-kind tool-kind-write">Modifica</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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](/mcp/receitas#11-rilasciare-certificati-alla-classe).

## `list_issued_certificates`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**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`

<span class="tool-kind tool-kind-write">Modifica</span>

**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ì | |

## Correlati

- [Strumenti](/mcp/ferramentas)
- [Ricette](/mcp/receitas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)