visto azuldocs
← Site Entrar
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".

Pacote: npm vistoazul-mcp · GitHub. Roda via npx, sem instalar nada manualmente.

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

FerramentaO que faz
list_instancesLista os números conectados e o status
send_textEnvia mensagem de texto
send_mediaEnvia imagem, vídeo ou documento
send_pixEnvia cobrança PIX na conversa
send_pollEnvia enquete
check_numbersVerifica quem tem WhatsApp (anti-ban)
create_campaignCria campanha (disparo em massa)
campaign_statusStatus de uma campanha
list_contactsLista contatos (filtra por tag)
upsert_contactCria ou atualiza um contato
set_webhookConfigura webhook para receber mensagens

Configuração

VariávelObrigatóriaPadrão
VISTOAZUL_API_KEYsim
VISTOAZUL_BASE_URLnãohttps://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.