TanukiMCP

Automatiza y gestiona sitios WordPress mediante automatización del navegador e integración de API.

Documentación

TanukiMCP - Plataforma de Automatización para WordPress

Un servidor MCP integral para la automatización de WordPress. TanukiMCP proporciona potentes herramientas impulsadas por IA para crear, gestionar y personalizar sitios web de WordPress a través del Protocolo de Contexto de Modelo (MCP), compatible con Cursor, Claude y otras herramientas de IA habilitadas para MCP.

¿Qué es TanukiMCP?

TanukiMCP es una plataforma de automatización basada en la nube que permite a los usuarios realizar tareas complejas de WordPress a través de una aplicación web dedicada. Aprovecha el Protocolo de Contexto de Modelo (MCP) y se integra directamente con la API REST de WordPress para proporcionar una experiencia de automatización sin interrupciones.

Beneficios clave:

  • No se requieren conocimientos de programación
  • Conexión segura a tus sitios de WordPress
  • Potentes flujos de trabajo de automatización
  • Vista previa de cambios en tiempo real
  • Gestión de múltiples sitios
  • Interfaz visual intuitiva

Integración del Plugin de Panel de TanukiMCP

El Plugin de Panel de TanukiMCP proporciona una forma fluida de integrar las capacidades de TanukiMCP directamente en tu panel de administración de WordPress. Así es como configurarlo:

Configuración

  1. Instala y activa el Plugin de Panel de TanukiMCP en tu sitio de WordPress
  2. Navega a la página de configuración de TanukiMCP en tu administrador de WordPress
  3. Configura los siguientes ajustes:
    • Punto de conexión de API: Establecer a https://wordpress-mcp.onrender.com/api/v1/
    • Clave de API: Introduce la clave maestra 3c9a406341969edf38b3d6d0c8f7685c

Puntos de conexión disponibles

El servidor TanukiMCP expone estos puntos de conexión REST para el plugin del panel:

  • POST /api/v1/edit-site - Para enviar mensajes del editor del sitio
  • POST /api/v1/execute-workflow - Para ejecutar flujos de trabajo

Autenticación

Todas las solicitudes del plugin del panel deben incluir:

  • Cabecera Authorization: Bearer 3c9a406341969edf38b3d6d0c8f7685c
  • Cabecera Content-Type: application/json

Formato de respuesta

Todos los puntos de conexión devuelven respuestas en este formato JSON:

  • Éxito: { "success": true, "data": {...} }
  • Error: { "success": false, "message": "Error message" }

Características

  • Herramientas de gestión de sitios de WordPress
  • Herramientas de planificación estratégica y diseño
  • Creación de wireframes y documentos de diseño
  • Planificación y visualización de la arquitectura del sitio
  • Creación de páginas y gestión de contenido
  • Personalización y gestión de temas
  • Gestión de medios
  • Configuración de menús y widgets
  • Gestión de usuarios
  • Soporte de comercio electrónico WooCommerce
  • Herramientas de optimización SEO
  • Análisis visual de diseño
  • Mapeo del recorrido del usuario y optimización de navegación
  • Creación y análisis de formularios
  • Auditoría de contenido y pulido del sitio

Primeros pasos

Uso con Cursor IDE

Para conectar TanukiMCP a Cursor IDE:

  1. Asegúrate de tener Cursor instalado (descárgalo desde cursor.sh)
  2. Crea o edita ~/.cursor/mcp.json (global) o .cursor/mcp.json (específico del proyecto) con:
{
  "mcpServers": {
    "tanuki-wordpress": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@smithery/cli@latest",
        "run",
        "remote",
        "--url",
        "https://wordpress-mcp.onrender.com/sse-cursor",
        "--key",
        "YOUR_API_KEY_HERE"
      ]
    }
  }
}
  1. Reinicia Cursor
  2. Abre el chat de Cursor y pídele que use las herramientas de WordPress

Uso con Smithery

¡TanukiMCP está disponible en Smithery! Puedes usarlo directamente con:

npx @smithery/cli run @tanuki/wordpress-mcp

Autoalojamiento

Puedes implementar este servidor MCP en tu propia infraestructura:

  1. Clona este repositorio
  2. Ejecuta npm install
  3. Establece las variables de entorno requeridas (ver más abajo)
  4. Ejecuta npm start

1. Prepara tu sitio de WordPress

Antes de conectar tu sitio de WordPress a TanukiMCP:

  1. Ten un sitio de WordPress activo con acceso de administrador
  2. Genera una Contraseña de Aplicación:
    • Inicia sesión en tu administrador de WordPress
    • Ve a Usuarios → Perfil
    • Desplázate hasta "Contraseñas de Aplicación"
    • Introduce un nombre para la aplicación (por ejemplo, "TanukiMCP")
    • Haz clic en "Añadir Nueva Contraseña de Aplicación"
    • Copia la contraseña generada para usarla más tarde

2. Conecta tu sitio de WordPress

