TanukiMCP

Automatize e gerencie sites WordPress usando automação de navegador e integração de API.

Documentação

TanukiMCP - Plataforma de Automação WordPress

Um servidor MCP abrangente para automação WordPress. O TanukiMCP fornece ferramentas poderosas baseadas em IA para criar, gerenciar e personalizar sites WordPress através do Model Context Protocol (MCP), compatível com Cursor, Claude e outras ferramentas de IA habilitadas para MCP.

O que é o TanukiMCP?

O TanukiMCP é uma plataforma de automação baseada em nuvem que permite aos usuários executar tarefas complexas do WordPress através de um aplicativo web dedicado. Ele utiliza o Model Context Protocol (MCP) e integra-se diretamente com a WordPress REST API para proporcionar uma experiência de automação perfeita.

Principais benefícios:

  • Nenhum conhecimento de programação necessário
  • Conexão segura com seus sites WordPress
  • Fluxos de trabalho de automação poderosos
  • Visualização em tempo real das alterações
  • Gerenciamento de múltiplos sites
  • Interface visual intuitiva

Integração com o Plugin TanukiMCP Dashboard

O Plugin TanukiMCP Dashboard fornece uma maneira perfeita de integrar os recursos do TanukiMCP diretamente no painel administrativo do seu WordPress. Veja como configurá-lo:

Configuração

  1. Instale e ative o Plugin TanukiMCP Dashboard no seu site WordPress
  2. Navegue até a página de configurações do TanukiMCP no seu painel administrativo do WordPress
  3. Configure as seguintes configurações:
    • API Endpoint: Defina como https://wordpress-mcp.onrender.com/api/v1/
    • API Key: Insira a chave mestra 3c9a406341969edf38b3d6d0c8f7685c

Endpoints Disponíveis

O servidor TanukiMCP expõe estes endpoints REST para o plugin do dashboard:

  • POST /api/v1/edit-site - Para enviar mensagens do editor do site
  • POST /api/v1/execute-workflow - Para executar fluxos de trabalho

Autenticação

Todas as solicitações do plugin do dashboard devem incluir:

  • Cabeçalho Authorization: Bearer 3c9a406341969edf38b3d6d0c8f7685c
  • Cabeçalho Content-Type: application/json

Formato de Resposta

Todos os endpoints retornam respostas neste formato JSON:

  • Sucesso: { "success": true, "data": {...} }
  • Erro: { "success": false, "message": "Error message" }

Recursos

  • Ferramentas de gerenciamento de sites WordPress
  • Ferramentas de planejamento estratégico e design
  • Criação de wireframes e documentos de design
  • Planejamento e visualização da arquitetura do site
  • Criação de páginas e gerenciamento de conteúdo
  • Personalização e gerenciamento de temas
  • Gerenciamento de mídia
  • Configuração de menus e widgets
  • Gerenciamento de usuários
  • Suporte a e-commerce WooCommerce
  • Ferramentas de otimização SEO
  • Análise visual de design
  • Mapeamento da jornada do usuário e otimização de navegação
  • Criação e análise de formulários
  • Auditoria de conteúdo e polimento do site

Começando

Usando com o Cursor IDE

