MCP WordPress Server

🚀 MCP WordPress Server

🎯 Por que este Servidor MCP?

Transforme o gerenciamento do WordPress de painéis administrativos complexos em conversas simples:

❌ Before: Login → Admin Panel → Navigate → Click → Fill Forms → Save
✅ After:  "Create a new blog post about AI trends with SEO optimization"

Principais Vantagens:

• 🏆 Mais Completo: 71 ferramentas vs 20-30 em alternativas
• ⚡ Configuração Mais Rápida: Instalação em 2 cliques no Claude Desktop via DXT
• 🔒 Testado em CI: Mais de 2750 testes nos Node 20/22/24, varredura de segurança CodeQL + Trivy
• 🎯 TypeScript Nativo: 100% de segurança de tipos, melhor experiência para desenvolvedores
• 🌐 Multi-Site: Gerencie até 50 sites WordPress em um só lugar

🚀 Início Rápido

Comece a usar em menos de 5 minutos:

Pré-requisitos

• WordPress: Versão 5.6+ com API REST habilitada
• Claude Desktop: Versão mais recente instalada
• Senha de Aplicativo: Gerada no painel administrativo do WordPress

Configuração em 3 Etapas

1️⃣ Gere a Senha de Aplicativo do WordPress

WordPress Admin → Users → Profile → Application Passwords → Add New

2️⃣ Instale o Servidor MCP (Escolha Uma Opção)

Opção A: Extensão DXT (Mais Fácil)

# Download and install in Claude Desktop
curl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt
# Then: Claude Desktop → Extensions → Install → Select DXT file

Opção B: Instalação Global via NPM

npm install -g mcp-wordpress

3️⃣ Teste Sua Conexão

In Claude: "Test my WordPress connection"
Response: "✅ Authentication successful! Connected to: Your Site Name"

📺 Assista ao Vídeo de Configuração de 2 Minutos | 📖 Guia de Configuração Detalhado

⚡ Opções de Instalação

🏆 Recomendado: Extensão para Claude Desktop (DXT)

Instalação mais fácil - apenas 2 cliques!

1. Baixe: mcp-wordpress.dxt (3,4MB)
2. Instale: Claude Desktop → Extensões → Instalar → Selecione o arquivo DXT
3. Configure: Insira a URL do seu site WordPress e as credenciais

✅ Nenhuma linha de comando necessária ✅ Atualizações fáceis ✅ Segurança integrada

📖 Guia Completo de Configuração DXT →

🚀 Alternativa: NPX (Usuários Avançados)

# Run directly - always latest version
npx -y mcp-wordpress

# Interactive setup wizard
npm run setup

🔧 Outras Opções

• 💻 Configuração NPM - Desenvolvimento local
• 🐳 Configuração Docker - Implantação em produção
• 🔧 Compilação Manual - Compilações personalizadas

📋 Configuração

Site Único (.env)

WORDPRESS_SITE_URL=https://myblog.com
WORDPRESS_USERNAME=admin
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

Configuração do Claude Desktop

