Perguntas frequentes
Qual a diferença entre a API REST e o MCP?
A API (https://api.ragjur.ai/api/v1) é para integrar no seu produto com x-api-key. O MCP (https://mcp.ragjur.ai/mcp) expõe as mesmas capacidades como ferramentas para assistentes de IA (Claude, ChatGPT, Copilot, Cursor), com OAuth por usuário.
Como obtenho uma API key?
No painel app.ragjur.ai → Chaves de API. Cada chave tem limite por minuto e pode ser revogada. Planos e preços em /precos.
O que significa 'fonte'?
É o código da base coletada de um tribunal (ex.: stj_integras, tjsp_cjsg). Um tribunal pode ter fontes de 1º e 2º grau. Use GET /api/v1/filtros para listar.
Por que a taxa não é favoráveis ÷ total?
Porque muitos documentos não têm dispositivo reconhecível. Contar esses como 'desfavoráveis' distorceria a taxa. Usamos favoráveis ÷ classificados e reportamos a cobertura e a confiança da amostra (_meta).
As predições são aconselhamento jurídico?
Não. São estatísticas descritivas do passado com intervalo de confiança. Servem para dimensionar riscos, não para garantir resultado.
Posso usar o MCP sem OAuth?
Sim: envie a chave em x-api-key (ou Authorization: Bearer rj_…). O ChatGPT (conectores) exige OAuth; Claude, Cursor, Copilot Studio e Foundry aceitam header.
Qual o limite de tamanho das respostas do MCP?
120 mil caracteres por chamada (configurável). Acima disso o JSON é compactado (sem inteiro teor, ementas truncadas, listas reduzidas) e marcado com _truncated: true.
Vocês armazenam minhas consultas?
Logs de chamada (parâmetros, latência, chave) por até 90 dias para suporte e prevenção de abuso; não armazenamos o conteúdo das conversas dos assistentes. Ver /privacidade e /lgpd.
Os dados são públicos?
Sim — decisões judiciais publicadas pelos tribunais. Dados pessoais de partes seguem as regras de publicidade de cada tribunal; solicitações de remoção em suporte@ragjur.ai.
Com que frequência a base é atualizada?
Coletores incrementais rodam a cada 1–24 h por tribunal. Novas decisões ficam pesquisáveis por BM25 imediatamente e por similaridade após o embedding.
Há SDKs?
Gere a partir do OpenAPI: npx @openapitools/openapi-generator-cli generate -i https://api.ragjur.ai/api/v1/openapi.json -g typescript-fetch (ou python, java, csharp…).
O domínio ragjur.com.br ainda funciona?
Sim, com redirect 301 para ragjur.ai. Tokens OAuth emitidos pelo domínio antigo seguem válidos até expirar; a renovação já ocorre no domínio novo.