Desenvolvimento WordPress

WordPress para agentes de IA: o primeiro passo prático

WordPress para agentes de IA começa com inventário, não com plugin. Veja os 6 passos com Abilities API, MCP Adapter e Permission Callback.
Escrito Por Leandro Vieira em novembro de 2026 /12 min de leitura
Conteúdo escrito por humano
Ilustração de um portal WordPress para agentes de IA com ações declaradas e permissões de acesso

WordPress para agentes de IA é o trabalho de declarar, em contratos tipados, o que o seu site sabe fazer, quem tem permissão de pedir e o que fica registrado depois, para que um agente execute ações em vez de adivinhar a partir do HTML renderizado.

Repare que não tem plugin nessa definição. Tem planilha.

Porque o primeiro passo prático não é instalar nada. É sentar com o time e listar o que o site já faz hoje pela interface.

A cena que trava a operação

Planilha com lista de ações de um site, classificação de risco e coluna de permissões ao lado de um notebook

Imagine você coordenando o digital de uma instituição de ensino. Portal grande, dezenas de cursos, calendário de captação apertado.

Um assistente de IA chega ao site carregando o pedido de um candidato: esse curso abre turma no próximo semestre e quanto custa?

Pergunta banal. Sua equipe responde isso dezenas de vezes por dia no chat, no e-mail, no WhatsApp.

E mesmo assim o site não consegue responder de um jeito que o agente aceite.

Obstáculo 1: o dado existe, mas só dentro do template

A data de início está num campo customizado. O valor está em outro. Uma condicional no PHP do tema aplica desconto de ex-aluno, e a informação de turma aberta vem de um shortcode que consulta o sistema acadêmico.

Nada disso é um dado consultável. É HTML renderizado no navegador.

O agente lê a página, encontra três números próximos e escolhe um. Às vezes acerta.

O custo real: uma resposta errada sai assinada pela sua marca, na hora da decisão do candidato, e ninguém do seu time fica sabendo.

Obstáculo 2: a ação existe, mas só como formulário

Registrar interesse na próxima turma já funciona. Onze campos, validação em JavaScript, um hook no submit que integra com o CRM e dispara e-mail para a coordenação.

A regra de negócio inteira mora ali dentro. Quem pode se inscrever, qual turma ainda aceita, o que fazer quando lota.

Agente não preenche formulário com segurança. E se preencher, você ganha lead sujo no lugar de registro válido.

Obstáculo 3: tudo vira chamado

Você leva o tema para a TI interna e a resposta é previsível: entra no backlog, atrás da integração com o ERP e da migração do gateway.

A pergunta que a TI devolve, aliás, é legítima: se abrirmos inscrição para um agente, quem garante que não vão criar 300 registros falsos numa madrugada?

Na maioria dos sites que a gente abre, essa pergunta não tem resposta. Não existe identidade de quem chamou, não existe escopo, não existe registro do que mudou.

Sobra uma escolha ruim: ficar de fora e deixar a IA adivinhar o preço do seu curso, ou abrir o portão sem porteiro.

Nenhum desses obstáculos é sobre IA

É arquitetura. Em como o seu projeto digital foi montado.

A tese cabe numa frase: o seu site sabe fazer dezenas de coisas e nenhuma delas está declarada para um agente.

Durante décadas a regra de negócio morou na interface. O formulário virou contrato, o template virou API, a validação virou condicional espalhada em callback de plugin.

Funciona enquanto do outro lado tem um humano com olho, cursor e paciência.

Considere um restaurante sem cardápio. Você senta e pergunta o que tem hoje, o garçom explica, você pergunta o preço, ele vai até a cozinha e volta.

O sistema roda porque existe um intermediário.

O agente de IA não tem garçom. Ele precisa da lista do que pode ser pedido, com o nome exato do prato, o que entra em cada um, quanto custa e quem tem permissão de pedir.

Sem essa lista, três consequências práticas. O agente infere em vez de consultar, e inferência vira erro factual. Cada nova integração vira projeto do zero, porque não existe camada comum. E no dia em que alguém libera escrita na pressa, não existe ponto único para impor permissão.

Atrás disso tem uma decisão antiga e, na época, racional: o site foi orçado como camada de apresentação. Integração era escopo do ERP, do CRM, do sistema acadêmico.

A conta dessa decisão chegou agora.

O que mudou no core: Abilities API e MCP Adapter

Aqui está a parte boa para quem roda WordPress dentro do framework de GEO Técnico.

