# SiteUp MCP Server

Servidor MCP (Model Context Protocol) que expõe a API SiteUp como **tools nativas** pra IAs como Claude Desktop, Cursor, ChatGPT Desktop e qualquer outro cliente compatível com MCP.

## URL do servidor

```
https://www.siteup.com.br/api/mcp/mcp
```

(Streamable HTTP transport — padrão MCP)

## Autenticação

Use seu **`api_access_token`** da SiteUp como Bearer Token. Pegue ele em:

> SiteUp app → Perfil → Tokens de acesso

Header: `Authorization: Bearer <seu-api-access-token>`

## Tools disponíveis (14)

### Atendimento
- `list_conversations` — Lista conversas com filtros (status, inbox)
- `get_conversation` — Detalhe de uma conversa
- `send_message` — Envia mensagem (publica ou nota interna)

### Contatos
- `search_contact` — Busca por nome/email/telefone
- `get_contact` — Detalhe completo
- `create_contact` — Cria com custom_attributes + additional_attributes

### Kanban
- `list_kanban_items` — Cards de um funnel (com filtro por etapa)
- `move_kanban_item` — Move card entre etapas (triggera CAPI)
- `update_kanban_item` — Atualiza item_details (value, notes)

### Lead Capture
- `submit_lead_form` — Captura pública via slug (sem auth necessária)

### VOIP
- `list_call_records` — Histórico de chamadas com scoring IA
- `get_voip_analytics` — Métricas (funnel, FCR, lead_speed, etc)

### Captain (Agente IA)
- `list_knowledge_documents` — PDFs/URLs/textos do KB
- `add_knowledge_document` — Sobe novo doc (URL/texto/file)

---

## Setup no Claude Desktop

Edita o config (no macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
Ou no Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "siteup": {
      "url": "https://www.siteup.com.br/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer <SEU_API_ACCESS_TOKEN>"
      }
    }
  }
}
```

Reinicia o Claude Desktop. Vai ver "siteup" listado em Settings → MCP.

> ⚠️ Claude Desktop só suporta MCP via STDIO nativamente. Pra HTTP usa um proxy como `mcp-remote`:
> ```json
> {
>   "mcpServers": {
>     "siteup": {
>       "command": "npx",
>       "args": [
>         "-y",
>         "mcp-remote",
>         "https://www.siteup.com.br/api/mcp/mcp",
>         "--header",
>         "Authorization:Bearer ${SITEUP_TOKEN}"
>       ],
>       "env": { "SITEUP_TOKEN": "<SEU_TOKEN>" }
>     }
>   }
> }
> ```

## Setup no Cursor

Edita `.cursor/mcp.json` na raiz do projeto OU global em `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "siteup": {
      "url": "https://www.siteup.com.br/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer <SEU_API_ACCESS_TOKEN>"
      }
    }
  }
}
```

No painel de chat do Cursor, abre Tools → vai ver "siteup" listado com as 14 tools.

## Setup em outros clientes MCP-compatíveis

Qualquer cliente que suporta MCP HTTP (streamable transport):
- **URL**: `https://www.siteup.com.br/api/mcp/mcp`
- **Auth**: Bearer Token via header `Authorization`
- **Transport**: streamable HTTP (auto-detectado)

## Exemplos de uso

Depois de configurado, pergunta direto pra IA:

- "Lista as últimas 10 conversas abertas da inbox 75"
- "Busca o contato com email maria@empresa.com.br"
- "Move o card kanban #1234 pra etapa 'Fechado' com value 5000"
- "Mostra as analytics de chamadas dos últimos 7 dias"
- "Adiciona ao knowledge base do Capitão a URL https://nossa-doc.com/produto-x"

A IA vai chamar as tools certas automaticamente.

## Segurança

- Token validado a cada request via `/api/v1/profile`
- Tokens inválidos retornam 401
- HTTPS obrigatório (Vercel TLS automático)
- CORS aberto pra clientes MCP

## Custos

Servidor hospedado em Vercel. Free tier cobre **100K invocations/mês** — uso interno típico do time fica bem dentro disso.

## Suporte

Algo errado? `https://wa.me/5551989769026`