Se isso parecer muito complexo, n\u00e3o se preocupe. Neste tutorial, forneceremos instru\u00e7\u00f5es passo a passo para configurar seu site WordPress e o cliente MCP do Claude, al\u00e9m de executar opera\u00e7\u00f5es no seu site por meio do Claude Desktop.<\/p>\n
Mas antes de come\u00e7armos com as instru\u00e7\u00f5es, vamos definir os principais conceitos do Model Context Protocol.<\/p>\n
Principais conceitos e defini\u00e7\u00f5es do MCP<\/h2>\n
Se voc\u00ea decidiu permitir que seu site WordPress interaja com um modelo de IA por meio do Model Context Protocol<\/a>, \u00e9 importante entender claramente a cadeia de componentes<\/a> envolvida.<\/p>\n Cliente MCP:<\/strong> \u00c9 um componente de software<\/a> que permite que um host de IA se conecte a um servidor MCP. O host de IA \u00e9 o aplicativo com o qual o usu\u00e1rio interage (como o Claude Desktop<\/a>), enquanto o cliente \u00e9 o componente no n\u00edvel do protocolo que possibilita a conex\u00e3o efetiva com o servidor.<\/p>\n Servidor MCP:<\/strong> \u00c9 um aplicativo de software<\/a> (ou processo) que disponibiliza recursos espec\u00edficos para um aplicativo de IA por meio de um protocolo padronizado. Alguns exemplos incluem servidores de sistemas de arquivos, servidores de bancos de dados, servidores de calend\u00e1rios e outros.<\/p>\n Adaptador MCP:<\/strong> \u00c9 a ponte de tradu\u00e7\u00e3o<\/a> bidirecional entre o Cliente MCP e o n\u00facleo do seu site WordPress. Sua finalidade \u00e9 adaptar as Abilities do seu site WordPress aos elementos do Model Context Protocol, permitindo que agentes de IA descubram e executem os recursos do seu site como Ferramentas MCP<\/a> e leiam seus dados como Recursos MCP<\/a>.<\/p>\n Abilities API:<\/strong> \u00c9 a camada de arquitetura<\/a> que permite que todos os componentes do WordPress, tanto o n\u00facleo quanto os plugins, disponibilizem suas funcionalidades de maneira unificada e compreens\u00edvel para humanos e m\u00e1quinas. Ela permite que os desenvolvedores registrem a\u00e7\u00f5es padronizadas e autodescritivas, com esquemas rigorosos de entrada e sa\u00edda, que a IA pode descobrir e executar de forma aut\u00f4noma.<\/p>\n Ao conectar um agente de IA ao seu site WordPress, voc\u00ea pode aproveitar todo o poder da IA para ler dados ou executar opera\u00e7\u00f5es complexas diretamente do seu aplicativo host de IA.<\/p>\n Por meio do seu host de IA, voc\u00ea pode gerenciar conte\u00fado, realizar tarefas de administra\u00e7\u00e3o e manuten\u00e7\u00e3o, monitorar a integridade do site, gerenciar usu\u00e1rios, atualizar cat\u00e1logos de produtos, analisar pedidos e muito mais. N\u00e3o se trata apenas de executar a\u00e7\u00f5es isoladas; trata-se de gerenciar a infraestrutura do seu site sem precisar abrir o painel de controle do WordPress.<\/p>\n Voc\u00ea pode pedir \u00e0 IA que crie o rascunho de um artigo com base nas suas diretrizes gerais, especificando o tamanho, o tom e a profundidade da an\u00e1lise. Tamb\u00e9m pode instru\u00ed-la a gerar imagens, realizar c\u00e1lculos em tempo real e complementar o conte\u00fado com tabelas de resumo que apresentem porcentagens e valores absolutos.<\/p>\n Considere tamb\u00e9m a efici\u00eancia de automatizar opera\u00e7\u00f5es: gerenciar a integra\u00e7\u00e3o de novos usu\u00e1rios atribuindo automaticamente fun\u00e7\u00f5es com base nas responsabilidades deles dentro da sua organiza\u00e7\u00e3o, analisar o desempenho de vendas por produto no \u00faltimo trimestre ou gerar automaticamente relat\u00f3rios de resumo para sua equipe.<\/p>\n Mas voc\u00ea pode ir ainda mais longe. Gra\u00e7as \u00e0 Abilities API, o WordPress se tornou um hub ag\u00eantico que se integra perfeitamente a fluxos de trabalho automatizados gerenciados por IA. O agente de IA pode monitorar contextos externos, como tend\u00eancias de mercado, varia\u00e7\u00f5es de pre\u00e7os ou condi\u00e7\u00f5es meteorol\u00f3gicas, consultar o banco de dados para verificar n\u00edveis de estoque ou hist\u00f3rico de compras e tomar decis\u00f5es aut\u00f4nomas baseadas em dados.<\/p>\n O propriet\u00e1rio do site precisar\u00e1 apenas fornecer instru\u00e7\u00f5es em linguagem natural ao agente de IA, que ent\u00e3o coordenar\u00e1 todo o fluxo de trabalho operacional.<\/p>\n Antes de come\u00e7armos a trabalhar com c\u00f3digo e configura\u00e7\u00f5es, vamos analisar os requisitos do sistema. Para conectar seu site WordPress a um cliente de IA via MCP, voc\u00ea precisar\u00e1 do seguinte:<\/p>\n Como trabalharemos com a Abilities API<\/a> do WordPress, voc\u00ea precisar\u00e1 de um ambiente de teste ou desenvolvimento<\/a> com o WordPress 6.9<\/a> ou superior. Caso esteja trabalhando localmente, certifique-se de que a reescrita de URLs esteja habilitada.<\/p>\n Primeiro, baixe o arquivo .zip do plugin MCP Adapter<\/a> no GitHub e instale-o no seu site WordPress. Ao ativ\u00e1-lo, o plugin registra automaticamente um servidor MCP padr\u00e3o que pode ser acessado no seguinte endere\u00e7o:<\/p>\n O servidor exige solicita\u00e7\u00f5es autenticadas. Caso envie essa solicita\u00e7\u00e3o sem autentica\u00e7\u00e3o, voc\u00ea receber\u00e1 o seguinte objeto de resposta:<\/p>\n Voltaremos a isso em instantes.<\/p>\n Agora voc\u00ea precisa verificar se o namespace Na resposta, procure pelo namespace Caso ele apare\u00e7a, significa que o servidor MCP est\u00e1 funcionando conforme o esperado. Caso contr\u00e1rio, verifique se o plugin est\u00e1 ativo ou se voc\u00ea est\u00e1 usando a vers\u00e3o correta do WordPress.<\/p>\n Agora que voc\u00ea transformou seu site WordPress em um servidor MCP, vamos registrar a Ability necess\u00e1ria para permitir que o MCP Client do Claude Desktop se comunique com seu site e execute a\u00e7\u00f5es. Em nosso exemplo, voc\u00ea criar\u00e1 um rascunho de artigo.<\/p>\n Abra seu editor de c\u00f3digo preferido, crie um novo arquivo e escreva o seguinte c\u00f3digo<\/p>\n Estes s\u00e3o os principais pontos desse plugin:<\/p>\n N\u00e3o vamos nos aprofundar na Abilities API. Caso queira ou precise saber mais, confira nosso tutorial detalhado Primeiros passos com a Abilities API do WordPress<\/a>.<\/p>\n Agora salve o arquivo, compacte-o em um arquivo zip e envie-o para seu site como um plugin. Depois de ativ\u00e1-lo, voc\u00ea estar\u00e1 pronto para seguir para as pr\u00f3ximas etapas.<\/p>\n Todas as solicita\u00e7\u00f5es enviadas ao servidor MCP do WordPress devem ser autenticadas usando uma Senha de Aplicativo. Para gerar uma Senha de Aplicativo, abra o painel de controle do WordPress, acesse Usu\u00e1rios<\/strong> > Perfil<\/strong> e role para baixo at\u00e9 a se\u00e7\u00e3o Senhas de Aplicativo. Digite um nome para sua senha e clique em Adicionar Nova Senha de Aplicativo<\/strong>.<\/p>\n Isso gerar\u00e1 uma senha para voc\u00ea usar no seu aplicativo. Certifique-se de copiar e colar a senha em um local seguro, pois essa \u00e9 a \u00fanica vez em que voc\u00ea poder\u00e1 visualiz\u00e1-la. Caso a perca, ser\u00e1 necess\u00e1rio criar uma nova.<\/p>\n O WordPress exige uma conex\u00e3o HTTPS para gerar uma Senha de Aplicativo. Caso essa se\u00e7\u00e3o n\u00e3o apare\u00e7a no seu perfil de usu\u00e1rio, verifique se o site est\u00e1 sendo fornecido por HTTPS. Para mais informa\u00e7\u00f5es, consulte a documenta\u00e7\u00e3o oficial<\/a>.<\/p>\n Antes de configurar o Claude Desktop, voc\u00ea pode testar toda a cadeia no Postman, pois isso torna a solu\u00e7\u00e3o de problemas muito mais f\u00e1cil e r\u00e1pida.<\/p>\n Primeiro, teste o handshake inicial enviando a seguinte solicita\u00e7\u00e3o POST:<\/p>\n A solicita\u00e7\u00e3o deve ser autenticada. Ao criar uma nova solicita\u00e7\u00e3o HTTP no Postman, selecione Authorization<\/strong> > Basic Auth<\/strong> e insira seu nome de usu\u00e1rio do WordPress e a Senha de Aplicativo.<\/p>\n Em seguida, adicione os seguintes cabe\u00e7alhos:<\/p>\n Mude para a aba \u201cBody\u201d<\/strong>, selecione \u201craw\u201d<\/strong> > \u201cJSON\u201d<\/strong> e defina o corpo da solicita\u00e7\u00e3o da seguinte forma:<\/p>\n![\"Diagrama](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/mcp-diagram.png\")
O que voc\u00ea pode fazer com o WordPress e o MCP<\/h2>\n
Como conectar um agente de IA ao seu site WordPress via MCP<\/h2>\n
\n
Configurar o WordPress<\/h3>\n
Etapa 1: Instalar o plugin WordPress MCP Adapter<\/h4>\n
https:\/\/yoursite.com\/wp-json\/mcp\/mcp-adapter-default-server<\/code><\/pre>\n{\"code\":\"rest_forbidden\",\"message\":\"Sorry, you are not allowed to do that.\",\"data\":{\"status\":401}}<\/code><\/pre>\nmcp<\/code> est\u00e1 registrado corretamente. Para fazer isso, envie a seguinte solicita\u00e7\u00e3o pelo navegador ou pelo Postman:<\/p>\nhttps:\/\/yoursite.com\/wp-json\/<\/code><\/pre>\nmcp<\/code>:<\/p>\n{\n\t\"name\": \"WordPress 7.0\",\n\t\"description\": \"\",\n\t\"url\": \"http:\/\/yoursite.com\",\n\t\"home\": \"https:\/\/yoursite.com\",\n\t\"gmt_offset\": \"0\",\n\t\"timezone_string\": \"\",\n\t\"page_for_posts\": 0,\n\t\"page_on_front\": 345,\n\t\"show_on_front\": \"page\",\n\t\"namespaces\": [\n\t\t\"oembed\/1.0\",\n\t\t\"mcp\",\n\t\t\"wp\/v2\",\n\t\t\"wp-site-health\/v1\",\n\t\t\"wp-block-editor\/v1\",\n\t\t\"wp-abilities\/v1\"\n\t],\n\t...\n}<\/code><\/pre>\nEtapa 2: Registrar suas Abilities com um plugin<\/h4>\n
<?php\n\/**\n * Plugin Name: My MCP Test Plugin\n * Description: Demonstration plugin for creating posts via MCP.\n * Version: 1.0.0\n *\/\n\nif ( ! defined( 'ABSPATH' ) ) {\n\texit;\n}\n\nadd_action( 'wp_abilities_api_init', 'kinsta_mcp_register_simple_draft_ability' );\n\n\/**\n * Registers a minimal ability to create post drafts.\n * This acts as a formal contract between the underlying PHP logic and the AI client.\n *\n * @return void\n *\/\nfunction kinsta_mcp_register_simple_draft_ability(): void {\n\n\tif ( ! function_exists( 'wp_register_ability' ) ) {\n\t\treturn;\n\t}\n\n\twp_register_ability(\n\t\t'kinsta-plugin\/create-draft',\n\t\tarray(\n\t\t\t'category'\t=> 'post',\n\t\t\t'label'\t => __( 'Create Post Draft', 'kinsta-mcp-draft' ),\n\t\t\t'description' => __( 'Creates a new post draft with a title and content provided by the AI agent.', 'kinsta-mcp-draft' ),\n\t\t\t'input_schema' => array(\n\t\t\t\t'type'\t => 'object',\n\t\t\t\t'properties' => array(\n\t\t\t\t\t'title' => array(\n\t\t\t\t\t\t'type'\t\t=> 'string',\n\t\t\t\t\t\t'description' => __( 'The headline or title of the post draft.', 'kinsta-mcp-draft' ),\n\t\t\t\t\t),\n\t\t\t\t\t'content' => array(\n\t\t\t\t\t\t'type'\t\t=> 'string',\n\t\t\t\t\t\t'description' => __( 'The body text or content generated for the draft.', 'kinsta-mcp-draft' ),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t\t'required' => array( 'title', 'content' ), \/\/ Mandatory fields for the AI payload\n\t\t\t),\n\t\t\t'permission_callback' => function(): bool {\n\t\t\t\treturn current_user_can( 'edit_posts' );\n\t\t\t},\n\t\t\t'execute_callback'\t=> function( array $args ): array {\n\t\t\t\t$post_id = wp_insert_post( array(\n\t\t\t\t\t'post_title' => sanitize_text_field( $args['title'] ),\n\t\t\t\t\t'post_content' => wp_kses_post( $args['content'] ),\n\t\t\t\t\t'post_status' => 'draft',\n\t\t\t\t\t'post_type'\t=> 'post',\n\t\t\t\t) );\n\n\t\t\t\tif ( is_wp_error( $post_id ) ) {\n\t\t\t\t\treturn array( \n\t\t\t\t\t\t'success' => false, \n\t\t\t\t\t\t'error' => $post_id->get_error_message() \n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn array( \n\t\t\t\t\t'success' => true, \n\t\t\t\t\t'message' => __( 'Draft saved successfully!', 'kinsta-mcp-draft' ),\n\t\t\t\t\t'post_id' => $post_id \n\t\t\t\t);\n\t\t\t},\n\n\t\t\t\/\/ Explicitly flag this ability as public to expose it through the default MCP Server\n\t\t\t'meta' => array(\n\t\t\t\t'mcp' => array(\n\t\t\t\t\t'public' => true, \n\t\t\t\t),\n\t\t\t\t\/\/ Also expose within the native WordPress REST API\n\t\t\t\t'show_in_rest' => true,\n\t\t\t),\n\t\t)\n\t);\n}<\/code><\/pre>\n\n
wp_register_ability()<\/code> \u00e0 a\u00e7\u00e3o wp_abilities_api_init<\/code>.<\/li>\nkinsta-plugin\/create-draft<\/code>).<\/li>\ninput_schema<\/code> \u00e9 um array que define o contrato de entrada da Ability. Nesse caso, a Ability espera receber um objeto com duas strings de texto obrigat\u00f3rias: title<\/code> e content<\/code>.<\/li>\npermission_callback<\/code> \u00e9 uma fun\u00e7\u00e3o que verifica se o agente possui as permiss\u00f5es necess\u00e1rias para executar a Ability (edit_posts<\/code>).<\/li>\nexecute_callback<\/code> \u00e9 a fun\u00e7\u00e3o de callback executada quando a Ability \u00e9 acionada. Neste exemplo, wp_insert_post<\/code> \u00e9 usada para criar um novo rascunho de artigo.<\/li>\nmeta.mcp.public<\/code> disponibiliza a Ability por meio do servidor padr\u00e3o do MCP Adapter (saiba mais sobre isso aqui<\/a>).<\/li>\n<\/ul>\nEtapa 3: Gerar uma Senha de Aplicativo<\/h4>\n
Testar toda a cadeia no Postman<\/h3>\n
Passo 1: Teste o handshake inicial<\/h4>\n
https:\/\/yoursite.com\/wp-json\/mcp\/mcp-adapter-default-server<\/code><\/pre>\n![\"Configurar](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/postman-authorization.png\")
Content-Type: application\/json\nAccept: application\/json, text\/event-stream<\/code><\/pre>\n![\"Configurar](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/postman-headers.png\")
{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-03-26\",\"capabilities\":{},\"clientInfo\":{\"name\":\"postman\",\"version\":\"1.0\"}}}<\/code><\/pre>\n![\"Configurar](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/07\/postman-body-settings.png\")