# MCP Server SeguroBet — Documentação

## O que é este servidor

Interface MCP para análise conversacional de dados da plataforma SeguroBet.
Agentes de IA consultam o `dw_gold_sb` (ClickHouse, gold, read-only) via linguagem natural,
com guardrails que garantem RAG prévio antes de qualquer execução SQL.

## Autenticação

OAuth 2.1 Authorization Code + PKCE S256, delegado ao BI SeguroBet.

O token de acesso é um JWT HS256 com validade de 1 hora.
Use o refresh_token para renovar sem re-login (válido 30 dias).

## Tools disponíveis

| Tool | Descrição |
|---|---|
| `manual_de_uso()` | Regras obrigatórias e fluxo de análise |
| `buscar_conhecimento(pergunta)` | RAG + emite rules_token |
| `listar_tabelas()` | Tabelas disponíveis em dw_gold_sb |
| `descrever_tabela(nome)` | DDL e colunas de uma tabela |
| `executar_sql(sql, rules_token, pergunta)` | SELECT validado na gold |

## Segurança

- OAuth 2.1 com PKCE — autenticação via contas do BI
- Gate HMAC-SHA256 — SQL exige `rules_token` emitido por `buscar_conhecimento`
- Lint estático — apenas SELECT em dw_gold_sb; sem table functions
- ClickHouse read-only — usuário sem permissão de escrita

## Como conectar — Claude Code

```
mcp add --transport http https://mcp.segurobet.com.br/mcp
```

## Como conectar — Claude Desktop / Cursor

```json
{
  "mcpServers": {
    "segurobet": {
      "transport": "http",
      "url": "https://mcp.segurobet.com.br/mcp"
    }
  }
}
```

## Como conectar — ChatGPT Actions

Use a spec OpenAPI em: `https://mcp.segurobet.com.br/openapi.json`