MCP no WordPress.com

Este texto foi traduzido usando IA. Se você deseja ver o texto original em inglês, clique aqui.

O WordPress.com inclui um servidor MCP (Model Context Protocol) integrado, permitindo uma integração perfeita com agentes de IA compatíveis com MCP, como Claude Desktop, VS Code, Cursor e outros.

O que é MCP?

O MCP é um protocolo aberto que padroniza a forma como aplicações fornecem contexto para LLMs (Large Language Models). Conectar seu agente de IA ao WordPress.com permite que você interaja com sua conta e sites do WordPress.com usando as interfaces de linguagem natural que essas aplicações de IA oferecem.

De forma geral, veja como o MCP adiciona contexto às suas solicitações de IA:

• Você pede ao seu agente de IA alguma informação sobre sua conta ou sites do WordPress.com
• O agente de IA usa um LLM para entender a solicitação e determina que precisa de mais contexto. Ele verifica se existem ferramentas MCP que podem ser usadas para fornecer esse contexto.
• Ele encontra a ferramenta MCP adequada e tenta fazer a solicitação. O agente de IA pede sua permissão para realizar essa solicitação.
• Depois que você concede a permissão, a solicitação da ferramenta MCP é feita e os dados específicos que a ferramenta pode fornecer são retornados. Esses dados são então incluídos na solicitação ao LLM.
• O LLM usa sua solicitação original e o contexto da ferramenta MCP para gerar sua resposta.

Em nenhum momento os dados são compartilhados entre o servidor MCP e o LLM sem que você tenha total controle sobre isso. Além disso, os dados das ferramentas MCP não são usados para treinar modelos de IA; os dados são utilizados apenas uma vez como parte da solicitação original.

Requisitos

Para conectar sua aplicação de agente de IA ao WordPress.com, você simplesmente precisa de:

• Uma conta no WordPress.com com um plano pago
• MCP habilitado na sua conta (veja Habilitar MCP no WordPress.com abaixo)
• Um cliente de IA compatível com MCP, como Claude Desktop, ChatGPT, VS Code ou Cursor

O servidor MCP do WordPress.com usa OAuth 2.1 para autenticação, que gerencia a conexão e a autorização pelo seu navegador; nenhuma instalação de software adicional é necessária.

Conectando seu cliente de IA

Após habilitar o MCP na sua conta do WordPress.com, você pode conectar qualquer cliente de IA compatível com MCP usando a URL do servidor MCP do WordPress.com:

https://public-api.wordpress.com/wpcom/v2/mcp/v1

Claude Desktop

O Claude Desktop se conecta ao WordPress.com por meio do Diretório de Conectores integrado. Para instruções de configuração passo a passo, consulte Edite seu site com o Claude.

Claude Code

O Claude Code se conecta adicionando o servidor MCP do WordPress.com ao seu arquivo de configuração local.

Execute o seguinte comando no seu terminal para adicionar o servidor MCP

claude mcp add --transport http wpcom-mcp https://public-api.wordpress.com/wpcom/v2/mcp/v1

Em seguida, ao usar o Claude Code, execute o comando /mcp para autenticar o servidor wpcom-mcp com sua conta do WordPress.com.

ChatGPT

Conectar o ChatGPT ao WordPress.com requer ativar o Modo Desenvolvedor, criar um aplicativo do WordPress.com pela URL do MCP e selecionar o conector. É necessário ter um plano ChatGPT Plus, Pro, Team ou Enterprise. Para o passo a passo completo, consulte Edite seu site com o ChatGPT.

Codex

O Codex se conecta adicionando o servidor MCP do WordPress.com ao seu arquivo de configuração local.

Execute o seguinte comando no seu terminal para adicionar o servidor MCP:

codex mcp add wpcom-mcp --url https://public-api.wordpress.com/wpcom/v2/mcp/v1

O Codex detectará automaticamente que o servidor MCP do WordPress.com precisa ser autenticado e iniciará o fluxo de autenticação OAuth.

No entanto, se você precisar autenticar manualmente, execute o seguinte comando no terminal:

codex mcp login wpcom-mcp

Cursor

Para conectar o Cursor ao WordPress.com usando o Cursor Plugin Directory:

1. Abra um navegador web e acesse https://cursor.directory/

2. Pesquise por “WordPress.com” e clique no item WordPress.com na lista.

3. Clique no botão “Add to Cursor” (Adicionar ao Cursor).

4. Isso acionará uma ação do navegador que abrirá o aplicativo Cursor e adicionará a configuração do MCP às configurações de Tools & MCP.
5. Clique em Install (Instalar) para iniciar o fluxo de autorização entre o Cursor e sua conta WordPress.com.

6. Conceda ao Cursor acesso à sua conta WordPress.com pelo navegador.

7. Quando a conexão estiver concluída, o Cursor terá acesso aos seus sites WordPress.com por meio das ferramentas MCP.

Outros Clientes

Para outros clientes compatíveis com MCP, consulte a documentação do seu cliente para saber como adicionar um servidor MCP e use a URL:

https://public-api.wordpress.com/wpcom/v2/mcp/v1

O fluxo de autenticação OAuth 2.1 guiará você automaticamente pela autorização baseada no navegador.

Clientes compatíveis

