Conector MCP

Conecte o Claude (Claude.ai, Claude Code), o Cursor e outros clientes de IA à base de jurisprudência do Juspilot via Model Context Protocol (MCP).

Conector MCP

O conector MCP do Juspilot expõe a base de jurisprudência (STJ, STF, TST, súmulas, teses repetitivas, TCU, CARF e mais) como ferramentas para clientes de IA que falam o Model Context Protocol — como o Claude.ai, o Claude Code e o Cursor.

Na prática: você pergunta em linguagem natural no seu assistente e ele busca, lê e cita precedentes reais da base do Juspilot — sem copiar e colar.

Somente leitura

As ferramentas do conector são read-only. Ele consulta a base de jurisprudência (compartilhada) — não cria, edita nem apaga nada na sua conta.

Endpoint

O servidor MCP é remoto (Streamable HTTP):

https://app.juspilot.ai/api/mcp/v1

Há duas formas de autenticar:

  • OAuth 2.1 (recomendado) — fluxo de 1 clique no Claude.ai. Sem chave, sem terminal.
  • API Key (Bearer) — modo manual com uma chave jp_live_, útil para scripts e .mcp.json.

Opção 1 — Claude.ai (OAuth, recomendado)

Abra os Conectores

No Claude.ai (navegador ou app desktop), vá em Configurações → Conectores.

Adicione um conector personalizado

Clique em "Adicionar conector personalizado" e cole a URL do servidor:

https://app.juspilot.ai/api/mcp/v1

Autorize o acesso

Você será levado ao Juspilot para fazer login, escolher o escritório e clicar em Autorizar. O fluxo usa OAuth 2.1 + PKCE — o Claude registra o cliente automaticamente.

Pronto

As ferramentas de jurisprudência do Juspilot aparecem no Claude. É só perguntar.

O access token expira em 1 hora e é renovado automaticamente (refresh de 90 dias). Você pode revogar o conector quando quiser em Configurações → MCP / Conectores no painel do Juspilot.

Opção 2 — Claude Code (terminal)

Um comando. O Claude abre o navegador para você autorizar:

claude mcp add --transport http juspilot https://app.juspilot.ai/api/mcp/v1

Opção 3 — API Key (Bearer)

Para clientes que usam .mcp.json (ou scripts), autentique com uma API Key do Juspilot. Gere uma em Configurações → Desenvolvedor (formato jp_live_...).

Guarde com segurança

A API Key é exibida apenas uma vez na criação. Trate-a como uma senha — nunca a comite em repositórios.

Exemplo de .mcp.json:

{
  "mcpServers": {
    "juspilot": {
      "type": "http",
      "url": "https://app.juspilot.ai/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer jp_live_sua_chave_aqui"
      }
    }
  }
}

Ferramentas disponíveis

FerramentaO que faz
search_jurisprudenciaBusca híbrida (semântica + full-text) por precedentes, súmulas e teses, rankeada por relevância e autoridade. Retorna ementa, tese fixada e trechos do inteiro teor.
browse_jurisprudenciaLista por filtros estruturais (relator, órgão julgador, tema, tribunal, tipo), da decisão mais recente para a mais antiga.
get_jurisprudenciaDetalha um julgado pelo id: metadados completos, trechos do inteiro teor por seção e o julgado que o superou (se houver).
related_jurisprudenciaContexto de um julgado: precedentes semelhantes, outras decisões do mesmo tema repetitivo e a legislação citada.
facets_jurisprudenciaAutocomplete de relator / órgão julgador para descobrir o nome exato a usar nos filtros.

Exemplos de perguntas

Depois de conectar, experimente:

  • "Qual o entendimento do STJ sobre dano moral por inscrição indevida em cadastro de inadimplentes? Cite os precedentes."
  • "Liste as teses repetitivas do STJ sobre prescrição em ações de cobrança."
  • "Detalhe a Súmula 83 do STJ e mostre julgados relacionados."

Cobertura

A base cobre tribunais superiores e cortes de contas, entre outros:

  • Superiores: STJ, STF, TST
  • Contas: TCU, CARF
  • Estaduais/Federais: TJSP, TJDFT, TJMT, TRFs (em expansão)

Inclui acórdãos, súmulas (inclusive vinculantes), teses repetitivas, decisões monocráticas e informativos. A busca usa RRF (semântica + full-text) com pontuação de autoridade — súmulas vinculantes e repercussão geral pesam mais que monocráticas.

Segurança

  • Somente leitura — nenhuma ferramenta altera dados.
  • Tokens por escritório — você escolhe o escritório no consentimento (usado para auditoria; a jurisprudência em si é uma base compartilhada).
  • Revogação imediata — revogue qualquer conector em Configurações → MCP / Conectores. O access token deixa de ser renovado e expira em até 1 hora.
  • Padrões abertos — OAuth 2.1 + PKCE + Dynamic Client Registration (RFC 7591), com discovery em /.well-known/oauth-authorization-server.

Suporte

On this page