Saltar para o conteúdo

Ferramentas · Certificados

Ferramentas MCP para certificados: listar, criar, duplicar e editar modelos (do padrão da plataforma ou com a arte da marca, com a pré-visualização na conversa), ativar, quem emite no espaço, emitir para pessoas, grupos e tags, reenviar o e-mail, refazer o que falhou, revogar, reemitir e excluir, e os seus próprios certificados.

Tudo o que o espaço Certificados faz, pela conversa: montar o modelo (com a pré-visualização como imagem, para você conferir antes), ativar, emitir para uma turma inteira e cuidar do que já foi emitido. Revogar e excluir pedem a sua confirmação. A emissão roda na primeira chamada, por isso o assistente faz antes um ensaio (dry_run) que diz quantas pessoas recebem e quem fica de fora.

Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.

Em resumo

FerramentaO que fazPapel mínimoTipo
list_certificate_templatesModelos de um espaço de CertificadosModerador ou administradorSó consulta
get_certificate_templateUm modelo, com a pré-visualização como imagemModerador ou administradorSó consulta
create_certificate_templateCria um modelo, do padrão da plataforma ou com a arte da marcaModerador ou administradorAltera
update_certificate_templateMuda textos, assinantes, caixas e a arteModerador ou administradorAltera
activate_certificate_templateAtiva ou arquiva um modeloModerador ou administradorAltera
issue_certificateEmite para pessoas, grupos e tags, depois de um ensaioModerador ou administradorAltera
list_issued_certificatesOs emitidos, com status e buscaModerador ou administradorSó consulta
revoke_certificateRevoga um certificadoAdministradorPede confirmação
reissue_certificateEmite de novo com o nome atualAdministradorAltera
delete_certificateExclui um revogado ou que falhouAdministradorPede confirmação
duplicate_certificate_templateCopia um modelo como rascunho novoModerador ou administradorAltera
update_certificate_space_settingsQuem emite no espaço: a equipe ou só os administradoresAdministradorAltera
resend_certificate_emailManda de novo o e-mail do certificadoModerador ou administradorAltera
retry_certificateRefaz um certificado que falhouModerador ou administradorAltera
list_my_certificatesOs seus certificados, com código e linksQualquerSó consulta
set_certificate_indexingMostra ou esconde um certificado seu nos buscadoresQualquerAltera

list_certificate_templates

Só consulta

Listar modelos de certificado. Os modelos de um espaço de Certificados, com nome, slug, tipo e status. Papel: quem gerencia modelos no espaço (moderador ou administrador, conforme Quem emite).

ParâmetroTipoObrigatórioDescrição
spaceid ou linkNãoO espaço de Certificados. Sem ele, o único da comunidade
statusDRAFT, ACTIVE, ARCHIVEDNãoRascunho, ativo ou arquivado

Devolve: os modelos, com id, nome, slug, tipo (PLATFORM, o padrão da plataforma, ou IMAGE, a arte própria) e status. Só modelos ativos emitem.

Peça assim: "Quais modelos de certificado estão ativos?"

get_certificate_template

Só consulta

Ver modelo de certificado. Um modelo com os textos, os assinantes e as caixas, e a pré-visualização como imagem, que aparece na conversa. Papel: quem gerencia modelos.

ParâmetroTipoObrigatórioDescrição
templateid ou slugSimO modelo
spaceid ou linkNãoO espaço de Certificados

Devolve: o modelo e a imagem da pré-visualização, com um nome de teste.

Peça assim: "Mostre como está o modelo Conclusão de curso."

create_certificate_template

Altera

Criar modelo de certificado. Cria um modelo em rascunho e devolve a pré-visualização como imagem, na conversa, para você conferir. Papel: quem gerencia modelos no espaço.

ParâmetroTipoObrigatórioDescrição
nametextoSimO nome interno do modelo
titletexto, até 255SimO título impresso, ex.: Certificado de conclusão
typePLATFORM, IMAGENãoPadrão: PLATFORM, o desenho da Memberfy com o logo e as cores da comunidade. IMAGE usa a arte da sua marca
descriptiontexto, até 5.000NãoO texto, com {nome}, {assunto} e {cargaHoraria}. Um trecho entre colchetes some quando a variável dele vier vazia: "concluiu[ {assunto}], com carga de {cargaHoraria} horas"
workload_hoursnúmeroNão
slugtextoNãoO endereço curto do modelo
language, timezonetextoNãoEx.: pt-BR, America/Sao_Paulo. Padrão: os da comunidade
signerslista, até 2NãoCada um com name, role e a assinatura por signature_url (um PNG com fundo transparente) ou signature_base64
image_url ou image_base64link ou arquivoNo IMAGEA arte, PNG ou JPEG, com pelo menos 2.000 px de largura
layoutlista de caixasNãoSó no IMAGE: onde vai cada campo (recipientName, issuedAt, qr, title, description, workload, subjectTitle, code, signer1, signer2), em % da arte, com fonte, tamanho, cor e alinhamento. Sem ele, valem as caixas padrão: o nome no centro, a data embaixo à esquerda e o QR embaixo à direita
fontinter, montserrat, lora, playfair-display, eb-garamond, great-vibes, noto-sansNãoA fonte do nome nas caixas padrão
text_colorcor em hexNãoA cor do texto nas caixas padrão

Devolve: o modelo criado, em rascunho, e a imagem da pré-visualização.

Peça assim: "Crie um modelo de certificado com a arte da nossa marca: https://…/arte.png. Título Certificado de conclusão."

Notas: para emitir, ative com activate_certificate_template. Ver a receita Criar um modelo com a arte da marca e Certificados.

update_certificate_template

Altera

