WordPress Reader for Claude Desktop

Acesse feeds, notificações, tags e gerencie blogs do WordPress.com dentro do Claude Desktop.

GitHub
8
Experimente este MCPPatrocinado

Documentação

WordPress Reader for Claude Desktop

Conecte sua conta WordPress.com ao Claude Desktop e acesse seu WordPress Reader, notificações e muito mais diretamente pelo Claude.

✨ O Que Esta Ferramenta Faz

Esta ferramenta permite que você use o Claude Desktop para:

  • 📖 Ler seu feed do WordPress - Veja posts dos blogs que você segue
  • 🔔 Verificar notificações - Veja comentários, curtidas e seguidores
  • 🏷️ Gerenciar tags - Assinar/cancelar assinatura de tópicos
  • 👥 Gerenciar seguidores - Seguir/deixar de seguir blogs
  • 🏢 Ver posts A8C - Receba atualizações da Automattic
  • ⭐ Obter recomendações - Descubra novos blogs

🚀 Configuração Rápida (5 minutos)

Passo 1: Pré-requisitos

Você precisa de:

  • Uma conta WordPress.com
  • Claude Desktop instalado no seu computador
  • Node.js instalado (Baixe aqui)

Passo 2: Obtenha Suas Credenciais do App WordPress.com

  1. Acesse WordPress.com Developer Apps
  2. Clique em "Create New Application"
  3. Preencha:
    • Name: "Claude WordPress Reader" (ou qualquer nome que você preferir)
    • Description: "Personal WordPress Reader for Claude Desktop"
    • Website URL: http://localhost:3000
    • Redirect URI: http://localhost:3000/auth/callback
  4. Clique em "Create"
  5. Copie seu Client ID e Client Secret (você precisará deles no Passo 4)

Passo 3: Execute o Script de Configuração

Abra o Terminal (Mac/Linux) ou Prompt de Comando (Windows) e execute:

# Navigate to this folder
cd path/to/wordpress-reader-mcp

# Run the automated setup
npm run setup

O script irá:

  • Instalar todas as dependências
  • Configurar seu ambiente
  • Compilar os aplicativos
  • Tentar configurar o Claude Desktop automaticamente
  • Iniciar o serviço de autenticação em segundo plano

Passo 4: Insira Suas Credenciais do WordPress

Quando solicitado, insira:

  • Seu Client ID do WordPress.com (do Passo 2)
  • Seu Client Secret do WordPress.com (do Passo 2)

Passo 5: Autentique-se com o WordPress.com

A configuração irá:

  1. Iniciar o servidor de autenticação
  2. Abrir seu navegador para autenticar com o WordPress.com
  3. Configurar tudo automaticamente

Passo 6: Teste no Claude Desktop

Reinicie o Claude Desktop e experimente estes comandos:

  • "Mostre meu feed do WordPress Reader"
  • "Quantas notificações não lidas eu tenho?"
  • "Obtenha posts da tag tecnologia"

🔧 Configuração Manual (Se a Configuração Automática Falhar)

Se a configuração automática não funcionar, siga estes passos manuais:

1. Instale as Dependências

# Install web app dependencies
cd web-app
npm install

# Install MCP server dependencies
cd ../mcp-server  
npm install

# Go back to root
cd ..

2. Configure o Ambiente

Crie o arquivo web-app/.env:

WORDPRESS_CLIENT_ID=your_client_id_here
WORDPRESS_CLIENT_SECRET=your_client_secret_here
REDIRECT_URI=http://localhost:3000/callback
PORT=3000
JWT_SECRET=your_random_secret_here
MCP_SERVER_URL=http://localhost:3001

3. Compile os Aplicativos

cd web-app && npm run build
cd ../mcp-server && npm run build
cd ..

4. Configure o Claude Desktop

Encontre o arquivo de configuração do Claude Desktop:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

Adicione isto à seção mcpServers:

{
  "mcpServers": {
    "wordpress-reader": {
      "command": "node",
      "args": ["FULL_PATH_TO_THIS_FOLDER/mcp-server/dist/index.js"],
    }
  }
}

Substitua FULL_PATH_TO_THIS_FOLDER pelo caminho real desta pasta.

5. Autentique-se

# Start the authentication server
cd web-app && npm run dev

Abra o navegador em http://localhost:3000/auth/test e complete o login no WordPress.com.

📖 Comandos Disponíveis no Claude

Após a configuração, você pode usar estes comandos em linguagem natural no Claude Desktop:

Feed do Reader

  • "Mostre meu feed do WordPress Reader"
  • "Obtenha os últimos 10 posts do meu feed"
  • "Mostre posts de hoje"

