# Hasos — Servidor MCP (agentes de IA)

A Hasos tem um **servidor MCP remoto** para que agentes de IA (Claude, Cursor, ChatGPT e qualquer cliente compatível com Model Context Protocol) operem uma conta Hasos em linguagem natural: conectar números de WhatsApp, gerar QR Code, consultar chamadas, gravações, transcrições, métricas, webhook e leads.

- URL: `https://api.hasos.com.br/mcp`
- Transporte: Streamable HTTP (stateless, JSON-RPC 2.0)
- Autenticação: `x-api-key: hs_live_…` ou `Authorization: Bearer hs_live_…`
- Nada para instalar. O agente tem as mesmas permissões e limites da chave usada.

## Configuração

**Claude Code**
```bash
claude mcp add --transport http hasos https://api.hasos.com.br/mcp --header "x-api-key: hs_live_sua_chave"
```

**Cursor** (`~/.cursor/mcp.json`) e outros clientes com MCP remoto
```json
{ "mcpServers": { "hasos": { "url": "https://api.hasos.com.br/mcp", "headers": { "x-api-key": "hs_live_sua_chave" } } } }
```

**Claude Desktop** (via ponte `mcp-remote`)
```json
{ "mcpServers": { "hasos": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.hasos.com.br/mcp", "--header", "Authorization: Bearer hs_live_sua_chave"] } } }
```

## Ferramentas
| Ferramenta | O que faz |
|---|---|
| `list_devices`, `get_device` | Números conectados e status |
| `create_device` | Cria um dispositivo para conectar um WhatsApp |
| `get_device_qr`, `get_pairing_code` | QR Code ou código de pareamento |
| `restart_device`, `delete_device` | Reinicia ou remove um dispositivo |
| `list_live_calls` | Chamadas em andamento |
| `list_calls` | Histórico de chamadas (filtro por dispositivo, limite) |
| `get_call_recording`, `get_call_transcript` | Gravação e transcrição + resumo por IA |
| `get_analytics` | Taxa de atendimento, volume, duração média |
| `get_webhook`, `set_webhook`, `test_webhook` | Webhook da conta |
| `list_leads`, `add_leads`, `set_lead_status` | Leads do funil |

## Exemplos de pedidos
- "Cria um dispositivo e me mostra o QR para conectar meu WhatsApp."
- "Quantas ligações foram atendidas essa semana?"
- "Qual o resumo da última ligação com o Rafael?"
- "Adiciona esses 30 leads no funil e configura o webhook para https://meu-app.com/hasos."

Iniciar uma ligação ainda não é uma ferramenta MCP: as chamadas saem pelo discador (navegador, iframe/embed) ou por SIP.