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/v1Há 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/v1Autorize 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/v1Opçã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
| Ferramenta | O que faz |
|---|---|
search_jurisprudencia | Busca 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_jurisprudencia | Lista por filtros estruturais (relator, órgão julgador, tema, tribunal, tipo), da decisão mais recente para a mais antiga. |
get_jurisprudencia | Detalha um julgado pelo id: metadados completos, trechos do inteiro teor por seção e o julgado que o superou (se houver). |
related_jurisprudencia | Contexto de um julgado: precedentes semelhantes, outras decisões do mesmo tema repetitivo e a legislação citada. |
facets_jurisprudencia | Autocomplete 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
- Painel: Configurações → MCP / Conectores
- Email: suporte@juspilot.ai
- Protocolo: modelcontextprotocol.io