WordPress Reader for Claude Desktop

Accede a feeds, notificaciones, etiquetas de WordPress.com y gestiona blogs dentro de Claude Desktop.

GitHub
8
Prueba este MCPPatrocinado

Documentación

WordPress Reader para Claude Desktop

Conecta tu cuenta de WordPress.com a Claude Desktop y accede a tu lector de WordPress, notificaciones y más directamente desde Claude.

✨ Qué hace esto

Esta herramienta te permite usar Claude Desktop para:

  • 📖 Leer tu feed de WordPress - Ver publicaciones de los blogs que sigues
  • 🔔 Revisar notificaciones - Ver comentarios, me gusta y seguidores
  • 🏷️ Gestionar etiquetas - Suscribirte/cancelar suscripción a temas
  • 👥 Gestionar seguimientos - Seguir/dejar de seguir blogs
  • 🏢 Ver publicaciones de A8C - Obtener actualizaciones de la empresa Automattic
  • ⭐ Obtener recomendaciones - Descubrir nuevos blogs

🚀 Configuración rápida (5 minutos)

Paso 1: Requisitos previos

Necesitas:

  • Una cuenta de WordPress.com
  • Claude Desktop instalado en tu computadora
  • Node.js instalado (Descargar aquí)

Paso 2: Obtén tus credenciales de aplicación de WordPress.com

  1. Ve a Aplicaciones para desarrolladores de WordPress.com
  2. Haz clic en "Crear nueva aplicación"
  3. Completa:
    • Nombre: "Claude WordPress Reader" (o cualquier nombre que prefieras)
    • Descripción: "Lector personal de WordPress para Claude Desktop"
    • URL del sitio web: http://localhost:3000
    • URI de redirección: http://localhost:3000/auth/callback
  4. Haz clic en "Crear"
  5. Copia tu ID de cliente y Secreto de cliente (los necesitarás en el Paso 4)

Paso 3: Ejecuta el script de configuración

Abre Terminal (Mac/Linux) o Símbolo del sistema (Windows) y ejecuta:

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

# Run the automated setup
npm run setup

El script:

  • Instalará todas las dependencias
  • Configurará tu entorno
  • Compilará las aplicaciones
  • Intentará configurar Claude Desktop automáticamente
  • Iniciará el servicio de autenticación en segundo plano

Paso 4: Ingresa tus credenciales de WordPress

Cuando se te solicite, ingresa:

  • Tu ID de cliente de WordPress.com (del Paso 2)
  • Tu Secreto de cliente de WordPress.com (del Paso 2)

Paso 5: Autentícate con WordPress.com

La configuración:

  1. Iniciará el servidor de autenticación
  2. Abrirá tu navegador para autenticarte con WordPress.com
  3. Configurará todo automáticamente

Paso 6: Prueba en Claude Desktop

Reinicia Claude Desktop y prueba estos comandos:

  • "Muéstrame mi feed del lector de WordPress"
  • "¿Cuántas notificaciones no leídas tengo?"
  • "Obtén publicaciones de la etiqueta tecnología"

🔧 Configuración manual (si la configuración automática falla)

Si la configuración automática no funciona, sigue estos pasos manuales:

1. Instala dependencias

# Install web app dependencies
cd web-app
npm install

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

# Go back to root
cd ..

2. Configura el entorno

Crea el archivo 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. Compila las aplicaciones

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

4. Configura Claude Desktop

Encuentra tu archivo de configuración de Claude Desktop:

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

Agrega esto a la sección mcpServers:

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

Reemplaza FULL_PATH_TO_THIS_FOLDER con la ruta real a esta carpeta.

5. Autentícate

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

Abre el navegador en http://localhost:3000/auth/test y completa el inicio de sesión de WordPress.com.

📖 Comandos disponibles en Claude

Una vez configurado, puedes usar estos comandos en lenguaje natural en Claude Desktop:

Feed del lector

  • "Muéstrame mi feed del lector de WordPress"
  • "Obtén las últimas 10 publicaciones de mi feed"
  • "Muéstrame publicaciones de hoy"

