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

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?