Desde o WordPress 6.9, o core tem a Abilities API. Em uma linha: um registro onde cada ação do site vira um objeto com nome, esquema de entrada, esquema de saída e permissão.

Em vez de a capacidade morar espalhada, ela passa a ser declarada. Dá para acompanhar a evolução disso no blog de desenvolvimento do core do WordPress.

E existe um plugin oficial, o MCP Adapter, que expõe essas habilidades a agentes como Claude, ChatGPT e Gemini, seguindo a especificação do Model Context Protocol.

Guarda isso: Abilities API no core, MCP Adapter no plugin.

A distinção que mais confunde o time técnico

O AI Client, previsto para o WordPress 7.0, serve para o WordPress chamar a API de um modelo. É o seu site consumindo IA.

Abilities API mais MCP Adapter é o contrário: é o agente chamando o seu WordPress.

Setas opostas, problemas opostos, riscos opostos. Este artigo trata só do segundo caso, que é preparar WordPress para agentes de IA no sentido de ser chamado por eles.

Os seis passos para preparar WordPress para agentes de IA

Em ordem. Cada um com um jeito clássico de errar.

1. Inventarie o que o seu site já faz

Planilha simples. Uma linha por ação que hoje acontece via interface: consultar turma aberta de um curso, consultar valor e condições de pagamento, verificar pré-requisito, registrar interesse, agendar conversa com a coordenação.

Cada linha dessas é uma ability candidata. Ainda não é código, é só nome, descrição e linguagem de negócio.

O erro clássico: começar pela ação mais chamativa em vez da mais pedida. Olhe o volume do seu atendimento, não o que parece bonito na apresentação.

2. Classifique o risco de cada linha

Três anotações: read-only, destrutivo e idempotente. Leitura pura é read-only. Ação que altera ou destrói estado é destrutiva. Ação que pode ser repetida sem duplicar efeito é idempotente.

Ação do inventário

Classificação

Por onde começar

Consultar turmas abertas de um curso

read-only

Primeira ability a declarar, sem dado pessoal na saída

Consultar valor e condições de pagamento

read-only

Exige enum de modalidade e valor tipado, não texto livre

Registrar interesse na próxima turma

Altera estado, idempotente só com chave de deduplicação

Segunda etapa, com confirmação por ID

Confirmar matrícula ou emitir documento

Destrutivo e irreversível

Não entra sem humano aprovando

O erro clássico: marcar tudo como read-only porque “é só consulta”. Se a consulta devolve dado de candidato, ela não é inofensiva.

3. Declare o contrato

Aqui entra o registro da ability: nome em namespace próprio, esquema de entrada, esquema de saída tipado e erro legível.

Tipado é tipado. Data em formato de data, valor com moeda, enum com os valores possíveis de modalidade. A saída precisa dizer o que é turma, o que é vaga e o que é condição.

Quando falhar, devolva um erro nomeado, não uma string solta. Se você ainda está mapeando como seu site conversa com sistemas externos, vale revisar como conectar o WordPress a uma API externa antes.

O erro clássico: retornar HTML. Se a ability devolve markup, você só trocou o template de lugar.

4. Centralize a regra numa camada de serviço

Essa é a regra que separa quem roda WordPress em escala de quem improvisa.

Uma regra, duas superfícies. O execute callback da ability e o handler do formulário chamam a mesma função de serviço. A validação de “essa turma ainda aceita inscrição” existe em um lugar só.

O erro clássico: duplicar a validação dentro do callback para adiantar. Em três meses a regra do formulário muda, a da ability não, e você passa a ter duas políticas diferentes no mesmo site.

5. Dê identidade a quem chama

Aqui entra o Permission Callback. Em toda ability, sem exceção, inclusive nas de leitura.

Usuário dedicado, papel mínimo, capabilities específicas. Nunca a conta de administrador, nunca a conta da pessoa de marketing.

Use Application Password por integração, para revogar uma sem derrubar as outras. A documentação da REST API do WordPress cobre bem esse mecanismo de autenticação.

O erro clássico: reaproveitar credencial existente “só para testar”. Esse teste vira produção e o log deixa de dizer quem é quem.

E aqui eu cravo uma opinião firme: escrita irreversível não vai para agente sem humano no circuito. Matrícula confirmada, cancelamento, emissão de documento, cobrança. O agente registra a intenção, uma pessoa aprova.

Comece por leitura e por escrita reversível. Depois sobe degrau por degrau.

6. Confirme e registre

