MCP Server SeguroBet

O que é este servidor

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

Como conectar — Claude Code

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

Ao conectar pela primeira vez, você será redirecionado para o login do BI. Use suas credenciais normais da plataforma.

Como conectar — Claude Desktop / Cursor

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

Como conectar — curl / scripts

Copiarcurl -X POST https://mcp.segurobet.com.br/mcp \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Tools disponíveis

• 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

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

Links úteis

• llms.txt — descoberta AI-First
• docs/index.md — documentação em Markdown
• OAuth discovery — metadata OAuth 2.1
• BI API Swagger — relatórios pré-definidos