Editar modelo de certificado. Muda textos, carga horária, assinantes, caixas do layout, idioma, fuso e a arte. Devolve a pré-visualização nova. Papel: quem gerencia modelos.

ParâmetroTipoObrigatórioDescrição
templateid ou slugSimO modelo
Os demaisNãoOs mesmos de create_certificate_template, menos type; só o que for enviado muda

Devolve: o modelo e a imagem da pré-visualização.

Peça assim: "Suba o nome um pouco e deixe a data em cinza."

Notas: se o modelo já emitiu, a versão sobe, e os certificados já emitidos ficam como saíram.

activate_certificate_template

Altera

Ativar ou arquivar modelo. Ativa um modelo (só ativos emitem) ou o arquiva. Papel: quem gerencia modelos.

ParâmetroTipoObrigatórioDescrição
templateid ou slugSimO modelo
spaceid ou linkNão
actionactivate, archiveNãoPadrão: activate

Peça assim: "Pode ativar o modelo."

issue_certificate

Altera

Emitir certificados. Emite certificados de um modelo ativo para pessoas, grupos e tags, com o assunto e a carga horária. Papel: quem emite no espaço.

ParâmetroTipoObrigatórioDescrição
templateid ou slugSimUm modelo ativo
peoplelista de ids de perfil, até 1.000NãoDe list_members
groupslista de ids, até 100NãoDe list_groups
tagslista de nomes, até 100Não
subjecttextoNãoO que foi concluído, ex.: Excel do Zero (o {assunto} do texto)
workload_hoursnúmeroNão
send_emailsim ou nãoNãoPadrão: sim
issue_anywaysim ou nãoNãoEmite também para quem já tem um certificado vigente deste modelo. Padrão: não
dry_runsim ou nãoNãoSó o ensaio: diz quem recebe e quem fica de fora, sem emitir nada. Padrão: não
spaceid ou linkNão

Devolve: com dry_run: true, o ensaio: quantas pessoas recebem, quem é pulado e por quê (por exemplo, quem já tem um vigente). Nada é emitido. Sem dry_run, a emissão.

Peça assim: "Emita o certificado de conclusão para o grupo Turma de março, assunto Excel do Zero, 40 horas."

Notas: cada pessoa recebe um e-mail, por isso o assistente roda o ensaio primeiro, mostra quem recebe e quem fica de fora, e só emite depois do seu ok. Quem está em mais de um grupo ou tag recebe um certificado só. Ver a receita Emitir certificados para a turma.

list_issued_certificates

Só consulta

Listar certificados emitidos. Os certificados de um espaço, com filtro por modelo e status e busca por nome ou código. Papel: quem emite no espaço.

ParâmetroTipoObrigatórioDescrição
spaceid ou linkNão
templateid ou slugNão
statusPENDING, ISSUED, FAILED, REVOKEDNãoGerando, emitido, falhou, revogado
searchtextoNãoNome ou código
page, limitnúmeroNãoPaginação

Peça assim: "Algum certificado da turma de março falhou?"

revoke_certificate

Pede confirmação

Revogar certificado. Revoga um certificado, com um motivo interno. A página pública de verificação passa a dizer que ele foi revogado. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
certificateid ou linkSim
reasontextoSimInterno; ninguém de fora vê

Peça assim: "Revogue o certificado K7Q3-9XWD-2MFA, emitido por engano."

reissue_certificate

Altera

Reemitir certificado. Emite de novo, com o nome atual da pessoa. O antigo fica revogado e ligado ao novo. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
certificateid ou linkSim
send_emailsim ou nãoNãoPadrão: sim

Peça assim: "A Ana corrigiu o nome no perfil; reemita o certificado dela."

delete_certificate

Pede confirmação

Excluir certificado. Exclui um certificado revogado ou que falhou. Um certificado válido precisa ser revogado antes. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
certificateid ou linkSim

Peça assim: "Exclua os certificados que falharam na emissão de ontem."

duplicate_certificate_template

Altera

Duplicar modelo de certificado. Copia um modelo como um rascunho novo, para ajustar sem mexer no original. Papel: quem emite no espaço.

ParâmetroTipoObrigatórioDescrição
template_ididSimDe list_certificate_templates

Peça assim: "Duplique o Certificado de conclusão para eu fazer a versão de participação."

update_certificate_space_settings

Altera

Alterar quem emite certificados. Define, num espaço de Certificados, quem emite: a equipe (moderador para cima) ou só os administradores. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
spaceid, link, endereço ou nomeSim
who_can_issuestaff, adminsSim

Notas: muda quem pode fazer o quê na hora.

resend_certificate_email

Altera

Reenviar e-mail do certificado. Manda de novo o e-mail "seu certificado chegou" de um certificado emitido. Papel: quem emite no espaço.

ParâmetroTipoObrigatórioDescrição
certificateid ou linkSim

Peça assim: "A Ana não achou o e-mail do certificado; mande de novo."

retry_certificate

Altera

Refazer certificado que falhou. Gera de novo um certificado cuja geração falhou e, por padrão, manda o e-mail quando ficar pronto. Papel: quem emite no espaço.

ParâmetroTipoObrigatórioDescrição
certificateid ou linkSim
send_emailsim ou nãoNãoPadrão: sim

list_my_certificates

Só consulta

Meus certificados. Os seus certificados na comunidade, com o código de verificação e os links. Papel mínimo: qualquer.

Parâmetros: nenhum.

Peça assim: "Me passe o link do meu certificado do Excel do Zero."

set_certificate_indexing

Altera

Mostrar certificado em buscadores. Liga ou desliga Mostrar em buscadores na página pública de verificação de um certificado seu. Papel: quem recebeu o certificado.

ParâmetroTipoObrigatórioDescrição
certificate_ididSimDe list_my_certificates
indexablesim ou nãoSim

Relacionados