RAGJur
Voltar

Desenvolvedores

Integrações: leve 60M+ decisões para dentro do seu assistente de IA

O RAGJur é um servidor MCP (Model Context Protocol) remoto, com OAuth 2.1 e autenticação por chave de API. Funciona no Claude, no ChatGPT, no Claude Code, no Cursor, na OpenAI Responses API e em qualquer cliente compatível — além da API REST tradicional.

OAuth 2.1 · PKCE · DCRSomente leitura14 ferramentasDados em São Paulo · LGPD

Endpoint MCP

Streamable HTTP
https://mcp.ragjur.ai/mcp

Ao conectar sem credencial, o servidor responde 401 com os metadados OAuth e o cliente inicia a autorização sozinho. Na tela de consentimento, cole sua chave de API (rj_…): o aplicativo recebe um token temporário de 1 hora, nunca a chave. Obtenha a chave em app.ragjur.ai.

Conecte em minutos

Claude.ai e Claude Desktop

Conector personalizado (OAuth)

  1. Configurações → Conectores → Adicionar conector personalizado (Team/Enterprise: apenas Owners, em Organization settings).
  2. Cole a URL https://mcp.ragjur.ai/mcp. Deixe Client ID/Secret em branco.
  3. Clique em Adicionar: a página de autorização do RAGJur abre. Cole a chave de API e autorize.
  4. Na conversa, ative o RAGJur no menu + → Conectores.

Claude Code

CLI · transporte HTTP

bash
# OAuth (recomendado) — depois rode /mcp no Claude Code e conclua o login no navegador
claude mcp add --transport http ragjur https://mcp.ragjur.ai/mcp

# Sem OAuth: chave de API direto no header (CI, `claude -p`)
claude mcp add --transport http ragjur https://mcp.ragjur.ai/mcp \
  --header "x-api-key: rj_SUA_CHAVE"

Claude Desktop (config manual) e Cursor

mcp-remote ou URL direta

claude_desktop_config.json — o mcp-remote abre o navegador para o OAuth:

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

Cursor / Windsurf (~/.cursor/mcp.json). Omita headers para usar OAuth:

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

ChatGPT

Connectors / Apps · OAuth obrigatório

  1. Ative o Developer mode em Settings → Apps & Connectors (disponibilidade depende do plano/workspace).
  2. Clique em Create, dê um nome e informe a URL https://mcp.ragjur.ai/mcp.
  3. O ChatGPT descobre o OAuth, abre a página de autorização do RAGJur: cole a chave de API e autorize.
  4. Adicione o conector à conversa pelo menu de ferramentas.

O ChatGPT não aceita chave de API em conectores; o RAGJur implementa OAuth 2.1 com PKCE e registro dinâmico exatamente para isso.

OpenAI Responses API

tools: [{ type: 'mcp' }] · sem OAuth

Para aplicações próprias sobre modelos da OpenAI, passe a chave do RAGJur em headers. allowed_tools reduz custo e latência; require_approval: "never" é seguro porque todas as ferramentas são somente leitura.

bash
curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5",
    "tools": [{
      "type": "mcp",
      "server_label": "ragjur",
      "server_description": "Jurisprudência e jurimetria de 60M+ decisões de tribunais brasileiros.",
      "server_url": "https://mcp.ragjur.ai/mcp",
      "headers": { "x-api-key": "rj_SUA_CHAVE" },
      "require_approval": "never",
      "allowed_tools": ["buscar_jurisprudencia", "verificar_citacao", "panorama_tema"]
    }],
    "input": "Qual a tendência do STJ sobre dano moral por negativação indevida? Cite número, turma e data."
  }'

API REST

api.ragjur.ai · header X-API-Key

Os mesmos dados sem MCP. Documentação completa em /docs; a especificação OpenAPI das 14 ferramentas (bridge REST para GPT Actions, Copilot e Vertex) está em mcp.ragjur.ai/openapi.json.

bash
curl "https://api.ragjur.ai/api/v1/busca?q=dano+moral+negativacao+indevida&fonte=STJ&modo=hibrido" \
  -H "X-API-Key: rj_SUA_CHAVE"

Qualquer cliente MCP, via curl:

bash
curl -X POST https://mcp.ragjur.ai/mcp \
  -H "x-api-key: rj_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

As 14 ferramentas

Todas são somente leitura e devolvem fontes verificáveis (tribunal, número, órgão, relator, data, link do inteiro teor).

Segurança e privacidade

  • OAuth 2.1 com PKCE S256, registro dinâmico (RFC 7591) e metadados RFC 9728/8414.
  • Tokens de acesso de 1 hora vinculados ao recurso; refresh tokens rotativos e revogáveis.
  • A chave de API nunca é entregue ao assistente.
  • Apenas a consulta e os resultados transitam; suas conversas não chegam ao RAGJur.
  • Logs guardam ferramenta, latência, status e IP truncado. Nada é usado para treinar modelos.
  • Limite de 60 requisições/minuto por credencial.

Detalhes na Política de Privacidade.

Precisa de ajuda?

Para depurar o OAuth: npx @modelcontextprotocol/inspector@latest → URL do servidor → aba Auth.