Para conectar o TanukiMCP ao Cursor IDE:

  1. Certifique-se de ter o Cursor instalado (baixe de cursor.sh)
  2. Crie ou edite ~/.cursor/mcp.json (global) ou .cursor/mcp.json (específico do projeto) com:
{
  "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. Reinicie o Cursor
  2. Abra o chat do Cursor e peça para usar as ferramentas do WordPress

Usando com o Smithery

O TanukiMCP está disponível no Smithery! Você pode usá-lo diretamente com:

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

Auto-hospedagem

Você pode implantar este servidor MCP na sua própria infraestrutura:

  1. Clone este repositório
  2. Execute npm install
  3. Defina as variáveis de ambiente necessárias (veja abaixo)
  4. Execute npm start

1. Prepare Seu Site WordPress

Antes de conectar ao WordPress:

2. Prepare Seu Site WordPress

Antes de conectar seu site WordPress ao TanukiMCP:

  1. Tenha um site WordPress ativo com acesso de administrador
  2. Gere uma Senha de Aplicativo:
    • Faça login no seu painel administrativo do WordPress
    • Vá para Usuários → Perfil
    • Role até "Senhas de Aplicativo"
    • Insira um nome para o aplicativo (ex.: "TanukiMCP")
    • Clique em "Adicionar Nova Senha de Aplicativo"
    • Copie a senha gerada para uso posterior

3. Conecte Seu Site WordPress

Para conectar seu site WordPress ao TanukiMCP:

  1. Faça login no seu painel do TanukiMCP
  2. Clique em "Conectar Site WordPress"
  3. Insira a URL do seu site WordPress
  4. Insira seu nome de usuário do WordPress e a senha de aplicativo que você gerou
  5. Clique em "Conectar Site"

Após a conexão, seu site WordPress aparecerá no seu painel e você poderá começar a criar fluxos de trabalho e usar as ferramentas.

Ferramentas Disponíveis

Planejamento e Estratégia

  • Ferramenta de Plano de Negócios: Crie planos de negócios e estratégias para sites WordPress
  • Ferramenta de Wireframe: Projete wireframes para layouts de sites WordPress
  • Ferramenta de Inspiração: Gere ideias criativas e exemplos para sites WordPress
  • Ferramenta de Documento de Design: Crie documentação de design abrangente para projetos WordPress
  • Ferramenta de Design Tokens: Defina e gerencie design tokens para estilização visual consistente
  • Ferramenta de Hierarquia Completa: Gere e visualize hierarquias e estruturas completas do site
  • Ferramenta de Seleção de Temas: Compare e selecione temas WordPress com base nos requisitos
  • Planejador de Modificações: Planeje alterações no site com documentação completa de antes/depois
  • Ferramenta de Sitemap: Gere e configure sitemaps do site

Ferramentas de Execução

  • Ferramenta de Informações do Site: Obtenha informações sobre o site WordPress
  • Gerenciador de Conteúdo: Gerencie conteúdo WordPress (páginas, posts, tipos de post personalizados)
  • Gerenciador de Usuários: Gerencie usuários e funções do WordPress
  • Gerenciador de Plugins: Instale, ative e configure plugins
  • Gerenciador de Configurações: Configure as configurações do site WordPress
  • Ferramenta de Construção de Site: Ferramenta abrangente para construir sites WordPress completos
  • Ferramenta de Configuração: Configure configurações e opções gerais do WordPress
  • Ferramenta de Implementação de Modificações: Aplique modificações planejadas em sites WordPress
  • Personalizador de Temas: Personalize temas WordPress
  • Gerenciador de Temas: Gerencie temas WordPress
  • Gerenciador de Menus: Gerencie menus WordPress
  • Gerenciador de Widgets: Gerencie widgets WordPress
  • Gerenciador de Mídia: Gerencie a biblioteca de mídia do WordPress
  • Gerenciador WooCommerce: Configure e gerencie lojas WooCommerce

Análise e Otimização

  • Analisador de Design: Analise o design do site e sugira melhorias
  • Ferramenta de Auditoria de Conteúdo: Audite o conteúdo do site quanto à qualidade e consistência
  • Polidor de Site: Aplique toques finais e melhorias gerais
  • Gerenciador de SEO: Otimize o site para mecanismos de busca
  • Mapeador de Jornada do Usuário: Mapeie e otimize os fluxos do usuário pelo site
  • Otimizador de Navegação: Analise e otimize a navegação do site
  • Ferramenta de Análise de Formulários: Crie e otimize formulários

Usando a Plataforma

A plataforma TanukiMCP oferece três maneiras principais de automatizar seu site WordPress:

1. Fluxos de Trabalho Prontos para Uso

Navegue e use nossos fluxos de trabalho pré-construídos para tarefas comuns:

  • Redesign da página inicial
  • Configuração de e-commerce
  • Atualização de conteúdo
  • Otimização SEO
  • Limpeza da biblioteca de mídia
  • E muitos outros

2. Construtor de Fluxos de Trabalho Personalizados

Crie seus próprios fluxos de trabalho personalizados combinando ferramentas em um processo sequencial:

  1. Selecione seu site WordPress de destino
  2. Escolha ferramentas da nossa extensa coleção
  3. Configure cada etapa com parâmetros específicos
  4. Salve seu fluxo de trabalho para uso futuro
  5. Execute o fluxo de trabalho e monitore o progresso em tempo real

3. Acesso Direto às Ferramentas

Use ferramentas individuais diretamente para tarefas específicas:

  1. Selecione a ferramenta que você precisa
  2. Configure os parâmetros da ferramenta
  3. Execute a ferramenta e veja os resultados imediatamente

Recurso de Visualização ao Vivo

Nosso recurso exclusivo de Visualização ao Vivo permite que você veja as alterações conforme elas acontecem:

  • Observe a IA fazer alterações no seu site em tempo real
  • Aprove, modifique ou rejeite alterações sugeridas
  • Escolha entre diferentes modos de visualização (editor visual, visualização de código, visualização móvel)
  • Compare estados de antes/depois
  • Garanta controle total sobre o processo de automação

Solução de Problemas

Se você encontrar problemas com o TanukiMCP:

  1. Problemas de Conexão: Verifique se seu site WordPress está acessível e se a senha de aplicativo está correta
  2. Erros de Fluxo de Trabalho: Verifique os logs do fluxo de trabalho para mensagens de erro específicas
  3. Compatibilidade de Ferramentas: Algumas ferramentas podem exigir plugins ou configurações específicas do WordPress
  4. Compatibilidade do Navegador: Certifique-se de usar um navegador moderno (Chrome, Firefox, Safari, Edge)
  5. Limpar Cache: Tente limpar o cache do navegador se a interface parecer quebrada

Variáveis de Ambiente

O servidor TanukiMCP aceita as seguintes variáveis de ambiente:

# 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: As credenciais do WordPress (URL do site, nome de usuário, senha do aplicativo) são fornecidas por solicitação pelo plugin TanukiMCP Dashboard e NÃO devem ser definidas como variáveis de ambiente em implantações de produção. O servidor espera essas credenciais no corpo da solicitação para cada chamada de API.

Autenticação

O TanukiMCP usa um modelo de autenticação simplificado:

  1. Chave de API Mestra: Todas as solicitações devem incluir a chave de API mestra no cabeçalho Authorization:

    Authorization: Bearer 3c9a406341969edf38b3d6d0c8f7685c
    
  2. Identificação do Usuário: Cada solicitação deve incluir o ID do usuário do WordPress no corpo da solicitação:

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

Essa abordagem simplifica a autenticação enquanto ainda permite o rastreamento de uso por usuário do WordPress.

Integração com a API OpenAI

O TanukiMCP integra-se aos modelos GPT-4.1 da OpenAI para fornecer gerenciamento de sites WordPress com tecnologia de IA. O servidor suporta vários níveis de modelos:

  • GPT-4.1 (Padrão): O modelo mais capaz para tarefas complexas do WordPress e codificação
  • GPT-4.1 Mini: Um modelo mais rápido e econômico para tarefas mais simples
  • GPT-4.1 Nano: A opção mais rápida e econômica para tarefas básicas

A integração com a API fornece:

  1. Experiência em WordPress com conhecimento profundo de temas, plugins e funcionalidades principais
  2. Edição automatizada do site e gerenciamento de conteúdo
  3. Automação de fluxos de trabalho para tarefas comuns do WordPress
  4. Rastreamento de uso de tokens e análises

Os usuários podem especificar preferências de modelo em suas solicitações com o parâmetro model_preference:

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

Endpoints da API

Endpoints do Plugin WordPress Dashboard

  • POST /api/v1/edit-site - Para enviar mensagens do editor do site

    {
      "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 executar fluxos de trabalho

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

Endpoints de Análises

  • GET /api/v1/analytics/token-usage?user_id=123&detailed=true - Visualize estatísticas de uso de tokens
  • GET /api/v1/analytics/monthly-report?month=2023-01 - Visualize o relatório mensal de uso de tokens

Suporte

Para assistência com o TanukiMCP:

  • GitHub Issues: Abra uma issue no nosso repositório GitHub
  • Suporte por E-mail: Entre em contato com support@tanukimcp.com

Preços

O TanukiMCP oferece planos de preços flexíveis para atender a diferentes necessidades. Visite tanukimcp.com/pricing para informações de preços atuais.

  • Starter: Para indivíduos com um único site WordPress
  • Business: Para agências e empresas com múltiplos sites WordPress
  • Enterprise: Soluções personalizadas para grandes organizações

Todos os planos incluem acesso às nossas ferramentas principais de automação, com níveis superiores oferecendo mais fluxos de trabalho, sites e recursos avançados.