Para conectar tu sitio de WordPress a TanukiMCP:

  1. Inicia sesión en tu panel de TanukiMCP
  2. Haz clic en "Conectar Sitio de WordPress"
  3. Introduce la URL de tu sitio de WordPress
  4. Introduce tu nombre de usuario de WordPress y la contraseña de aplicación que generaste
  5. Haz clic en "Conectar Sitio"

Una vez conectado, tu sitio de WordPress aparecerá en tu panel y podrás comenzar a crear flujos de trabajo y usar herramientas.

Herramientas disponibles

Planificación y Estrategia

  • Herramienta de Plan de Negocio: Crea planes de negocio y estrategias para sitios de WordPress
  • Herramienta de Wireframe: Diseña wireframes para diseños de sitios de WordPress
  • Herramienta de Inspiración: Genera ideas creativas y ejemplos para sitios de WordPress
  • Herramienta de Documento de Diseño: Crea documentación de diseño integral para proyectos de WordPress
  • Herramienta de Tokens de Diseño: Define y gestiona tokens de diseño para un estilo visual consistente
  • Herramienta de Jerarquía Completa: Genera y visualiza jerarquías y estructuras completas del sitio
  • Herramienta de Selector de Temas: Compara y selecciona temas de WordPress según los requisitos
  • Planificador de Modificaciones: Planifica cambios en el sitio con documentación exhaustiva de antes/después
  • Herramienta de Mapa del Sitio: Genera y configura mapas del sitio

Herramientas de Ejecución

  • Herramienta de Información del Sitio: Obtén información sobre el sitio de WordPress
  • Gestor de Contenido: Gestiona contenido de WordPress (páginas, entradas, tipos de contenido personalizados)
  • Gestor de Usuarios: Gestiona usuarios y roles de WordPress
  • Gestor de Plugins: Instala, activa y configura plugins
  • Gestor de Ajustes: Configura los ajustes del sitio de WordPress
  • Herramienta de Construcción del Sitio: Herramienta integral para construir sitios de WordPress completos
  • Herramienta de Configuración: Configura los ajustes y opciones generales de WordPress
  • Herramienta de Implementación de Modificaciones: Aplica modificaciones planificadas a sitios de WordPress
  • Personalizador de Temas: Personaliza temas de WordPress
  • Gestor de Temas: Gestiona temas de WordPress
  • Gestor de Menús: Gestiona menús de WordPress
  • Gestor de Widgets: Gestiona widgets de WordPress
  • Gestor de Medios: Gestiona la biblioteca de medios de WordPress
  • Gestor de WooCommerce: Configura y gestiona tiendas WooCommerce

Análisis y Optimización

  • Analizador de Diseño: Analiza el diseño del sitio y sugiere mejoras
  • Herramienta de Auditoría de Contenido: Audita el contenido del sitio para calidad y consistencia
  • Pulidor del Sitio: Aplica toques finales y mejoras generales
  • Gestor SEO: Optimiza el sitio para motores de búsqueda
  • Mapeador del Recorrido del Usuario: Mapea y optimiza los flujos de usuario a través del sitio
  • Optimizador de Navegación: Analiza y optimiza la navegación del sitio
  • Herramienta de Análisis de Formularios: Crea y optimiza formularios

Uso de la Plataforma

La plataforma TanukiMCP proporciona tres formas principales de automatizar tu sitio de WordPress:

1. Flujos de Trabajo Listos para Usar

Explora y usa nuestros flujos de trabajo preconstruidos para tareas comunes:

  • Rediseño de página de inicio
  • Configuración de comercio electrónico
  • Actualización de contenido
  • Optimización SEO
  • Limpieza de biblioteca de medios
  • Y muchos más

2. Constructor de Flujos de Trabajo Personalizados

Crea tus propios flujos de trabajo personalizados combinando herramientas en un proceso secuencial:

  1. Selecciona tu sitio de WordPress objetivo
  2. Elige herramientas de nuestra extensa colección
  3. Configura cada paso con parámetros específicos
  4. Guarda tu flujo de trabajo para uso futuro
  5. Ejecuta el flujo de trabajo y monitorea el progreso en tiempo real

3. Acceso Directo a Herramientas

Usa herramientas individuales directamente para tareas específicas:

  1. Selecciona la herramienta que necesitas
  2. Configura los parámetros de la herramienta
  3. Ejecuta la herramienta y ve los resultados inmediatamente

Función de Vista Previa en Vivo

Nuestra función única de Vista Previa en Vivo te permite ver los cambios a medida que ocurren:

  • Observa a la IA hacer cambios en tu sitio en tiempo real
  • Aprueba, modifica o rechaza los cambios sugeridos
  • Elige entre diferentes modos de vista (editor visual, vista de código, vista móvil)
  • Compara estados de antes/después
  • Asegura el control total sobre el proceso de automatización

Solución de Problemas

Si encuentras problemas con TanukiMCP:

  1. Problemas de Conexión: Verifica que tu sitio de WordPress sea accesible y que la contraseña de aplicación sea correcta
  2. Errores de Flujo de Trabajo: Revisa los registros del flujo de trabajo para mensajes de error específicos
  3. Compatibilidad de Herramientas: Algunas herramientas pueden requerir plugins o configuraciones específicas de WordPress
  4. Compatibilidad del Navegador: Asegúrate de usar un navegador moderno (Chrome, Firefox, Safari, Edge)
  5. Limpiar Caché: Intenta limpiar la caché de tu navegador si la interfaz parece rota