{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://myblog.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

📖 Guia Completo de Configuração — multi-site, JWT, Docker, ambientes de produção

🔐 Autenticação

As Senhas de Aplicativo do WordPress são recomendadas:

1. Admin do WordPress → Usuários → Perfil → Senhas de Aplicativo → Adicionar Nova
2. Copie a senha gerada para sua configuração

Métodos alternativos: JWT, Autenticação Básica, Chave de API — consulte Configuração de Autenticação

🌟 O Que Torna Isso Especial

Recurso	Este Servidor	Concorrência
Ferramentas Disponíveis	71 ferramentas	20-30 ferramentas
Claude Desktop DXT	✅ Instalação em 2 cliques	❌ Configuração manual
Suporte Multi-Site	✅ Até 50 sites	❌ Site único
TypeScript	✅ 100% TypeScript, modo estrito	⚠️ Parcial/Nenhum
Monitoramento de Desempenho	✅ Análises em tempo real	❌ Básico apenas
Cobertura de Testes	✅ Mais de 2750 testes, ~76% de cobertura de linhas	⚠️ Limitada
Varredura de Segurança	✅ CodeQL + Trivy no CI	⚠️ Desconhecida

📋 Ferramentas Disponíveis (71 Ferramentas)

Gerenciamento de Conteúdo

• 📝 Posts (6 ferramentas) - Criar, editar, excluir, listar posts e revisões
• 📄 Páginas (6 ferramentas) - Gerenciar páginas estáticas e revisões
• 🖼️ Mídia (5 ferramentas) - Enviar, gerenciar biblioteca de mídia e arquivos
• 🔍 SEO (11 ferramentas) - Análise de conteúdo, metadados, marcação de schema, rastreamento de SERP, pesquisa de palavras-chave

Usuários e Comunidade

• 👥 Usuários (6 ferramentas) - Gerenciamento de usuários e perfis
• 💬 Comentários (7 ferramentas) - Moderação e gerenciamento de comentários
• 🏷️ Taxonomias (10 ferramentas) - Gerenciamento de categorias e tags

Gerenciamento do Site

• ⚙️ Configurações do Site (6 ferramentas) - Configuração e estatísticas do site
• 🔐 Autenticação (3 ferramentas) - Teste e gerenciamento de autenticação
• ⚡ Gerenciamento de Cache (4 ferramentas) - Controle de cache de desempenho
• 📊 Monitoramento de Desempenho (6 ferramentas) - Métricas em tempo real e otimização
• 🛠️ Sistema (1 ferramenta) - Verificação de versão

📖 Documentação Completa das Ferramentas | Referência da API ao Vivo

🤖 Exemplos

💬 "Create a new blog post about AI trends with SEO optimization"
💬 "Check my WordPress site performance and provide optimization recommendations"
💬 "Find all draft posts older than 30 days and provide a summary"
💬 "Batch update all client sites with the new privacy policy footer"
💬 "List all posts from my client-blog site"

📖 Mais Exemplos | Fluxos de Trabalho do Mundo Real

🧪 Testes e Segurança

npm test              # Full test suite (2750/2750 passing, 94 files)
npm run test:security # Security tests (371/371 passing)
npm run health        # System health check

📖 Documentação de Segurança — Cobertura OWASP, testes de penetração, conformidade

🛠️ Solução de Problemas

npm run health         # System check
DEBUG=true npm run dev # Debug logging
npm run fix:rest-auth  # Fix WordPress 401 errors

Erro	Solução
401 Unauthorized	Regere a senha do aplicativo
403 Forbidden	Verifique a função do usuário (Editor+ necessário)
404 Not Found	Verifique WORDPRESS_SITE_URL
Connection Timeout	Verifique o acesso à API REST do WordPress

📖 Guia Completo de Solução de Problemas

📚 Documentação

Primeiros Passos

• Guia de Início Rápido - Comece em 5 minutos
• Guia de Instalação - Instruções detalhadas de configuração
• Guia de Configuração - Todas as opções de configuração
• Configuração de Autenticação - Métodos de autenticação do WordPress

Guias do Usuário

• Uso Básico - Tarefas e fluxos de trabalho comuns
• Fluxos de Trabalho Avançados - Automação complexa
• Gerenciamento Multi-Site - Gerenciando vários sites
• Solução de Problemas - Problemas comuns e soluções

Guias de Integração

• Claude Desktop - Integração completa com Claude
• VS Code - Configuração da extensão VS Code
• Cline - Integração com o assistente de IA Cline
• Guia do Desenvolvedor - Crie seu próprio cliente MCP

Documentação do Desenvolvedor

• Referência da API - Documentação completa das ferramentas
• Arquitetura - Design do sistema e decisões
• Contribuindo - Diretrizes de desenvolvimento
• Sistema de Compilação - Compilação e lançamento

Implantação e Operações

• Implantação Docker - Implantação em contêiner
• Solução de Problemas de Publicação - Corrija problemas de publicação
• Melhores Práticas de Segurança - Segurança em produção
• Cache - Guia de desempenho e cache

🔧 Requisitos

• WordPress 5.0+ com API REST habilitada
• HTTPS recomendado para produção
• Senhas de Aplicativo habilitadas (WordPress 5.6+)

Função	Acesso
Administrador	Acesso total a todas as funções
Editor	Posts, páginas, comentários, mídia
Autor	Próprios posts e mídia
Colaborador	Próprios posts (somente rascunhos)
Assinante	Somente leitura

🚀 Próximos Passos

Pronto para transformar seu gerenciamento do WordPress?

1. 🏆 Baixe a Extensão DXT - Configuração mais fácil (2 minutos)
2. ⚡ Experimente o Método NPX - Configuração para usuários avançados (5 minutos)
3. 📚 Explore Todas as Ferramentas - Veja o que é possível
4. 💬 Participe das Discussões - Obtenha ajuda e compartilhe ideias

---

🔗 Projetos Semelhantes

• Automattic WordPress MCP - Servidor MCP WordPress oficial da Automattic

---

📋 Histórico de Versões

v3.3.21 (Julho de 2026)

• 🔒 Reforço de Segurança - Lista de bloqueio SSRF, aplicação de HTTPS, redação de logs, atualizações de dependências mínimas
• 🐳 Confiabilidade de Lançamento Docker - Timeouts limitados para trabalhos de publicação e lógica corrigida de nova tentativa em caso de travamento
• 📚 Documentação DOX - Árvore de contratos AGENTS.md hierárquica para orientação de trabalho por diretório

Consulte CHANGELOG.md para o histórico completo, versão por versão.

v3.3.14 (Junho de 2026)

• 🔒 Atualizações de Segurança - Corrige vulnerabilidades moderadas do Hono, atualiza avisos permitidos de pacotes npm
• 🧪 CI - Melhorias nos testes de fumaça e validação do Node 24

Série v3.x (2025–2026)

• 🏗️ Arquitetura Modular - Módulos de operação específicos por domínio e padrão de composição
• 🔄 Tolerância a Falhas - Padrão de disjuntor com recuperação automática
• 📊 Mais de 2200 Testes - Suíte de testes abrangente em segurança, cache, servidor, cliente, configuração, utilitários, ferramentas e desempenho
• ⚡ Camada de Cache - CachedWordPressClient com TTL configurável; solicitações repetidas 50–70% mais rápidas
• 🌐 Multi-Site - Até 50 sites WordPress a partir de um único arquivo de configuração
• 🔐 4 Métodos de Autenticação - Senhas de Aplicativo (recomendado), JWT, Básica, Chave de API
• 🐳 Docker e DXT - Extensão para Claude Desktop com um clique e imagem no Docker Hub

Para o histórico completo, consulte CHANGELOG.md.

---

🙏 Agradecimentos

Agradecimentos especiais a Stephan Ferraro pelo projeto upstream que inspirou esta implementação.

---