GoZAP MCP

Servidor MCP oficial para integração da sua instância GoZAP com Claude, Cursor, Windsurf e outros clientes compatíveis com Model Context Protocol.

Instalação

npm install -g gozap-mcp

Configuração

O MCP utiliza as seguintes variáveis de ambiente:

| Variável | Descrição | | -------------- | -------------------------- | | GOZAP_BASE_URL | URL da sua instância GoZAP | | GOZAP_TOKEN | Token da instância | | BASE_URL | Alias para GOZAP_BASE_URL | | TOKEN | Alias para GOZAP_TOKEN |

Exemplo:

GOZAP_BASE_URL=https://cliente.gozap.dev
GOZAP_TOKEN=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Exemplo de configuração no Claude, Cursor, Windsurf e outros

{
  "mcpServers": {
    "gozap-mcp": {
      "command": "gozap-mcp",
      "env": {
        "BASE_URL": "https://cliente.gozap.dev",
        "TOKEN": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

Tools disponíveis

health

Verifica a disponibilidade da API GoZAP.

send_text

Envia mensagens de texto para contatos ou grupos.

send_image

Envia imagens para contatos ou grupos.

O campo image aceita:

• URL pública
• Base64

Como funciona

Após configurado, o MCP utiliza automaticamente as rotas da sua instância GoZAP.

Você não precisa conhecer endpoints ou parâmetros da API. A IA interpreta sua solicitação e seleciona automaticamente a ferramenta apropriada.

Exemplos:

Envie uma mensagem para 5511999999999 dizendo "Olá, tudo bem?"

Envie esta imagem para o grupo Marketing [email protected]

Verifique se minha instância está online.

Segurança

As credenciais permanecem locais no cliente MCP.

O token da instância é utilizado apenas para autenticação nas chamadas da API GoZAP configurada em GOZAP_BASE_URL.