Kantan (WordPress Analytics & SEO)
Servidor MCP somente leitura integrado ao plugin gratuito Kantan Analytics para WordPress. Pergunte ao Claude sobre visitas, páginas, fontes de tráfego, conversões, jornadas dos visitantes, cliques e profundidade de rolagem do seu site. Os dados permanecem no seu próprio banco de dados do WordPress. O Kantan SEO adiciona ferramentas de palavras-chave, Search Console, saúde do site e AEO no mesmo endpoint (/wp-json/kantan/mcp). Requer WordPress 6.9+ e o plugin MCP Adapter.
Documentação
Servidor MCP WordPress: Consulte seu Site com Claude, Edite com REST
01 — O QUE É UM SERVIDOR MCP WORDPRESS
O que é um servidor MCP WordPress?
Um servidor MCP WordPress é um endpoint único em um site WordPress que lista ferramentas tipadas e descobríveis que um cliente de IA pode chamar diretamente — em vez de adivinhar rotas REST ou raspar a tela. O Kantan oferece um para WordPress: 42 ferramentas somente leitura de analytics e SEO atrás de um único endpoint.
MCP — o Model Context Protocol — é um padrão aberto para conectar um agente de IA a um conjunto definido de ferramentas, em vez de fazê-lo adivinhar uma API ou raspar uma tela. Um servidor construído sobre ele lista todas as ferramentas que oferece, cada uma com um nome e uma forma tipada para seus argumentos e resultados, para que qualquer cliente de IA compatível possa descobri-las e chamá-las diretamente.
Um servidor MCP WordPress é essa mesma ideia aplicada a uma instalação WordPress: um endpoint — /wp-json/kantan/mcp no caso do Kantan — que um cliente de IA conecta uma vez e recebe a lista completa do que ele pode fazer naquele site. O Kantan expõe 42 dessas ferramentas, todas somente leitura, descobertas dinamicamente: instalar o Kantan SEO junto com o Kantan Analytics adiciona suas ferramentas ao mesmo servidor automaticamente, sem nada extra para configurar.
DO KANTAN ANALYTICS
19
Ferramentas de leitura que cobrem tráfego, visitantes, jornadas e conversões. Incluídas gratuitamente, em todas as instalações.
DO KANTAN SEO
23
Ferramentas de leitura que cobrem palavras-chave, rankings, pacote de mapas, auditorias de saúde e pontuações de conteúdo. Junta-se ao mesmo servidor no momento em que o plugin é ativado.
02 — POR QUE SOMENTE LEITURA É UMA ESCOLHA DE DESIGN
Por que somente leitura é uma escolha de design.
Não é uma lacuna na lista de ferramentas — são três categorias, deliberadamente mantidas de fora.
Muitos servidores MCP oferecem uma ferramenta que escreve. O do Kantan não oferece, e a lacuna vai mais fundo do que edições de conteúdo — três categorias inteiras de ações ficam atrás de uma chamada REST explícita em vez de uma chamada de ferramenta MCP, porque cada uma gasta algo real no momento em que é acionada.
GATILHOS DE SCAN
POST /health · POST /aeo · POST /performance/scan
Cada um gasta uma chamada contra a cota do Google PageSpeed Insights — compartilhada com tudo o mais naquela conta, não algo para queimar por iniciativa própria de um agente.
PESQUISA DATAFORSEO
Pesquisa de palavras-chave, backlinks e análise de lacuna de concorrentes rodam com as próprias credenciais DataForSEO do proprietário do site — cobranças de terceiros, por chamada, não uma consulta gratuita.
BUSCAS DE SITEMAP
Escanear o sitemap de um concorrente dispara um lote de requisições de saída para o servidor de outra pessoa — algo que não deveria acontecer só porque uma conversa seguiu nessa direção.
O ARGUMENTO
Um agente que pode acionar trabalho cobrável — um scan, uma chamada de pesquisa paga, um lote de requisições de saída — por conta própria, no meio de uma conversa, é um passivo: a pessoa que o executa descobre depois que a cota acabou ou que a fatura chegou, não antes. Então todas as três ficam atrás de uma chamada REST explícita que o usuário faz, ou aprova, ele mesmo — o mesmo princípio que o Kantan aplica a edições de conteúdo na §04, só que para gastos em vez de conteúdo.
03 — CONSULTANDO VIA MCP
Consultando via MCP.
O cliente vê os nomes das ferramentas exatamente como o servidor os entrega — o prefixo do plugin permanece anexado. Uma ferramenta chamada get-keywords dentro do código do próprio Kantan SEO aparece para seu cliente de IA como kantan-seo-get-keywords — essa forma achatada é o que você realmente verá o agente chamar.
Todas as 42 ferramentas.
| FERRAMENTA | RETORNA | PLUGIN |
|---|---|---|
kantan-analytics-get-analytics-overview | Visitas, visitantes únicos, taxa de rejeição e duração para qualquer intervalo de datas | ANALYTICS · GRÁTIS |
kantan-analytics-get-top-pages | Páginas mais vistas com entradas, saídas e tempo na página | ANALYTICS · GRÁTIS |
kantan-analytics-get-traffic-sources | Sessões por canal — orgânico, direto, referência, social, pago | ANALYTICS · GRÁTIS |
kantan-analytics-get-referrers | Domínios de referência classificados por visitas | ANALYTICS · GRÁTIS |
kantan-analytics-get-referrer-detail | Cada sessão que um único referenciador enviou, com páginas de destino | ANALYTICS · GRÁTIS |
kantan-analytics-get-utm-campaigns | Parâmetros UTM capturados com suas sessões e conversões | ANALYTICS · GRÁTIS |
kantan-analytics-get-conversions | Eventos de conversão com tipo, rótulo, valor e origem | ANALYTICS · GRÁTIS |
kantan-analytics-get-user-journeys | Caminhos página por página de sessões individuais | ANALYTICS · GRÁTIS |
kantan-analytics-get-visitors | Perfis de visitantes com nomes gerados, contagens de visitas e última visita | ANALYTICS · GRÁTIS |
kantan-analytics-get-visitor-detail | Histórico completo de um visitante em visitas de retorno | ANALYTICS · GRÁTIS |
kantan-analytics-get-visitor-tech | Discriminações por dispositivo, navegador, SO e resolução de tela | ANALYTICS · GRÁTIS |
kantan-analytics-get-geo | Países e regiões dos visitantes | ANALYTICS · GRÁTIS |
kantan-analytics-get-interactions | Posições de clique e profundidade de rolagem por página | ANALYTICS · GRÁTIS |
kantan-analytics-get-realtime | Quem está no site agora | ANALYTICS · GRÁTIS |
kantan-analytics-get-videos | Impressões de vídeo, reproduções e tempo de exibição | ANALYTICS · GRÁTIS |
kantan-analytics-get-video-detail | Detalhes de reprodução e público de um único vídeo | ANALYTICS · GRÁTIS |
kantan-analytics-get-ai-crawlers | Acessos de GPTBot, ClaudeBot e outros rastreadores de IA por página | ANALYTICS · GRÁTIS |
kantan-analytics-get-business-profile | Os fatos canônicos de negócio do site, mantidos pelo proprietário | ANALYTICS · GRÁTIS |
kantan-analytics-get-404s | Páginas que visitantes pediram e que não existem, com acessos e o link que os enviou | ANALYTICS · GRÁTIS |
kantan-seo-get-seo-overview | Sessões orgânicas, cliques, impressões e valor de conversão | SEO |
kantan-seo-get-gsc-status | Estado da conexão com o Search Console e última sincronização | SEO |
kantan-seo-get-keywords | Consultas classificadas com posição, cliques, impressões e CTR | SEO |
kantan-seo-get-keyword-movers | Palavras-chave subindo ou caindo em relação ao período anterior | SEO |
kantan-seo-get-keyword-history | Histórico diário de posição para uma única palavra-chave | SEO |
kantan-seo-get-keyword-cannibalization | Consultas onde várias páginas competem entre si | SEO |
kantan-seo-get-geo | Cliques, impressões e posição do Search Console por país do pesquisador | SEO |
kantan-seo-get-keyword-countries | Os países onde uma palavra-chave é vista, com cliques, impressões e posição | SEO |
kantan-seo-get-map-pack | Tráfego de pesquisa dividido em resultados orgânicos e links do Perfil da Empresa no Google (pacote de mapas) | SEO |
kantan-seo-get-local-scorecard | Perfis de Empresa e páginas de cidade que estão perdendo terreno, por serviço | SEO |
kantan-seo-get-local-profile | Tudo para um único Perfil de Empresa ou página de cidade | SEO |
kantan-seo-get-content-performance | Tráfego por página, engajamento e métricas orgânicas em uma tabela | SEO |
kantan-seo-get-content-detail | O quadro completo de uma página — tráfego, palavras-chave, conversões, saúde | SEO |
kantan-seo-get-content-scores | Uma pontuação de otimização de 0 a 100 para cada página | SEO |
kantan-seo-get-content-pruning | Páginas que valem atualizar, mesclar ou remover | SEO |
kantan-seo-get-internal-linking | Links sugeridos entre páginas que cobrem termos relacionados | SEO |
kantan-seo-get-health-audit | Problemas na página por gravidade em todo o site | SEO |
kantan-seo-get-performance-results | Pontuações PageSpeed e Core Web Vitals por página | SEO |
kantan-seo-get-performance-history | Histórico de pontuação ao longo do tempo para uma única página | SEO |
kantan-seo-get-aeo-audit | Verificações de prontidão para mecanismos de resposta e pontuação geral | SEO |
kantan-seo-get-competitors | Scans lado a lado de sites concorrentes | SEO |
kantan-seo-get-monthly-report | Um resumo mês a mês de tudo acima | SEO |
kantan-seo-get-saved-reports | Snapshots de relatórios salvos com seu período e data de geração | SEO |
Você não chama essas ferramentas diretamente — você faz uma pergunta, e um cliente conectado, como Claude Code ou Gemini CLI, escolhe a ferramenta adequada para você.
CLAUDE CODE · SOMENTE LEITURA · EXEMPLO ILUSTRATIVO
você › quais palavras-chave mais se moveram este mês?
→ kantan-seo-get-keyword-movers {"days":30}
kantan › "melhores tênis de golfe" subiu da posição 14 para 6. Duas páginas estão competindo por "ajuste de taco de golfe" — vale a pena analisar a canibalização.
Fig. 1 — ilustrativo: o nome da ferramenta e a forma do argumento são reais; a palavra-chave, as posições e a resposta são um exemplo substituto, não uma resposta capturada de nenhum site.
04 — EDITANDO VIA REST
Editando via REST.
Nenhuma das 42 ferramentas MCP pode escrever nada. Quando um agente altera uma página — e apenas o agente do Kantan SEO pode, em um de seus dois modos de escrita — ele faz isso pela API REST padrão do WordPress, o mesmo caminho wp/v2 que todo outro cliente WordPress já usa, não via MCP.
A escrita documentada é uma única chamada: POST /wp/v2/posts/{id} com um corpo de {"title","content"} e sem campo status — que é o que a torna imediata. No momento em que essa requisição chega, a alteração está no ar; o WordPress não a segura para ninguém revisar antes. A aprovação acontece antes, na conversa: o agente propõe a nova cópia exata, você diz sim, e só então a requisição é enviada. O WordPress ainda mantém uma revisão do que a edição substituiu, então uma edição ruim é um rollback pelo histórico de revisões do post, não um ticket de suporte.
MODO GUTENBERG — ESCREVE BLOCOS
Edita o conteúdo de blocos Gutenberg diretamente via wp/v2. O agente propõe a alteração exata, você a aprova na conversa, e a edição entra no ar imediatamente — com uma revisão mantida do que foi substituído.
MODO ACF — ESCREVE CAMPOS
Lê e escreve valores de campos ACF pelo mesmo caminho wp/v2 — o modo a escolher em builds ACF Flexible Content, com o mesmo ciclo idêntico de propor-e-aprovar.
MODO RECOMENDAR — A OPÇÃO DE ZERO ESCRITA
Um modo que nunca envia essa requisição. Ele ainda lê seus dados de SEO via MCP e ainda diz o que mudar — apenas devolve a cópia de substituição finalizada para você colar em seu próprio construtor de páginas, em vez de uma alteração já feita em seu nome.
UMA COISA PARA SER CLARO
A garantia de somente leitura pertence às 42 ferramentas MCP, não à sua credencial. A Senha de Aplicativo com a qual um agente se autentica carrega o acesso total da conta WordPress que a gerou — o WordPress não a limita a somente leitura — então a mesma credencial que permite às ferramentas MCP lerem seus dados também é o que autoriza essa escrita via REST.
05 — RESUMO DA CONFIGURAÇÃO
Configuração, em resumo.
Quatro passos colocam um agente conversando com seu site via MCP. Esta é a versão curta — o passo a passo completo, com os comandos exatos, a configuração de variáveis de ambiente e uma seção de solução de problemas para as partes que confundem as pessoas, vive em sua própria página.
1
Atualize para WordPress 6.9+ e instale o plugin MCP Adapter a partir de seu release no GitHub — ele ainda não está no wordpress.org.
2
Baixe o agente do seu painel Kantan e gere uma Senha de Aplicativo do WordPress para ele se autenticar.
3
Aponte seu cliente — Claude Code ou Gemini CLI — para /wp-json/kantan/mcp, uma vez por site.
4
Faça uma pergunta. Esse é todo o caminho de leitura — nada para aprovar, porque não há nada que ele possa escrever.
06 — FAQ
Perguntas frequentes.
O servidor MCP do Kantan permite que a IA edite meu conteúdo?
Não. Todas as 42 ferramentas que ele expõe são somente leitura — nenhuma delas cria, atualiza ou exclui nada. Quando um agente faz uma edição, ele é instruído a pedir antes de escrever e a fazer a alteração pela API REST separada do WordPress — mas essa requisição tem efeito no momento em que é enviada, não após alguma etapa adicional de revisão. O WordPress mantém uma revisão do que foi substituído, então uma edição ruim é um rollback, não um ticket de suporte.
Preciso do WordPress 6.9?
Sim, especificamente para a conexão MCP — ela depende da API de Abilities que chegou na 6.9. Versões mais antigas ainda servem os endpoints REST comuns do Kantan, então um agente pode recorrer a eles; ele só não consegue se conectar via MCP.
Por que o adaptador MCP não está no wordpress.org?
É um projeto de código aberto separado, em desenvolvimento ativo, que ainda não alcançou um release no wordpress.org. Até lá, você o instala pela página de releases no GitHub em vez de procurá-lo dentro de Plugins → Adicionar Novo.
Meus dados são enviados aos servidores do Kantan?
Não. O servidor MCP que responde a essas chamadas de ferramenta roda na sua própria instalação WordPress, lendo diretamente do seu próprio banco de dados. O Kantan não opera um serviço separado pelo qual as requisições passam e não recebe nem armazena uma cópia dos dados.
Quais clientes de IA funcionam com isso?
Qualquer cliente que fale MCP padrão por HTTP. A Kantan documenta a configuração exata para Claude Code e Gemini CLI — nenhum deles é tratado de forma especial, então a mesma URL do servidor e o mesmo cabeçalho funcionam com ambos.
A Senha de Aplicativo é somente leitura?
Não — vale ser preciso aqui. A garantia de somente leitura pertence às ferramentas MCP, não à credencial. O WordPress não define escopos para Senhas de Aplicativo, então aquela que seu agente usa carrega o acesso total da conta que a criou, incluindo quaisquer gravações REST que essa conta tem permissão de fazer.
簡
Dê ao seu agente o panorama completo.
As ferramentas de análise são gratuitas para sempre. As ferramentas de SEO — palavras-chave, auditorias de saúde, pontuações de conteúdo, PageSpeed — vêm com a Kantan SEO.
$33/trimestre · até 3 sites · teste gratuito de 14 dias
簡単 Kantan — análise e SEO com os quais você pode conversar.