Notificações

  • "Verifique minhas notificações do WordPress"
  • "Quantas notificações não lidas eu tenho?"
  • "Mostre apenas notificações de comentários"
  • "Marque minhas notificações como lidas"

Tags e Tópicos

  • "Mostre posts com a tag 'tecnologia'"
  • "Assine-me à tag 'design'"
  • "Quais tags estou seguindo?"

Gerenciamento de Blogs

  • "Mostre blogs que estou seguindo"
  • "Siga o blog example.com"
  • "Obtenha recomendações de blogs para mim"

Conteúdo Automattic

  • "Mostre posts A8C recentes"
  • "Obtenha atualizações da empresa Automattic"

🔍 Solução de Problemas

"Nenhuma ferramenta disponível" ou "Autenticação necessária"

  1. Verifique se o serviço em segundo plano está rodando: npm run service:status
  2. Se não estiver rodando, inicie-o: npm run service:start
  3. Complete a autenticação em http://localhost:3000/auth/test
  4. Reinicie o Claude Desktop

Problemas com o serviço em segundo plano

  1. Verifique o status do serviço: npm run service:status
  2. Veja os logs do serviço: npm run service:logs
  3. Reinicie o serviço: npm run service:restart
  4. Verifique se a porta 3000 está disponível: lsof -i :3000 (Mac/Linux)

"Comando não encontrado: npm"

Instale o Node.js em nodejs.org

Erros de "Permissão negada"

Tente executar com sudo no Mac/Linux ou "Executar como Administrador" no Windows

Autenticação não funcionando

  1. Verifique as credenciais do seu app WordPress.com
  2. Certifique-se de que a redirect URI é exatamente http://localhost:3000/auth/callback
  3. Verifique se o web-app está rodando na porta 3000

Claude Desktop não reconhecendo as ferramentas

  1. Verifique se o caminho do arquivo de configuração está correto
  2. Certifique-se de que o caminho para index.js é absoluto (caminho completo)
  3. Reinicie o Claude Desktop completamente

🛠️ Uso Avançado

Serviço de Autenticação em Segundo Plano

O WordPress Reader executa um serviço de autenticação em segundo plano que gerencia tokens automaticamente. Este serviço precisa rodar constantemente para autenticação contínua.

Comandos de Gerenciamento do Serviço:

# Check service status
npm run service:status

# Start service
npm run service:start

# Stop service
npm run service:stop

# Restart service
npm run service:restart

# View service logs
npm run service:logs

# Check service health
npm run service:health

Gerenciamento Automático do Serviço:

  • O script de configuração inicia o serviço automaticamente
  • O servidor MCP tentará iniciar o serviço se ele não estiver rodando
  • O serviço roda em segundo plano e persiste após reinicializações (com integração opcional ao sistema)

Gerenciamento Manual do Serviço:

# Development mode (with auto-reload)
cd web-app && npm run dev

# Production mode (background service)
npm run service:start

Integração com o Sistema (Opcional): Para iniciar o serviço automaticamente na inicialização do sistema:

# Install as system service
node service-manager.js install

# macOS: Enable with launchctl
# Linux: Enable with systemctl --user

Visualizando Logs

Os logs do servidor MCP estão em: mcp-server/mcp-server.log

Variáveis de Ambiente

Você pode definir estas variáveis no seu shell:

  • DEBUG=true - Ativa logs de depuração
  • NODE_ENV=development - Modo de desenvolvimento

🔒 Segurança e Privacidade

  • Suas credenciais do WordPress.com são armazenadas apenas localmente
  • Tokens de autenticação são armazenados em cache com segurança
  • Nenhum dado é enviado a terceiros
  • Toda comunicação é criptografada (HTTPS/TLS)
  • Proteção de Confidencialidade: Verifica automaticamente o adesivo p2_confidentiality_disabled nos blogs do WordPress.com; só permite acesso de IA a blogs com este adesivo
    • Defina DISABLE_CONFIDENTIALITY_CHECK=true no ambiente do servidor MCP para desativar esta proteção (não recomendado)

📞 Suporte

Se você precisar de ajuda:

  1. Verifique a seção de solução de problemas acima
  2. Procure mensagens de erro no terminal
  3. Verifique os logs do servidor MCP
  4. Certifique-se de que seu app WordPress.com está configurado corretamente

🎉 Aproveite!

Agora você tem integração completa com WordPress.com no Claude Desktop. Explore seus feeds, gerencie notificações e descubra novos conteúdos tudo através de conversa natural com o Claude!