Toda ability de escrita volta com ID e estado. Nada de “ok” ou “sucesso”.

O identificador do registro criado e a situação em que ele está. Mais log estruturado: quem chamou, com qual escopo, o que mudou, quando.

Em tabela consultável, não só no error log, para que alguém que não é da TI consiga olhar sozinho.

O erro clássico: achar que log é tema de auditoria futura. É o que te permite responder, na reunião de segunda de manhã, por que apareceram 40 registros no sábado.

O limite honesto deste trabalho

Isto é rascunho de engenharia, não promessa comercial.

Declarar abilities não gera demanda. Nenhuma ability vai puxar candidato para o seu portal sozinha.

O ecossistema de MCP está em movimento. O Adapter é um plugin e vai mudar ao longo do tempo.

O que o trabalho faz é outra coisa: remove o motivo técnico para você ficar de fora quando a chamada chegar, e tira a sua operação da escolha entre adivinhação e portão aberto.

Perguntas frequentes sobre WordPress para agentes de IA

Preciso instalar algum plugin para começar?

Não no primeiro passo. Preparar WordPress para agentes de IA começa com o inventário das ações que o site já executa pela interface, com nome, descrição e classificação de risco de cada uma. Plugin e código entram depois, quando o contrato de entrada e saída já estiver claro no papel.

Qual a diferença entre Abilities API e AI Client?

Abilities API, disponível no core desde o WordPress 6.9, declara o que o seu site sabe fazer para que um agente externo possa chamar. O AI Client, previsto para o WordPress 7.0, faz o caminho inverso: permite que o seu site consuma uma API de modelo de linguagem. São direções opostas, com riscos de segurança diferentes.

Como evitar que um agente crie centenas de registros falsos?

Com identidade, escopo e log. Cada integração usa um usuário dedicado com papel mínimo e Application Password própria, toda ability tem Permission Callback, e ações destrutivas ou irreversíveis ficam fora do alcance do agente até que exista aprovação humana no fluxo.

Por onde começar se o site tem dezenas de ações mapeadas?

Pela ação mais pedida no seu atendimento, desde que seja de leitura pura e não devolva dado pessoal. Uma única ability declarada e testada ensina mais ao time do que um projeto grande que nunca sai do backlog.

Conclusão

O seu site sabe fazer muita coisa e não declara nenhuma delas. É por isso que ele não responde a um pedido de agente sem adivinhar ou sem se expor.

O caminho tem nome: inventariar o que já existe, anotar o risco de cada ação, escrever contrato tipado com a Abilities API, manter regra única servindo formulário e agente, dar identidade e escopo a quem chama, registrar tudo o que mudou.

Aquelas três perguntas de prontidão passam a ter resposta dentro do WordPress. O que o meu site sabe fazer? O inventário virado em abilities registradas. Quem pode pedir? Permission Callback com usuário dedicado e Application Password. Como eu provo o que foi feito? Confirmação com ID e estado, mais log estruturado.

Leve uma ability de leitura para a próxima reunião com o seu time técnico. Escolha a pergunta que o seu atendimento mais responde e peça o contrato dela declarado. Uma só.

Antes disso, vale medir onde você está. Nossa equipe montou o Diagnóstico GEO Técnico: você informa o domínio e a ferramenta mostra onde a IA trava ao analisar o seu site. É gratuito. Se preferir aprofundar o contexto, veja também o guia de GEO Técnico e o checklist de visibilidade para IA no WordPress.

E você, me conta: qual é a primeira ação do seu site que você declararia para um agente?

Leandro Vieira

Leandro Vieira é fundador e CEO da Apiki, empresa de engenharia WordPress que atua desde 2008 para que o site das empresas funcione como ativo de receita: no ar, encontrado pelo Google e pelas IAs, gerando leads, audiência ou vendas. Criou o GEO Técnico, metodologia para sites serem acessados, lidos, interpretados e citados pelas IAs, e o BotIAudit, auditoria de logs que mostra o que os robôs de IA conseguem ler de um site. Palestrante em Gramado Summit, Digitalks, Expoleste, AI Brasil e iMasters.
Qual nota você da para este artigo?
Ruim

O que você achou disso?

Clique nas estrelas

Média da classificação 0 / 5. Número de votos: 0

Nenhum voto até agora! Seja o primeiro a avaliar este post.

Excelente
Artigos Relacionados

Construa seu site WordPress sob medida com os maiores especialistas em WordPress da America Latina
Conheça a Apiki

Faça um comentário
Cadastre-se rápido

Fazer Login