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
- Instale e ative o Plugin TanukiMCP Dashboard no seu site WordPress
- Navegue até a página de configurações do TanukiMCP no seu painel administrativo do WordPress
- Configure as seguintes configurações:
- API Endpoint: Defina como
https://wordpress-mcp.onrender.com/api/v1/ - API Key: Insira a chave mestra
3c9a406341969edf38b3d6d0c8f7685c
- API Endpoint: Defina como
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 sitePOST /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:
- Certifique-se de ter o Cursor instalado (baixe de cursor.sh)
- 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"
]
}
}
}
- Reinicie o Cursor
- 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:
- Clone este repositório
- Execute
npm install - Defina as variáveis de ambiente necessárias (veja abaixo)
- 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:
- Tenha um site WordPress ativo com acesso de administrador
- 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:
- Faça login no seu painel do TanukiMCP
- Clique em "Conectar Site WordPress"
- Insira a URL do seu site WordPress
- Insira seu nome de usuário do WordPress e a senha de aplicativo que você gerou
- 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:
- Selecione seu site WordPress de destino
- Escolha ferramentas da nossa extensa coleção
- Configure cada etapa com parâmetros específicos
- Salve seu fluxo de trabalho para uso futuro
- 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:
- Selecione a ferramenta que você precisa
- Configure os parâmetros da ferramenta
- 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:
- Problemas de Conexão: Verifique se seu site WordPress está acessível e se a senha de aplicativo está correta
- Erros de Fluxo de Trabalho: Verifique os logs do fluxo de trabalho para mensagens de erro específicas
- Compatibilidade de Ferramentas: Algumas ferramentas podem exigir plugins ou configurações específicas do WordPress
- Compatibilidade do Navegador: Certifique-se de usar um navegador moderno (Chrome, Firefox, Safari, Edge)
- 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:
-
Chave de API Mestra: Todas as solicitações devem incluir a chave de API mestra no cabeçalho Authorization:
Authorization: Bearer 3c9a406341969edf38b3d6d0c8f7685c -
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:
- Experiência em WordPress com conhecimento profundo de temas, plugins e funcionalidades principais
- Edição automatizada do site e gerenciamento de conteúdo
- Automação de fluxos de trabalho para tarefas comuns do WordPress
- 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.1basic: 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 tokensGET /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.