Servidor MCP

URL: https://mcp.ragjur.ai/mcp — Streamable HTTP, OAuth 2.1 com registro dinâmico, 14 ferramentas somente leitura.

O Model Context Protocol permite que assistentes de IA chamem a RAGJur diretamente. Ao conectar sem credencial o servidor responde 401 com WWW-Authenticate e o cliente inicia o OAuth sozinho: abre a tela de consentimento, você cola sua API key (painel) e o aplicativo recebe um token temporário — nunca a chave.

Ferramentas

Tool	O que faz
`buscar_jurisprudencia`	Busca BM25 com filtros de tribunal, turma, relator, classe e período
`panorama_tema`	Taxa de provimento, categorias e tendência
`divergencia_turmas`	Divergência entre turmas (qui-quadrado)
`evolucao_jurisprudencial`	Evolução trimestral
`predicao_resultado`	Predição multi-fator com intervalo de confiança
`perfil_relator`	Perfil estatístico do relator/juiz
`dna_turma`	Termos significativos da turma
`clusters_tematicos`	Sub-temas por embeddings
`estrategia_juiz`	Análise estratégica completa (relator + tema + fonte)
`verificar_citacao`	Anti-alucinação de citações
`gerar_peca`	Minuta fundamentada em precedentes reais
`similaridade`	Decisões semanticamente similares
`chat_juridico`	Resposta em prosa com fontes
`tempo_tramitacao`	Estatísticas de tempo

Todas têm annotations = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }; aprovação automática é segura.

Claude.ai e Claude Desktop

Settings → Connectors → Add custom connector.
URL https://mcp.ragjur.ai/mcp; deixe Client ID/Secret vazios (DCR).
Add → cole a API key → Autorizar. Ative em + → Connectors na conversa.

Claude Desktop via config manual (claude_desktop_config.json):

claude_desktop_config.json

{
  "mcpServers": {
    "ragjur": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.ragjur.ai/mcp"] }
  }
}

Claude Code

bash

claude mcp add --transport http ragjur https://mcp.ragjur.ai/mcp   # depois: /mcp → login
# sem OAuth (CI):
claude mcp add --transport http ragjur https://mcp.ragjur.ai/mcp --header "x-api-key: rj_..."

ChatGPT (Apps / Connectors)

Settings → Apps & Connectors → Developer mode.
Create → MCP server URL https://mcp.ragjur.ai/mcp, auth OAuth.
Autorize com a API key; ative o app na conversa.

Responses API:

json

{
  "model": "gpt-5",
  "tools": [{
    "type": "mcp",
    "server_label": "ragjur",
    "server_url": "https://mcp.ragjur.ai/mcp",
    "headers": { "x-api-key": "rj_..." },
    "allowed_tools": ["buscar_jurisprudencia", "panorama_tema", "predicao_resultado"],
    "require_approval": "never"
  }],
  "input": "Qual a tendência do STJ sobre dano moral por negativação indevida?"
}

Microsoft Copilot Studio

Agente → Tools → Add a tool → New tool → Model Context Protocol.
Server URL https://mcp.ragjur.ai/mcp; Authentication OAuth 2.0 → Dynamic discovery (ou API key → Header x-api-key).
Create → Create a new connection → Add to agent. Requer orquestração generativa ligada.

Para Microsoft 365 Copilot (agente declarativo) e Azure AI Foundry, manifests prontos e guia em integrations/copilot (plugin v2.4 com runtime OpenApi ou RemoteMCPServer).

Azure AI Foundry (tools[])

{
  "type": "mcp",
  "server_label": "ragjur",
  "server_url": "https://mcp.ragjur.ai/mcp",
  "allowed_tools": ["buscar_jurisprudencia", "panorama_tema", "predicao_resultado"],
  "require_approval": "never",
  "project_connection_id": "ragjur-mcp"
}

O Foundry corta chamadas MCP em 100 s; evite clusters_tematicos e gerar_peca fora do modo background.

Cursor, Windsurf e VS Code

~/.cursor/mcp.json

{
  "mcpServers": {
    "ragjur": { "url": "https://mcp.ragjur.ai/mcp", "headers": { "x-api-key": "rj_..." } }
  }
}

.vscode/mcp.json (GitHub Copilot)

{
  "servers": {
    "ragjur": { "type": "http", "url": "https://mcp.ragjur.ai/mcp" }
  }
}

Sem headers os clientes fazem o fluxo OAuth (redirects loopback e cursor:// são aceitos).

Depuração

bash

npx @modelcontextprotocol/inspector@latest   # cole https://mcp.ragjur.ai/mcp → aba Auth
curl https://mcp.ragjur.ai/.well-known/oauth-protected-resource
curl https://mcp.ragjur.ai/.well-known/oauth-authorization-server
curl https://mcp.ragjur.ai/health

Resultados maiores que 120 mil caracteres são compactados (_truncated: true): refine os filtros ou pagine. Rate limit por usuário com X-RateLimit-*.