Servidor MCP
Gerencie sua loja WAzion a partir do Claude Desktop, ChatGPT, Cursor, VS Code e qualquer cliente compatível com MCP.
1. O que é MCP?
MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA se conectem a serviços externos. É como um “USB universal“ para a IA: qualquer cliente compatível pode usar as ferramentas que WAzion expõe.
O que significa para você?
- 1 Você pode gerenciar sua loja WAzion a partir do Claude Desktop, ChatGPT, Cursor ou VS Code.
- 2 mostre-me o estado da minha loja“ ou “mude o idioma para inglês
- 3 Todas as ações do painel estão disponíveis como ferramentas MCP
2. Como conectar
Dados de conexão:
URL: https://www.wazion.com/api/mcp/
Auth: Bearer SEU_TOKEN
Pré-requisito: instale o mcp-remote com Node.js do Homebrew:
/opt/homebrew/bin/npm install -g mcp-remoteEdite o arquivo de configuração:
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"wazion": {
"command": "/opt/homebrew/bin/node",
"args": [
"/opt/homebrew/lib/node_modules/mcp-remote/dist/proxy.js",
"https://www.wazion.com/api/mcp/",
"--transport", "http-only",
"--header", "Authorization: Bearer TU_TOKEN"
]
}
}
}Nota: Claude Desktop usa o Node.js do sistema (/usr/local/bin/node) que pode ser antigo. Por isso, referenciamos diretamente o binário do Homebrew.
// .mcp.json en tu proyecto
{
"mcpServers": {
"wazion": {
"type": "url",
"url": "https://www.wazion.com/api/mcp/",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}- 1 Configurações → Conexões → Adicionar Conexão
-
2
URL:
https://www.wazion.com/api/mcp/ - 3 Auth: Token Bearer
// .cursor/mcp.json
{
"mcpServers": {
"wazion": {
"url": "https://www.wazion.com/api/mcp/",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}// .vscode/mcp.json
{
"servers": {
"wazion": {
"type": "http",
"url": "https://www.wazion.com/api/mcp/",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}Outros clientes (Windsurf, Cline, etc.)
Qualquer cliente compatível com MCP Streamable HTTP pode se conectar usando a URL e o token Bearer. Consulte a documentação do seu cliente para saber onde configurar servidores MCP.
3. Onde encontrar seu token
Seu token é o mesmo que aparece na URL quando você acessa o painel do WAzion:
https://www.wazion.com/dashboard/TU_TOKENVocê também pode encontrá-lo em Dashboard → Conta, na seção de informações da sua loja.
Importante: Seu token dá acesso completo à sua loja. Não o compartilhe publicamente nem o inclua em repositórios de código.
4. O que você pode fazer
Todas as ações disponíveis no painel estão expostas como ferramentas MCP. Algumas categorias:
Configuração
- Alterar idioma, fuso horário, formato de data
- Ver estado da loja
- Gerenciar créditos
Agentes
- Criar, editar e excluir agentes
- Gerenciar permissões
- Atribuir horários
IA e Prompt
- Atualizar o prompt da IA
- Gerenciar dados aprendidos
- Configurar funções personalizadas
Integrações
- Conectar/desconectar Shopify
- Configurar webhooks e endpoints de CRM
- Gerenciar plugins
5. Ações com confirmação
Algumas ações potencialmente perigosas (eliminar agentes, desconectar Shopify, etc.) requerem confirmação explícita. O fluxo é:
Primeira chamada (sem confirmação)
O servidor responde com uma mensagem de aviso descrevendo o que vai acontecer. Não executa a ação.
Segunda chamada (com confirmação: true)
A ação é realmente executada. Os clientes MCP como Claude gerenciam esse fluxo automaticamente.
6. Exemplos de uso
Uma vez conectado, simplesmente peça ao seu assistente de IA o que precisar:
"Mostre-me o estado da minha loja WAzion"
"Mude o idioma da minha loja para inglês."
"Liste meus agentes e suas permissões"
"Quantos créditos me restam?"
"Crie um agente chamado Suporte com horário das 9h às 18h."
7. Perguntas frequentes
É seguro?
Sim. A conexão é feita sobre HTTPS e requer seu token privado. Ações perigosas requerem confirmação adicional. Seu token nunca é compartilhado com terceiros.
Tem custo adicional?
Não. O servidor MCP está incluído em todos os planos. As ações que consomem créditos (como respostas de IA) são descontadas do seu saldo normal.
Posso usá-lo com qualquer cliente MCP?
Sim. WAzion implementa o padrão MCP Streamable HTTP (especificação 2025-03-26), compatível com qualquer cliente que suporte este protocolo.
Quais ações estão disponíveis?
Todas as ações do painel: configuração, agentes, prompt, plugins, integrações, estatísticas, WhatsApp Auto, marketing em massa e mais. As ferramentas são geradas automaticamente e estão sempre atualizadas.
