Content
# Zappaz MCP Server
O Zappaz MCP Server conecta ferramentas MCP a Zappaz API de WhatsApp. Ele expoe
tools para envio e gerenciamento de mensagens (texto, imagem, video, audio,
documento, contato, localizacao) usando um sessionId e um token de sessao.
### Casos de uso
- Envio de mensagens via WhatsApp a partir de agentes MCP.
- Automacao de atendimentos com multimidia (imagem, video, audio, documento).
- Compartilhamento de contatos e localizacoes.
- Remocao de mensagens pelo id.
---
## Servidor Zappaz MCP (Remoto)
O servidor e remoto e esta disponivel em `https://mcp.zappaz.io`.
---
## Autenticacao
Todas as chamadas exigem:
- `sessionId` no query string (`?sessionId=...`)
- `Authorization` no header
Sem esses valores o servidor retorna erro.
---
## Configuracao no OpenCode
Adicione o servidor no seu `opencode.json` do OpenCode:
```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Configuracao no Cursor
Crie o arquivo `.cursor/mcp.json` com a entrada abaixo:
```json
{
"mcpServers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Configuracao no Antigravity
No Agent Panel, clique nos tres pontos no canto superior direito e selecione
MCP Servers. Clique em Manage MCP Servers. Selecione "View raw config" e adicione:
```json
{
"mcpServers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"serverUrl": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Configuracao no VS Code
Abra a Command Palette (Cmd+Shift+P) e digite "MCP: Add Server". Selecione
"Add MCP Server". Escolha HTTP para adicionar um MCP remoto. Informe a URL
`https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION` e o nome `zappaz-mcp`.
Depois, edite o `mcp.json` para adicionar o header de autorizacao:
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Configuracao no Claude Desktop
Adicione o servidor no seu arquivo de configuracao MCP:
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Configuracao no Claude Code
Adicione o servidor no seu arquivo de configuracao MCP:
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
## Configuracao no Windsurf
Adicione o servidor no seu arquivo de configuracao MCP:
```json
{
"servers": {
"zappaz-mcp": {
"type": "remote",
"enabled": true,
"url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
"headers": {
"Authorization": "YOUR_SESSION_TOKEN"
}
}
}
}
```
---
## Tools disponiveis
### Tool de Mensagens
| Tool | Descricao |
| --- | --- |
| `send_text_message` | Envia mensagem de texto. |
| `send_image_message` | Envia mensagem de imagem. |
| `send_video_message` | Envia mensagem de video. |
| `send_audio_message` | Envia mensagem de audio. |
| `send_document_message` | Envia mensagem de documento. |
| `send_contact_message` | Envia mensagem com contato. |
| `send_location_message` | Envia mensagem com localizacao. |
| `delete_message` | Deleta uma mensagem por id. |
### Tool de Grupos
| Tool | Descricao |
| --- | --- |
| `list_groups` | Lista todos os grupos da sessao. |
| `get_group_participants` | Lista os participantes de um grupo. |
| `create_group` | Cria um novo grupo. |
| `add_participants` | Adiciona participantes a um grupo. |
| `remove_participants` | Remove participantes de um grupo. |
| `promote_participants` | Promove participantes a administradores. |
| `demote_participants` | Rebaixa administradores a membros. |
| `send_group_invite_link` | Envia o link de convite de um grupo. |
| `update_group` | Atualiza nome, descricao e configuracoes do grupo. |
| `update_group_picture` | Atualiza a foto do grupo. |
### Tool de Webhooks
| Tool | Descricao |
| --- | --- |
| `get_webhooks` | Obtem a lista de webhooks configurados para uma sessao. |
| `create_webhook` | Cria um novo webhook para uma sessao. |
| `update_webhook` | Atualiza um webhook existente para uma sessao. |
| `delete_webhook` | Deleta um webhook existente para uma sessao. |
---
## Observacoes
- O token e o sessionId sao obrigatorios para todas as chamadas.
