Documentação / Servidor MCP
Servidor MCP
O MCP (Model Context Protocol) é o padrão que conecta agentes de IA a ferramentas externas. Com o servidor MCP da Visto Azul, o Claude, o Claude Code e o Cursor passam a operar o WhatsApp em linguagem natural: "manda um PIX de R$97 pro cliente", "dispara a campanha pra essa lista".
Pré-requisito
Você precisa de uma API key do Visto Azul: crie a conta em dashboard.vistoazul.com.br, conecte seu número e copie a key em Instâncias.
Claude Code
Um comando no terminal:
claude mcp add vistoazul -e VISTOAZUL_API_KEY=SUA_API_KEY -- npx -y vistoazul-mcp
Claude Desktop
Edite o claude_desktop_config.json (em Settings → Developer → Edit Config) e adicione:
{
"mcpServers": {
"vistoazul": {
"command": "npx",
"args": ["-y", "vistoazul-mcp"],
"env": { "VISTOAZUL_API_KEY": "SUA_API_KEY" }
}
}
}
Cursor
Crie ou edite ~/.cursor/mcp.json (ou .cursor/mcp.json no projeto) com o mesmo formato:
{
"mcpServers": {
"vistoazul": {
"command": "npx",
"args": ["-y", "vistoazul-mcp"],
"env": { "VISTOAZUL_API_KEY": "SUA_API_KEY" }
}
}
}
Outros clientes MCP (Windsurf, etc.) usam esse mesmo formato de mcpServers.
Ferramentas disponíveis
| Ferramenta | O que faz |
|---|---|
list_instances | Lista os números conectados e o status |
send_text | Envia mensagem de texto |
send_media | Envia imagem, vídeo ou documento |
send_pix | Envia cobrança PIX na conversa |
send_poll | Envia enquete |
check_numbers | Verifica quem tem WhatsApp (anti-ban) |
create_campaign | Cria campanha (disparo em massa) |
campaign_status | Status de uma campanha |
list_contacts | Lista contatos (filtra por tag) |
upsert_contact | Cria ou atualiza um contato |
set_webhook | Configura webhook para receber mensagens |
Configuração
| Variável | Obrigatória | Padrão |
|---|---|---|
VISTOAZUL_API_KEY | sim | — |
VISTOAZUL_BASE_URL | não | https://dashboard.vistoazul.com.br/api/v1 |
Segurança: a API key fica só no seu ambiente (variável
env do config), nunca no código. Cada key é por conta e dá acesso às instâncias dela.