MCP para IA e WhatsApp | Escopos e auditoria GoZAP

Model Context Protocol (MCP) é o padrão aberto que permite que LLMs como Claude ou GPT-4 chamem ferramentas externas com precisão cirúrgica. A GoZAP implementou um servidor MCP completo — o que significa que seu agente de IA pode enviar mensagens, listar grupos, buscar histórico e muito mais, tudo sem uma linha de código de integração manual.

Cada chamada passa pelo servidor MCP do painel GoZAP, onde escopos e permissões são configurados por instância. Seu agente faz o que você autorizou — e o log registra cada ação para auditoria.

"Agentes de IA que apenas lêem dados são úteis. Agentes que atuam no WhatsApp em tempo real são transformadores."

Como funciona na prática

01 — CONEXÃO

Conectando seu agente ao servidor MCP da GoZAP

Configuração única

O servidor MCP da GoZAP é acessível via URL fixa do painel. Você configura uma vez no cliente MCP do seu agente (Claude Desktop, cursor, qualquer cliente compatível) e todas as ferramentas ficam disponíveis automaticamente.

claude_desktop_config.json

{"mcpServers": {"gozap": {"url": "https://mcp.gozap.dev/sse","headers": {"Authorization": "Bearer SEU_TOKEN","X-Instance": "minha-instancia"}}}}

Clientes compatíveis

Claude Desktop (Anthropic)

Cursor IDE

Qualquer cliente MCP SSE

SDK direto via stdio ou HTTP

02 — ESCOPOS

Permissões granulares por instância

Controle total

Cada token MCP é vinculado a escopos específicos. Um agente de suporte pode ler mensagens mas não enviar. Um agente de disparos pode enviar mas não acessar grupos. Você define no painel, o servidor MCP aplica em cada chamada.

gozap · painel · mcp · escopos

// Escopos disponíveis por tokenmessages:send→ enviar mensagensmessages:read→ ler históricocontacts:read→ listar contatosgroups:read→ listar grupos e membrosgroups:manage→ add/remove membrosinstance:status→ status da instância// Token de agente de suporte (somente leitura)scopes: ["messages:read", "contacts:read"]

Casos de uso por escopo

Agente de FAQ: só messages:read para contexto

Agente de disparo: messages:send com rate limit

Agente de CRM: contacts:read + messages:read

Agente de comunidade: groups:manage completo

03 — FERRAMENTAS MCP

O que seu agente enxerga como tools

+40 ferramentas

O servidor MCP expõe cada endpoint da GoZAP como uma tool tipada. O agente chama send_message, list_groups ou get_contact_history da mesma forma que qualquer outra ferramenta — com parâmetros, retorno tipado e descrição em linguagem natural.

agente → mcp → gozap

// Agente executa: "mande follow-up para João"→ tool: get_contact_by_name({ name: "João" })← { number: "5511999887766", lastSeen: "2h ago" }→ tool: send_message({ number: "5511999887766", text: "Oi João, passando para ver se..." })← { messageId: "MSG_4821", status: "sent" }// Auditoria registrada automaticamente no painel

Ferramentas disponíveis

send_message, send_media, send_audio

list_groups, get_group_members

get_contact_history, search_contacts

get_instance_status, list_instances

04 — AUDITORIA

Log completo de cada ação do agente

Rastreável

Cada chamada MCP gera um registro auditável no painel: qual ferramenta foi chamada, com quais parâmetros, qual agente executou, timestamp e resultado. Você vê exatamente o que o agente fez — e pode revogar acesso imediatamente se necessário.

GET /mcp/audit-log

[{"tool": "send_message","agent": "claude-support-agent","instance": "atendimento-sp","status": "success","ts": "2026-08-29T14:32:01Z"}]

O que o log registra

Tool chamada e parâmetros (sem dados sensíveis)

Identidade do token e instância

Resultado: success, error, rate_limited

Latência de execução em ms

GoZAP MCP

Conecte seu agente ao WhatsApp em minutos.

Configure o servidor MCP no painel, gere um token com os escopos que você precisa e seu agente já pode agir. Suporte a Claude, GPT-4 e qualquer cliente MCP compatível.

Configurar MCP no painel →Ver documentação MCP