Você pode usar qualquer aplicativo cliente de IA compatível com MCP para se conectar ao WordPress.com. Se você ainda não tem um, listamos alguns dos mais populares abaixo.

• Claude Desktop
• VS Code
• Cursor

Ferramentas MCP disponíveis

Todas as ferramentas MCP do WordPress.com estão listadas na documentação Referência de Ferramentas MCP do WordPress.com.

Habilitar MCP no WordPress.com

Para usar o MCP no WordPress.com, você precisa concluir as seguintes etapas:

1. Habilitar o MCP na sua conta do WordPress.com
2. Conectar seu cliente de IA compatível com MCP
3. Aceitar a solicitação de autenticação OAuth

Para ativar o MCP na sua conta WordPress.com, acesse as configurações de MCP aqui, ou:

1. Faça login no painel do WordPress.com.
2. Passe o mouse sobre seu nome no canto superior direito e clique em “Minha conta WordPress.com.“
3. Clique em MCP na página Meu Perfil.

Para ativar o MCP na sua conta:

1. Ative a opção “Habilitar acesso MCP.”

2. Por padrão, todas as ferramentas MCP somente leitura estão habilitadas, e as ferramentas de escrita estão desabilitadas.

3. Você pode ativar ou desativar ferramentas específicas de leitura ou escrita clicando no painel correspondente.

4. Para configurar um cliente MCP, clique no botão “Conectar assistente de IA externo”.
5. Na página Conectar agente de IA, selecione o cliente que deseja configurar no menu suspenso. A página exibirá uma opção de Configuração rápida e/ou uma opção de Configuração manual.
   • Configuração rápida: essa opção permite configurar o MCP com apenas um clique para alguns dos clientes disponíveis.
   • Configuração manual: trata-se de uma configuração JSON manual que você precisará colar no seu aplicativo cliente. Consulte as instruções de configuração vinculadas para garantir que a conexão MCP seja configurada corretamente no seu aplicativo cliente.

Desativar o acesso MCP para sites específicos

Abaixo das configurações de ferramentas de leitura e escrita, você também pode desativar o acesso MCP a sites específicos.

Desativar o acesso a sites específicos bloqueará todas as ferramentas MCP para todos os usuários naquele site e substituirá as configurações da sua conta para aquele site.

Para bloquear o acesso MCP de um site:

1. Pesquise ou selecione um site na lista de sites disponíveis
2. O site será adicionado automaticamente à lista de Sites restritos

3. Você pode habilitar o acesso MCP para sites específicos da mesma forma, clicando em “Remover” ao lado do site na lista Sites restritos.

Autenticação

O servidor MCP do WordPress.com usa OAuth 2.1 para autenticação segura. O OAuth 2.1 é o padrão OAuth mais recente, incorporando as melhores práticas modernas de segurança, incluindo:

• PKCE (Proof Key for Code Exchange): Protege contra a interceptação do código de autorização
• Registro Dinâmico de Cliente: Seu cliente de IA pode se registrar automaticamente
• Rotação de Tokens: Segurança aprimorada por meio da atualização automática de tokens
• Sem Necessidade de Client Secrets: Autenticação segura sem armazenar credenciais sensíveis

Como funciona

1. Quando você adicionar o servidor MCP do WordPress.com ao seu cliente de IA, o cliente tentará se conectar
2. Seu navegador abrirá automaticamente na página de autorização do WordPress.com
3. Faça login na sua conta do WordPress.com (caso ainda não tenha efetuado login)
4. Revise e autorize a conexão
5. Você será redirecionado de volta ao seu cliente de IA, que agora poderá acessar seus sites do WordPress.com

Gerenciando conexões

Você pode desconectar seu cliente de IA a qualquer momento pela sua conta WordPress.com:

1. Acesse Segurança → Aplicativos conectados
2. Encontre seu cliente de IA na lista (ele pode aparecer como “MCP Client” ou com o nome do seu cliente)
3. Clique em Desconectar para revogar o acesso

O fluxo OAuth 2.1 garante que suas credenciais do WordPress.com nunca sejam armazenadas no seu computador nem compartilhadas com seu cliente de IA; apenas tokens de acesso seguros e com prazo de expiração são utilizados.

Solução de problemas

Problemas de conexão

Se você está tendo dificuldades para se conectar ao servidor MCP do WordPress.com:

1. Verifique se o MCP está ativado: Confirme que o MCP está ativado na sua conta WordPress.com
2. Confira a URL: Certifique-se de que está usando a URL correta do servidor: https://public-api.wordpress.com/wpcom/v2/mcp/v1
3. Revise a autorização: Verifique se você concluiu o fluxo de autorização OAuth no seu navegador
4. Confira os aplicativos conectados: Acesse Aplicativos conectados para verificar se seu cliente está conectado
5. Reinicie seu cliente: Tente reiniciar o aplicativo do seu cliente de IA
6. Verifique os logs do cliente: Consulte a documentação do seu cliente de IA para saber como visualizar os logs de conexão

Desativando ferramentas

Se você desativar qualquer ferramenta na sua conta ou desativar o MCP em qualquer site, será necessário reiniciar a conexão do servidor MCP no seu cliente de IA. Isso permite que o aplicativo cliente atualize a lista de ferramentas disponíveis.