Herramientas · Certificados
Herramientas MCP para certificados: listar, crear, duplicar y editar plantillas (con el diseño de la plataforma o el de la marca, con la vista previa en la conversación), activar, quién emite en el espacio, emitir para personas, grupos y etiquetas, reenviar el correo, rehacer lo que falló, revocar, reemitir y eliminar, y tus propios certificados.
Todo lo que hace el espacio Certificados, desde la conversación: montar la plantilla (con la vista previa como imagen, para que la compruebes antes), activarla, emitir para una clase entera y cuidar de lo que ya se ha emitido. Revocar y eliminar piden tu confirmación. La emisión se ejecuta en la primera llamada, por eso el asistente hace antes un ensayo (dry_run) que dice cuántas personas lo reciben y quién se queda fuera.
Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen. Consulta Dinero y confirmación.
En resumen
| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
list_certificate_templates | Las plantillas de un espacio de Certificados | Moderador o administrador | Solo consulta |
get_certificate_template | Una plantilla, con la vista previa como imagen | Moderador o administrador | Solo consulta |
create_certificate_template | Crea una plantilla, con el diseño de la plataforma o el de la marca | Moderador o administrador | Modifica |
update_certificate_template | Cambia textos, firmantes, cajas y el diseño | Moderador o administrador | Modifica |
activate_certificate_template | Activa o archiva una plantilla | Moderador o administrador | Modifica |
issue_certificate | Emite para personas, grupos y etiquetas, después de un ensayo | Moderador o administrador | Modifica |
list_issued_certificates | Los emitidos, con estado y búsqueda | Moderador o administrador | Solo consulta |
revoke_certificate | Revoca un certificado | Administrador | Pide confirmación |
reissue_certificate | Lo emite de nuevo con el nombre actual | Administrador | Modifica |
delete_certificate | Elimina uno revocado o que falló | Administrador | Pide confirmación |
duplicate_certificate_template | Copia una plantilla como un borrador nuevo | Moderador o administrador | Modifica |
update_certificate_space_settings | Quién emite en el espacio: el equipo o solo los administradores | Administrador | Modifica |
resend_certificate_email | Vuelve a enviar el correo del certificado | Moderador o administrador | Modifica |
retry_certificate | Rehace un certificado que falló | Moderador o administrador | Modifica |
list_my_certificates | Tus certificados, con código y enlaces | Cualquiera | Solo consulta |
set_certificate_indexing | Muestra u oculta un certificado tuyo en los buscadores | Cualquiera | Modifica |
list_certificate_templates
Solo consulta
Listar plantillas de certificado. Las plantillas de un espacio de Certificados, con nombre, slug, tipo y estado. Rol: quien gestiona plantillas en el espacio (moderador o administrador, según Quién emite).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | No | El espacio de Certificados. Sin él, el único de la comunidad |
status | DRAFT, ACTIVE, ARCHIVED | No | Borrador, activa o archivada |
Devuelve: las plantillas, con id, nombre, slug, tipo (PLATFORM, el diseño de la plataforma, o IMAGE, el diseño propio) y estado. Solo las plantillas activas emiten.
Pídelo así: "¿Qué plantillas de certificado están activas?"
get_certificate_template
Solo consulta
Ver plantilla de certificado. Una plantilla con los textos, los firmantes y las cajas, y la vista previa como imagen, que aparece en la conversación. Rol: quien gestiona plantillas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
template | id o slug | Sí | La plantilla |
space | id o enlace | No | El espacio de Certificados |
Devuelve: la plantilla y la imagen de la vista previa, con un nombre de prueba.
Pídelo así: "Enséñame cómo está la plantilla Finalización de curso."
create_certificate_template
Modifica
Crear plantilla de certificado. Crea una plantilla en borrador y devuelve la vista previa como imagen, en la conversación, para que la compruebes. Rol: quien gestiona plantillas en el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
name | texto | Sí | El nombre interno de la plantilla |
title | texto, hasta 255 | Sí | El título impreso, p. ej. Certificado de finalización |
type | PLATFORM, IMAGE | No | Por defecto: PLATFORM, el diseño de Memberfy con el logo y los colores de la comunidad. IMAGE usa el diseño de tu marca |
description | texto, hasta 5.000 | No | El texto, con {nome}, {assunto} y {cargaHoraria}. Un fragmento entre corchetes desaparece cuando su variable viene vacía: "concluiu[ {assunto}], com carga de {cargaHoraria} horas" |
workload_hours | número | No | |
slug | texto | No | La dirección corta de la plantilla |
language, timezone | texto | No | P. ej. pt-BR, America/Sao_Paulo. Por defecto: los de la comunidad |
signers | lista, hasta 2 | No | Cada uno con name, role y la firma como signature_url (un PNG con fondo transparente) o signature_base64 |
image_url o image_base64 | enlace o archivo | En IMAGE | El diseño, PNG o JPEG, de al menos 2.000 px de ancho |
layout | lista de cajas | No | Solo en IMAGE: dónde va cada campo (recipientName, issuedAt, qr, title, description, workload, subjectTitle, code, signer1, signer2), en % del diseño, con fuente, tamaño, color y alineación. Sin él, se usan las cajas por defecto: el nombre en el centro, la fecha abajo a la izquierda y el QR abajo a la derecha |
font | inter, montserrat, lora, playfair-display, eb-garamond, great-vibes, noto-sans | No | La fuente del nombre en las cajas por defecto |
text_color | color en hex | No | El color del texto en las cajas por defecto |
Devuelve: la plantilla creada, en borrador, y la imagen de la vista previa.
Pídelo así: "Crea una plantilla de certificado con el diseño de nuestra marca: https://…/diseno.png. Título Certificado de finalización."
Notas: para emitir, actívala con activate_certificate_template. Consulta la receta Crear una plantilla con el diseño de la marca y Certificados.
update_certificate_template
Modifica
Editar plantilla de certificado. Cambia textos, carga horaria, firmantes, cajas del diseño, idioma, zona horaria y el diseño. Devuelve la vista previa nueva. Rol: quien gestiona plantillas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
template | id o slug | Sí | La plantilla |
| Los demás | No | Los mismos de create_certificate_template, menos type; solo cambia lo que se envíe |
Devuelve: la plantilla y la imagen de la vista previa.
Pídelo así: "Sube un poco el nombre y pon la fecha en gris."
Notas: si la plantilla ya ha emitido, sube de versión, y los certificados ya emitidos se quedan como salieron.
activate_certificate_template
Modifica
Activar o archivar plantilla. Activa una plantilla (solo las activas emiten) o la archiva. Rol: quien gestiona plantillas.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
template | id o slug | Sí | La plantilla |
space | id o enlace | No | |
action | activate, archive | No | Por defecto: activate |
Pídelo así: "Ya puedes activar la plantilla."
issue_certificate
Modifica
Emitir certificados. Emite certificados de una plantilla activa para personas, grupos y etiquetas, con el asunto y la carga horaria. Rol: quien emite en el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
template | id o slug | Sí | Una plantilla activa |
people | lista de ids de perfil, hasta 1.000 | No | De list_members |
groups | lista de ids, hasta 100 | No | De list_groups |
tags | lista de nombres, hasta 100 | No | |
subject | texto | No | Lo que se ha completado, p. ej. Excel desde cero (el {assunto} del texto) |
workload_hours | número | No | |
send_email | sí o no | No | Por defecto: sí |
issue_anyway | sí o no | No | Emite también para quien ya tiene un certificado vigente de esta plantilla. Por defecto: no |
dry_run | sí o no | No | Solo el ensayo: dice quién lo recibe y quién se queda fuera, sin emitir nada. Por defecto: no |
space | id o enlace | No |
Devuelve: con dry_run: true, el ensayo: cuántas personas lo reciben, a quién se salta y por qué (por ejemplo, quien ya tiene uno vigente). No se emite nada. Sin dry_run, la emisión.
Pídelo así: "Emite el certificado de finalización para el grupo Clase de marzo, asunto Excel desde cero, 40 horas."
Notas: cada persona recibe un correo, por eso el asistente ejecuta primero el ensayo, muestra quién lo recibe y quién se queda fuera, y solo emite después de tu visto bueno. Quien está en más de un grupo o etiqueta recibe un solo certificado. Consulta la receta Emitir certificados para la clase.
list_issued_certificates
Solo consulta
Listar certificados emitidos. Los certificados de un espacio, con filtro por plantilla y estado y búsqueda por nombre o código. Rol: quien emite en el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | No | |
template | id o slug | No | |
status | PENDING, ISSUED, FAILED, REVOKED | No | Generándose, emitido, falló, revocado |
search | texto | No | Nombre o código |
page, limit | número | No | Paginación |
Pídelo así: "¿Ha fallado algún certificado de la clase de marzo?"
revoke_certificate
Pide confirmación
Revocar certificado. Revoca un certificado, con un motivo interno. La página pública de verificación pasa a decir que fue revocado. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
certificate | id o enlace | Sí | |
reason | texto | Sí | Interno; nadie de fuera lo ve |
Pídelo así: "Revoca el certificado K7Q3-9XWD-2MFA, se emitió por error."
reissue_certificate
Modifica
Reemitir certificado. Lo emite de nuevo con el nombre actual de la persona. El antiguo queda revocado y vinculado al nuevo. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
certificate | id o enlace | Sí | |
send_email | sí o no | No | Por defecto: sí |
Pídelo así: "Ana ha corregido su nombre en el perfil; reemite su certificado."
delete_certificate
Pide confirmación
Eliminar certificado. Elimina un certificado revocado o que falló. Un certificado válido tiene que revocarse antes. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
certificate | id o enlace | Sí |
Pídelo así: "Elimina los certificados que fallaron en la emisión de ayer."
duplicate_certificate_template
Modifica
Duplicar plantilla de certificado. Copia una plantilla como un borrador nuevo, para ajustarla sin tocar la original. Rol: quien emite en el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
template_id | id | Sí | De list_certificate_templates |
Pídelo así: "Duplica el Certificado de finalización para hacer la versión de participación."
update_certificate_space_settings
Modifica
Cambiar quién emite certificados. Define, en un espacio de Certificados, quién emite: el equipo (de moderador para arriba) o solo los administradores. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id, enlace, dirección o nombre | Sí | |
who_can_issue | staff, admins | Sí |
Notas: cambia quién puede hacer qué al momento.
resend_certificate_email
Modifica
Reenviar e-mail del certificado. Vuelve a enviar el correo "tu certificado ha llegado" de un certificado emitido. Rol: quien emite en el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
certificate | id o enlace | Sí |
Pídelo así: "Ana no encuentra el correo del certificado; envíaselo de nuevo."
retry_certificate
Modifica
Reintentar certificado fallido. Vuelve a generar un certificado cuya generación falló y, por defecto, envía el correo cuando esté listo. Rol: quien emite en el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
certificate | id o enlace | Sí | |
send_email | sí o no | No | Por defecto: sí |
list_my_certificates
Solo consulta
Mis certificados. Tus certificados en la comunidad, con el código de verificación y los enlaces. Rol mínimo: cualquiera.
Parámetros: ninguno.
Pídelo así: "Pásame el enlace de mi certificado de Excel desde cero."
set_certificate_indexing
Modifica
Mostrar certificado en buscadores. Activa o desactiva Mostrar en buscadores en la página pública de verificación de un certificado tuyo. Rol: quien recibió el certificado.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
certificate_id | id | Sí | De list_my_certificates |
indexable | sí o no | Sí |