Variables de Entorno

El servidor TanukiMCP acepta las siguientes variables de entorno:

# Required Configuration
TANUKIMCP_MASTER_KEY=your_master_api_key

# Optional Server Configuration
PORT=3001 (optional, defaults to 3001)
REQUIRE_API_KEY=true (recommended for production)
HEADLESS=true (optional, for browser automation)
CORS_ALLOW_ORIGIN=* (allows requests from any origin)
CORS_ALLOW_METHODS=GET,HEAD,PUT,PATCH,POST,DELETE,OPTIONS
CORS_ALLOW_HEADERS=Content-Type,Authorization,Accept,Origin,X-Requested-With,X-Api-Key

# OpenAI API Configuration (Required for AI features)
OPENAI_API_KEY=your_openai_api_key
OPENAI_MODEL=gpt-4.1
OPENAI_ADVANCED_MODEL=gpt-4.1
OPENAI_BASIC_MODEL=gpt-4.1-mini
OPENAI_NANO_MODEL=gpt-4.1-nano
OPENAI_MAX_TOKENS=4096
OPENAI_TEMPERATURE=0.7
OPENAI_MAX_CONTEXT_TOKENS=128000

# Analytics Configuration
ANALYTICS_SAVE_INTERVAL_MS=300000
ANALYTICS_DETAILED_LOGGING=false

Importante: Las credenciales de WordPress (URL del sitio, nombre de usuario, contraseña de aplicación) se proporcionan por solicitud mediante el plugin del Panel de TanukiMCP y NO deben establecerse como variables de entorno en implementaciones de producción. El servidor espera estas credenciales en el cuerpo de la solicitud para cada llamada de API.

Autenticación

TanukiMCP utiliza un modelo de autenticación simplificado:

  1. Clave de API Maestra: Todas las solicitudes deben incluir la clave de API maestra en la cabecera de Autorización:

    Authorization: Bearer 3c9a406341969edf38b3d6d0c8f7685c
    
  2. Identificación del Usuario: Cada solicitud debe incluir el ID de usuario de WordPress en el cuerpo de la solicitud:

    {
      "user_id": 123,
      "message": "Your request message"
    }
    

Este enfoque simplifica la autenticación mientras permite el seguimiento de uso por usuario de WordPress.

Integración con la API de OpenAI

TanukiMCP se integra con los modelos GPT-4.1 de OpenAI para proporcionar gestión de sitios de WordPress impulsada por IA. El servidor admite múltiples niveles de modelos:

  • GPT-4.1 (Predeterminado): El modelo más capaz para tareas complejas de WordPress y programación
  • GPT-4.1 Mini: Un modelo más rápido y rentable para tareas más simples
  • GPT-4.1 Nano: La opción más rápida y económica para tareas básicas

La integración de la API proporciona:

  1. Experiencia en WordPress con conocimiento profundo de temas, plugins y funcionalidad principal
  2. Edición automatizada del sitio y gestión de contenido
  3. Automatización de flujos de trabajo para tareas comunes de WordPress
  4. Seguimiento y análisis de uso de tokens

Los usuarios pueden especificar preferencias de modelo en sus solicitudes con el parámetro model_preference:

  • advanced: Usa el modelo GPT-4.1
  • basic: Usa el modelo GPT-4.1-mini

Puntos de Conexión de API

Puntos de Conexión del Plugin de Panel de WordPress

  • POST /api/v1/edit-site - Para enviar mensajes del editor del sitio

    {
      "message": "User message content",
      "target_site_url": "https://example.com",
      "target_site_app_password": "xxxx xxxx xxxx xxxx",
      "user_id": 123,
      "model_preference": "advanced"
    }
    
  • POST /api/v1/execute-workflow - Para ejecutar flujos de trabajo

    {
      "workflow": "optimize_images",
      "parameters": {
        "quality": 85,
        "resize": true
      },
      "user_id": 123
    }
    

Puntos de Conexión de Análisis

  • GET /api/v1/analytics/token-usage?user_id=123&detailed=true - Ver estadísticas de uso de tokens
  • GET /api/v1/analytics/monthly-report?month=2023-01 - Ver informe mensual de uso de tokens

Soporte

Para asistencia con TanukiMCP:

  • Problemas de GitHub: Abre un problema en nuestro repositorio de GitHub
  • Soporte por Correo Electrónico: Contacta a support@tanukimcp.com

Precios

TanukiMCP ofrece planes de precios flexibles para adaptarse a diferentes necesidades. Visita tanukimcp.com/pricing para obtener información de precios actual.

  • Starter: Para individuos con un solo sitio de WordPress
  • Business: Para agencias y empresas con múltiples sitios de WordPress
  • Enterprise: Soluciones personalizadas para grandes organizaciones

Todos los planes incluyen acceso a nuestras herramientas de automatización principales, con niveles superiores que ofrecen más flujos de trabajo, sitios y funciones avanzadas.