Agentes de IA (MCP)
page-builder-sandwich para agentes de IA
Seu site WordPress é o seu próprio servidor MCP. Um assistente de IA faz login como usuário do WordPress com uma senha de aplicativo e pode fazer o que esse usuário puder fazer com page-builder-sandwich — nada mais.
96 ações: 46 gratuitas, 50 no Pro.
Referência do desenvolvedor: cada ação, sua rota REST e seus parâmetros
Configure-o em três etapas
Verifique a chave
Você precisa do WordPress 6.9 ou posterior e de page-builder-sandwich 6.23.0 ou posterior. Nas configurações do plugin, "Allow AI agents (MCP)" está ativado, a menos que você o tenha desativado.
Criar uma senha de aplicativo
No WordPress, abra Usuários, depois Perfil, e adicione uma senha de aplicativo com o nome do seu aplicativo de IA. Copie-a: o WordPress a exibe apenas uma vez.
Adicione o site ao seu aplicativo de IA
Use seu nome de usuário do WordPress, a senha do aplicativo e o endereço de conexão do seu site:
https://example.com/wp-json/pbs/v1/mcp
Configuração para aplicativos de IA populares
Todos os aplicativos abaixo se comunicam com o seu site através do proxy oficial do WordPress, @automattic/mcp-wordpress-remote. Substitua o endereço, o nome de usuário e a senha pelos seus.
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"page-builder-sandwich": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/pbs/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add page-builder-sandwich \
-e WP_API_URL=https://example.com/wp-json/pbs/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestCursor e VS Code
// .cursor/mcp.json · .vscode/mcp.json
{
"mcpServers": {
"page-builder-sandwich": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/pbs/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}ChatGPT e outros aplicativos
Qualquer aplicativo que ofereça suporte a servidores MCP por meio de entrada e saída padrão pode usar o mesmo comando e as mesmas configurações. Os aplicativos que se conectam apenas a servidores HTTP remotos podem acessar o endereço de conexão diretamente com o mesmo nome de usuário e a mesma senha de aplicativo.
O que um agente de IA pode fazer
Tudo o que as próprias telas do plugin conseguem fazer. As ações marcadas como Pro exigem uma licença do page-builder-sandwich Pro.
| Ação | O que ele faz | Edição |
|---|---|---|
| Ativar uma fonte enviada (Pro) | Torna uma fonte personalizada enviada (um arquivo de fonte na biblioteca de mídia, por ID) disponível nos seletores de fontes. | Edição Pro |
| Hospedar uma fonte por conta própria | Baixa uma família de fontes Google (família, pesos, itálico) e a serve a partir deste site. | Edição gratuita |
| Adicionar uma seção a uma página | Adiciona uma seção pronta a uma página: no início, no final ou após a seção em uma determinada posição. | Edição gratuita |
| Aplicar o kit de marca (Pro) | Aplica as cores e as fontes do kit de marca salvo ao design do site. | Edição Pro |
| Importar um kit de site | Importa as páginas de um kit de site (todas elas ou as nomeadas), publicando-as opcionalmente, definindo a página inicial e adicionando-as a um menu. Importar novamente atualiza as mesmas páginas. | Edição gratuita |
| Aplicar localizar e substituir (Pro) | Aplica um trabalho visualizado. Cada publicação alterada mantém um backup para pbs/undo-replace. | Edição Pro |
| Criar várias páginas | Cria até 50 páginas em uma única chamada, cada uma a partir de seções e/ou conteúdo de blocos. Cada página é verificada e criada individualmente; a resposta lista todas as páginas criadas e recusadas, com o motivo. | Edição Pro |
| Conectar Adobe Fonts (Pro) | Conecta um projeto web do Adobe Fonts (Typekit) pelo ID do kit, para que suas fontes apareçam nos seletores de fontes. | Edição Pro |
| Conectar ao suporte | Conecta este site ao suporte da Zinn Digital® (nome, e-mail, consentimento). | Edição gratuita |
| Converter uma página legada | Converte uma página 5.x para blocos (fazendo backup primeiro). | Edição gratuita |
| Criar uma classe global (Pro) | Cria uma classe de estilo global reutilizável: rótulo, identificador (slug) e seus estilos. | Edição Pro |
| Criar uma página | Cria uma página a partir de seções (consulte pbs/list-sections) e/ou conteúdo de blocos. Uma nova página é um rascunho, a menos que outro status seja solicitado. | Edição gratuita |
| Criar uma equipe de biblioteca (Agência) | Cria uma biblioteca de equipe (name) que outros sites podem acessar com um código de convite. | Edição Pro |
| Desativar uma fonte carregada (Pro) | Remove uma fonte personalizada (por slug) dos seletores de fontes. | Edição Pro |
| Excluir uma classe global (Pro) | Exclui uma classe global. Os elementos que a utilizavam mantêm o seu conteúdo e perdem os seus estilos. | Edição Pro |
| Excluir um ícone enviado | Remove um ícone enviado; os blocos que o utilizavam mantêm a própria cópia. | Edição gratuita |
| Excluir um design de biblioteca na nuvem (Pro) | Exclui um design da biblioteca na nuvem. | Edição Pro |
| Mover uma página para a lixeira | Move uma página para a lixeira. Ela pode ser restaurada em Páginas > Lixeira por 30 dias. | Edição gratuita |
| Excluir uma equipe da biblioteca (Agência) | Exclui uma equipe e todos os designs em sua biblioteca. | Edição Pro |
| Desconectar do suporte | Desconecta este site do suporte. | Edição gratuita |
| Duplicar uma classe global (Pro) | Copia uma classe global sob um novo ID. | Edição Pro |
| Duplicar uma página | Copia uma página (seu título, conteúdo e modelo) para um novo rascunho. | Edição gratuita |
| Exportar designs e configurações | Exporta os modelos e padrões escolhidos (IDs) e, opcionalmente, as configurações como um pacote para outro site. | Edição gratuita |
| Escreva uma página com IA | Cria uma página a partir de seções (fornecidas ou escolhidas por IA a partir da biblioteca de seções) e faz com que a IA reescreva todo o seu texto para o seu briefing, mantendo o design. Usa o provedor de IA configurado nas configurações de IA do plugin. A página é um rascunho, a menos que outro status seja solicitado. | Edição Pro |
| Descrever um bloco do construtor | Retorna as configurações de um bloco (atributos com seus tipos, opções e padrões), o que ele suporta, quais blocos ele pode conter e um exemplo pronto para uso em marcação de bloco. | Edição gratuita |
| Ler os pontos de interrupção responsivos | Retorna as larguras para tablet e celular (e pontos de interrupção personalizados no Pro) usadas pelos controles responsivos. | Edição gratuita |
| Ler o design do site | Retorna as cores e fontes (de título e do corpo) de todo o site usadas por cada bloco, conforme exibidas na tela de design do site. | Edição gratuita |
| Leia o sistema de design (Pro) | Retorna o sistema de design Pro: classes globais, variáveis, design tokens, modo escuro, kit de marca e fontes personalizadas. | Edição Pro |
| Ler os diagnósticos do site | Retorna os dados de diagnóstico que um ticket de suporte conteria: versões, plugins ativos, limites e erros recentes. | Edição gratuita |
| Ler a conta da biblioteca na nuvem (Pro) | Retorna o uso de armazenamento da biblioteca em nuvem, a cota do plano e os dados da equipe. | Edição Pro |
| Obtenha um design de biblioteca em nuvem (Pro) | Retorna um design salvo, pronto para ser inserido neste site (com suas imagens adicionadas à biblioteca de mídia). | Edição Pro |
| Ler as configurações de armazenamento próprio (Pro) | Retorna as configurações de armazenamento R2/S3 próprias (o segredo nunca é retornado). | Edição Pro |
| Ler a licença | Retorna o plano, o estado da licença, a data de renovação e o que o plano do Page Builder Sandwich inclui para este site. | Edição gratuita |
| Modo de manutenção de leitura (Pro) | Modo de manutenção / em breve: modo, página, retry-after e quais funções ainda veem o site. | Edição Pro |
| Ler a migração legada | Retorna o progresso e o relatório da conversão de conteúdo do 5.x. | Edição gratuita |
| Ler conexão de boletim informativo (Pro) | Indica se uma chave do Mailchimp está salva (a chave em si nunca é retornada). | Edição Pro |
| Ler página | Retorna o título, o status, os links e o conteúdo de blocos de uma página, bem como as seções (blocos de nível superior) que a compõem. | Edição gratuita |
| Visualizar uma localização e substituição (Pro) | Retorna as correspondências de uma vaga, página por página, para revisão antes de se candidatar. | Edição Pro |
| Ler as fontes das avaliações (Pro) | Retorna as origens do Google e do Trustpilot que o bloco de avaliações exibe. | Edição Pro |
| Ler permissões do construtor (Pro) | Retorna quais funções podem usar o construtor, design, código e modelos (modo cliente). | Edição Pro |
| Ler as configurações do plugin | Retorna o prefixo da classe de front-end, o estado das atualizações beta e se os agentes de IA (MCP) são permitidos. | Edição gratuita |
| Ler a conexão de suporte | Indica se este site está conectado ao suporte da Zinn Digital®, e como quem. | Edição gratuita |
| Ler white label (Agência) | Retorna as configurações de white-label: ativadas ou desativadas, o nome exibido e quais usuários ainda veem o original. | Edição Pro |
| Importar designs e configurações | Importa um pacote gerado por pbs/export-designs (dryRun primeiro para ver o que mudaria; modo: skip ou replace; mídia; configurações). | Edição gratuita |
| Convidar um site para uma equipe (Agência) | Cria um código de convite de uso único (função: leitura ou gravação; rótulo; dias de validade). O código é exibido uma vez. | Edição Pro |
| Entrar em uma equipe (Pro) | Entra em uma biblioteca de equipe com um código de convite. | Edição Pro |
| Sair da equipe (Pro) | Sai da biblioteca da equipe à qual este site se uniu. | Edição Pro |
| Listar os blocos do construtor | Lista todos os blocos do Page Builder Sandwich que este site pode usar (incluindo blocos Pro quando o Pro estiver ativo): nome, título, categoria e descrição. Use pbs/get-block para as configurações de um bloco e, em seguida, insira o bloco no conteúdo de uma página. | Edição gratuita |
| Listar formulários | Lista os formulários criados com o bloco de Formulário e os plug-ins de formulário que ele pode incorporar. | Edição gratuita |
| Listar kits de sites | Lista os kits de site (um conjunto de páginas prontas para um tipo de negócio) que este site pode importar. | Edição gratuita |
| Listar designs da biblioteca em nuvem (Pro) | Lista os designs salvos na biblioteca na nuvem (kind: section, page ou pattern; team: uma biblioteca de equipe). | Edição Pro |
| Listar fontes auto-hospedadas | Lista as fontes do Google que este site hospeda por conta própria (baixadas uma vez, servidas a partir do site, sem solicitação ao Google). | Edição gratuita |
| Listar animações Lottie (Pro) | Lista as animações Lottie carregadas. | Edição Pro |
| Listar páginas | Lista as páginas que você pode editar, da mais recente para a mais antiga, com uma pesquisa opcional. | Edição gratuita |
| Listar tarefas de localizar e substituir (Pro) | Lista os trabalhos de localizar e substituir em todo o site e o estado deles. | Edição Pro |
| Listar seções | Lista as seções prontas (destaque, recursos, FAQ, depoimentos, chamada para ação e mais) que podem ser adicionadas a uma página. | Edição gratuita |
| Listar logins temporários de suporte | Lista os usuários de suporte temporários concedidos à nossa equipe e quando cada um expira. | Edição gratuita |
| Listar membros da equipe (Pro) | Lista os sites de uma equipe e seus acessos. | Edição Pro |
| Listar equipes da biblioteca (Pro) | Lista as equipes a que este site pertence ou que ele possui. | Edição Pro |
| Liste o que pode ser exportado | Lista os modelos, padrões e configurações que podem ser exportados para outro site. | Edição gratuita |
| Listar ícones enviados | Lista os ícones SVG enviados para a biblioteca de ícones, do mais recente para o mais antigo. | Edição gratuita |
| Mover uma seção | Move uma seção de uma página de uma posição para outra (baseado em 0, conforme listado por pbs/get-page). | Edição gratuita |
| Abrir um chamado de suporte | Abre um chamado de suporte (assunto, mensagem, tipo, email) com os diagnósticos deste site; access_days e credentials concedem opcionalmente acesso temporário à nossa equipe. | Edição gratuita |
| Consentir com o diagnóstico de suporte | Registra o consentimento do administrador para enviar diagnósticos com os tickets de suporte. | Edição gratuita |
| Atualizar avaliações agora (Pro) | Busca as últimas avaliações do Trustpilot agora, em vez de esperar pela atualização diária. | Edição Pro |
| Remover um bloco de uma página | Remove um bloco (uma seção inteira ou um bloco dentro de uma) de uma página, localizado pelo seu caminho. A versão anterior da página permanece em suas revisões. | Edição gratuita |
| Parar de usar seu próprio armazenamento (Pro) | Remove as configurações de armazenamento próprio; o armazenamento do plano volta a ser utilizado. | Edição Pro |
| Remover uma fonte auto-hospedada | Exclui os arquivos de uma família de fontes auto-hospedada. | Edição gratuita |
| Remover um membro da equipe (Agência) | Remove um site de uma equipe. | Edição Pro |
| Revogar logins temporários de suporte | Remove usuários de suporte temporários agora (IDs). | Edição gratuita |
| Salvar um design na biblioteca na nuvem (Pro) | Salva a marcação do bloco (título, tipo, marcação, estilos, tags) na sua biblioteca na nuvem ou de uma equipe; as imagens são empacotadas com ele. | Edição Pro |
| Use seu próprio armazenamento (Pro) | Salva o armazenamento próprio: provedor (r2 ou s3), bucket, região, endpoint, prefixo, key_id, secret, ativado. | Edição Pro |
| Alterar modo de manutenção (Pro) | Ativa ou desativa o modo de manutenção (503) ou em breve (mode), com a página a ser exibida (page_id), retry_after e as funções que o ignoram. | Edição Pro |
| Conectar Mailchimp (Pro) | Salva (ou, com um valor vazio, remove) a chave de API do Mailchimp que o bloco de newsletter usa. | Edição Pro |
| Alterar as fontes de avaliações (Pro) | Define o local do Google e a empresa do Trustpilot que o bloco Avaliações lê. | Edição Pro |
| Alterar permissões do construtor (Pro) | Define por função o que o construtor permite (funções), por exemplo, uma função de cliente apenas de conteúdo. | Edição Pro |
| Alterar marca branca (Agência) | Ativa ou desativa a marca branca e define o nome que os clientes veem (enabled, name, agency_users). | Edição Pro |
| Converter conteúdo legado | Inicia (ou reinicia) a conversão de cada página 5.x para blocos; cada post é respaldado primeiro. | Edição gratuita |
| Localizar e substituir em todo o site (Pro) | Inicia uma operação de localizar e substituir segura por bloco (localizar, substituir, tipo: texto, link ou cor; match_case; tipos). Nada é alterado até pbs/apply-replace. | Edição Pro |
| Iniciar o teste gratuito do Pro | Inicia o teste de 14 dias do Page Builder Sandwich Pro para este site (nenhum pagamento necessário). | Edição gratuita |
| Testar seu próprio armazenamento (Pro) | Grava, lê e exclui um objeto de teste no seu próprio armazenamento e relata cada etapa. | Edição Pro |
| Desfazer uma conversão | Restaura uma página convertida do seu backup. | Edição gratuita |
| Desfazer a migração legada | Restaura cada post convertido a partir do seu backup. | Edição gratuita |
| Desfazer localizar e substituir (Pro) | Restaura as postagens que um trabalho alterou (uma postagem editada desde então mantém sua edição). | Edição Pro |
| Alterar as configurações de um bloco | Altera as configurações (atributos) de um bloco dentro de uma página, encontrado pelo seu caminho; os atributos enviados são mesclados com os atuais. Funciona em blocos que o site renderiza a partir de suas configurações; para um bloco cujo HTML está salvo na página, envie a nova marcação com pbs/update-page. | Edição gratuita |
| Alterar o kit de marca (Pro) | Salva o kit de marca: nome, logotipo, cores, fontes de títulos e do corpo de texto, e a voz de marca usada pela escrita de IA. | Edição Pro |
| Alterar os pontos de interrupção responsivos | Altera as larguras para tablet e celular em pixels; com o Pro, pontos de interrupção extras personalizados. | Edição gratuita |
| Alterar uma classe global (Pro) | Altera o rótulo, o identificador (slug) ou os estilos de uma classe global; todos os elementos que a utilizam são atualizados. | Edição Pro |
| Alterar o modo escuro (Pro) | Define o modo escuro (modo: desativado, automático ou alternar) e suas cores. | Edição Pro |
| Alterar o design do site | Altera as cores de todo o site (colors), fontes (fonts, headingFont, bodyFont). Cada página aplica a alteração; o arquivo theme.json do tema é mantido sincronizado. | Edição gratuita |
| Atualizar uma página | Altera o título, o status ou o conteúdo de bloco de uma página. O conteúdo enviado substitui o conteúdo da página. | Edição gratuita |
| Alterar as configurações do plugin | Altera o prefixo da classe de front-end (1 a 8 letras minúsculas ou dígitos, começando com uma letra) e/ou ativa ou desativa os agentes de IA (MCP) (mcp: false remove todas as funcionalidades e o endpoint MCP). | Edição gratuita |
| Alterar os tokens de design (Pro) | Altera as escalas de espaçamento, raio e sombra (space, radius, shadow) ou as redefine (reset). | Edição Pro |
| Alterar as variáveis CSS (Pro) | Substitui as variáveis de design do site (variáveis: uma lista de nome e valor). | Edição Pro |
| Carregar um ícone | Adiciona um ícone SVG (nome, marcação svg) à biblioteca de ícones; o SVG é sanitizado primeiro. | Edição gratuita |
| Carregar uma animação Lottie (Pro) | Valida um documento JSON do Lottie (json, name) e o publica como um arquivo estático para o bloco Lottie. | Edição Pro |
Fluxos guiados
O servidor também oferece fluxos de trabalho prontos que seu aplicativo de IA lista como prompts:
- Criar uma página de destino — Um fluxo de trabalho guiado: o agente seleciona seções que se adaptam ao seu negócio, cria a página como um rascunho e escreve o texto dela.
Seguro por padrão
Cada ação verifica a mesma permissão do WordPress que a tela do próprio plugin, para a página ou post exato que ela afeta. Um assinante não pode se conectar de forma alguma.
As senhas de aplicativo podem ser revogadas a qualquer momento em Usuários, Perfil, sem alterar sua senha normal.
Desative "Allow AI agents (MCP)" e as ações e o endereço de conexão desaparecerão do site.
As páginas alteradas por um agente mantêm suas revisões do WordPress, portanto, qualquer alteração pode ser desfeita.
Hospedado na Zinn Digital®?
Se a Zinn Digital® hospedar o site, nosso próprio servidor MCP poderá usar estas ações para você sem uma senha de aplicativo: conecte seu aplicativo de IA ao servidor MCP da Zinn Digital® e use wordpress_abilities_list e wordpress_ability_run.