Notificaciones

  • "Revisa mis notificaciones de WordPress"
  • "¿Cuántas notificaciones no leídas tengo?"
  • "Muéstrame solo notificaciones de comentarios"
  • "Marca mis notificaciones como leídas"

Etiquetas y temas

  • "Muéstrame publicaciones etiquetadas con 'tecnología'"
  • "Suscríbeme a la etiqueta 'diseño'"
  • "¿Qué etiquetas estoy siguiendo?"

Gestión de blogs

  • "Muéstrame los blogs que sigo"
  • "Sigue el blog example.com"
  • "Dame recomendaciones de blogs"

Contenido de Automattic

  • "Muéstrame publicaciones recientes de A8C"
  • "Obtén actualizaciones de la empresa Automattic"

🔍 Solución de problemas

"No hay herramientas disponibles" o "Se requiere autenticación"

  1. Verifica si el servicio en segundo plano está ejecutándose: npm run service:status
  2. Si no está ejecutándose, inícialo: npm run service:start
  3. Completa la autenticación en http://localhost:3000/auth/test
  4. Reinicia Claude Desktop

Problemas con el servicio en segundo plano

  1. Verifica el estado del servicio: npm run service:status
  2. Consulta los registros del servicio: npm run service:logs
  3. Reinicia el servicio: npm run service:restart
  4. Verifica si el puerto 3000 está disponible: lsof -i :3000 (Mac/Linux)

"Comando no encontrado: npm"

Instala Node.js desde nodejs.org

Errores de "Permiso denegado"

Intenta ejecutar con sudo en Mac/Linux o "Ejecutar como administrador" en Windows

La autenticación no funciona

  1. Verifica tus credenciales de la aplicación de WordPress.com
  2. Asegúrate de que la URI de redirección sea exactamente http://localhost:3000/auth/callback
  3. Verifica que la aplicación web se esté ejecutando en el puerto 3000

Claude Desktop no reconoce las herramientas

  1. Verifica que la ruta del archivo de configuración sea correcta
  2. Asegúrate de que la ruta a index.js sea absoluta (ruta completa)
  3. Reinicia Claude Desktop por completo

🛠️ Uso avanzado

Servicio de autenticación en segundo plano

WordPress Reader ejecuta un servicio de autenticación en segundo plano que gestiona los tokens automáticamente. Este servicio debe ejecutarse constantemente para una autenticación fluida.

Comandos de gestión del servicio:

# 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

Gestión automática del servicio:

  • El script de configuración inicia el servicio automáticamente
  • El servidor MCP intentará iniciar el servicio si no está ejecutándose
  • El servicio se ejecuta en segundo plano y persiste tras reinicios (con integración opcional del sistema)

Gestión manual del servicio:

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

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

Integración con el sistema (opcional): Para iniciar el servicio automáticamente al arrancar el sistema:

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

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

Visualización de registros

Los registros del servidor MCP están en: mcp-server/mcp-server.log

Variables de entorno

Puedes configurar estas en tu shell:

  • DEBUG=true - Habilita el registro de depuración
  • NODE_ENV=development - Modo de desarrollo

🔒 Seguridad y privacidad

  • Tus credenciales de WordPress.com se almacenan solo localmente
  • Los tokens de autenticación se almacenan en caché de forma segura
  • No se envían datos a terceros
  • Toda la comunicación está cifrada (HTTPS/TLS)
  • Protección de confidencialidad: Verifica automáticamente la etiqueta p2_confidentiality_disabled en los blogs de WordPress.com; solo permite el acceso de IA a blogs con esta etiqueta
    • Configura DISABLE_CONFIDENTIALITY_CHECK=true en el entorno del servidor MCP para deshabilitar esta protección (no recomendado)

📞 Soporte

Si necesitas ayuda:

  1. Consulta la sección de solución de problemas anterior
  2. Busca mensajes de error en la terminal
  3. Revisa los registros del servidor MCP
  4. Asegúrate de que tu aplicación de WordPress.com esté configurada correctamente

🎉 ¡Disfruta!

Ahora tienes integración completa de WordPress.com en Claude Desktop. Explora tus feeds, gestiona notificaciones y descubre contenido nuevo todo a través de conversación natural con Claude.