Ferramentas do servidor MCP
Referência das oito ferramentas que o Converto expõe aos assistentes de IA — parâmetros, efeitos e permissões.
Avançado2 min de leitura
Nesta página
O servidor MCP expõe oito ferramentas. O fluxo esperado é: get_authoring_guide → get_widget_spec → validate_markdown → create_page ou apply_markdown.
| Ferramenta | O que faz | Parâmetros |
|---|---|---|
get_authoring_guide | Comece por aqui. Devolve as regras do Markdown, formatos de valor, opções de página, guia de design e o índice de widgets e conversores. Inclui as instruções do site, se houver. | — |
get_widget_spec | Contrato completo (campos, tipos, opções, faixas, condições e exemplo) de widgets ou conversores específicos. | ids e/ou intents (ao menos um) |
validate_markdown | Valida sem salvar nada. Devolve erros (bloqueiam) e avisos, com número de linha. | markdown |
list_pages | Lista páginas (id, título, status, endereço e se foi construída por Markdown). Considera apenas páginas que o usuário pode editar. | search, limit (padrão 20, máx. 100) |
create_page | Cria uma página nova como rascunho e, se houver Markdown, a constrói. Devolve id e links de edição e pré-visualização. Nada é publicado. | title, markdown (opcional) |
apply_markdown | Reconstrói uma página existente a partir do Markdown, substituindo o conteúdo do Elementor (mantém uma versão de backup) e criando ou atualizando os conversores do documento. Valida de novo no servidor. | post_id, markdown |
get_page_markdown | Devolve o último Markdown aplicado a uma página, para edição incremental. | post_id |
upload_media | Adiciona uma imagem à biblioteca e devolve o id e o endereço local para usar no Markdown. Aceita arquivo anexado, URL pública ou dados em base64 (até 8 MB), com largura/altura opcionais e texto alternativo. | image / url / data_base64 + filename, width, height, alt |
Detalhes
- Imagens: os widgets trazem imagens de exemplo; o guia orienta a IA a criar imagens novas com as dimensões indicadas e enviá-las com
upload_media. - Backup:
apply_markdownguarda apenas a última versão anterior da página, sobrescrita a cada aplicação. - Permissões: criar páginas exige permissão para publicar ou editar páginas; enviar mídia exige permissão de envio de arquivos; editar uma página exige poder editá-la.
- Segurança de conteúdo: sem a permissão
unfiltered_html, campos de código (CSS/JS/HTML) são recusados na validação e o conteúdo gravado passa por filtragem.
Este artigo foi útil?
Artigos relacionados
IA e Markdown
Servidor MCP
Conecte assistentes de IA ao seu site pelo Model Context Protocol — como ligar, o endpoint, as ferramentas expostas e as permissões.
IA e Markdown
A linguagem Markdown Converto
Guia da sintaxe — seções, blocos :::content e :::style, listas, valores responsivos, fundos e as regras que toda página deve seguir.
IA e Markdown
Especificação pública para IA
A URL de aprendizado do Converto — o que a rota /spec expõe, como pedir o contrato completo de widgets e o que exige login.