Juspronto para desenvolvedores: conector MCP e integração com IA

É público o que ajuda a achar e a entender a integração: esta página, a especificação OpenAPI, o catálogo de APIs, o llms.txt, o sitemap, o robots.txt e os metadados de descoberta do OAuth. Tudo o que toca dado de escritório exige credencial: sem token, o endpoint MCP responde 401.

• https://api.juspronto.com.br/api/mcp

  Servidor MCP (Streamable HTTP, uma mensagem JSON-RPC por requisição). Credencial: Token no cabeçalho Authorization.

• https://api.juspronto.com.br/.well-known/oauth-protected-resource/api/mcp

  Metadados do recurso protegido (RFC 9728), com os escopos que o conector concede. Credencial: Não.

• https://api.juspronto.com.br/.well-known/oauth-authorization-server

  Metadados do servidor de autorização (RFC 8414). Credencial: Não.

• https://api.juspronto.com.br/api/mcp-oauth/register

  Registro dinâmico de cliente (RFC 7591). Credencial: Não.

• https://api.juspronto.com.br/api/mcp-oauth/authorize

  Autorização: abre a tela de consentimento do Juspronto. Credencial: Login do advogado, na tela.

• https://api.juspronto.com.br/api/mcp-oauth/token

  Troca do código por token e renovação do token. Credencial: Não (PKCE).

• https://api.juspronto.com.br/.well-known/openid-configuration

  Configuração OpenID Connect (Discovery): o mesmo servidor de autorização, com o endereço userinfo. Não emite ID Token. Credencial: Não.

• https://api.juspronto.com.br/api/mcp-oauth/userinfo

  UserInfo (OIDC): o identificador opaco da pessoa que conectou e, com o escopo email, o e-mail dela. Credencial: Token de acesso no cabeçalho Authorization.

• https://api.juspronto.com.br/health

  Status público da API. Credencial: Não.

1. 1. Adicione o conector. Em claude.ai/customize/connectors, crie um conector personalizado com nome Juspronto e a URL https://api.juspronto.com.br/api/mcp. Deixe em branco os campos de OAuth: o Claude se registra sozinho. Este link abre o formulário já preenchido: abrir no Claude.
2. 2. Autorize no Juspronto. O Claude abre a tela de autorização. A pessoa entra com o login, confere quem pede o acesso, marca as permissões e confirma.
3. 3. Pergunte. A conexão aparece em Configurações > Conexões com o Claude, onde dá para ver o histórico e desconectar.

O passo a passo por superfície está em /conectar, e a documentação para o advogado em /mcp/como-funciona.

Não há chave de API para pedir nem ambiente de testes público: o Juspronto não emite credencial a terceiros. Quem dá o acesso é a pessoa dona da conta, e o caminho é o de um cliente OAuth:

1. 1. Registre o cliente. Um POST em https://api.juspronto.com.br/api/mcp-oauth/register com os redirect_uris devolve o client_id, sem cadastro prévio e sem segredo.
2. 2. Mande a pessoa autorizar. Abra https://api.juspronto.com.br/api/mcp-oauth/authorize com PKCE S256. Ela entra com o login do Juspronto e marca as permissões.
3. 3. Troque o código por token. Em https://api.juspronto.com.br/api/mcp-oauth/token, e use o token como Bearer no endpoint MCP.
4. 4. Descubra as ferramentas. Chame initialize e depois tools/list.

Quem ainda não tem conta cria a sua em /register: todo plano começa com 7 dias de teste, sem cartão, com acesso integral. O fluxo inteiro, com os corpos e as respostas de cada passo, está na especificação em /openapi.json, e o índice das APIs em /.well-known/api-catalog.

Sem token, o endpoint devolve 401 com o cabeçalho WWW-Authenticate apontando para os metadados do recurso. O cliente descobre o servidor de autorização, se registra por registro dinâmico, manda a pessoa para a tela de consentimento e troca o código por token. O PKCE S256 é obrigatório e o cliente é público, sem segredo.

O mesmo cabeçalho traz scope="prazos:read processos:read dashboard:read autos:read", o mínimo para usar o conector: os escopos da permissão Consultar, que entra em toda conexão.

O token de acesso é opaco e dura 1 hora. O refresh token dura 30 dias e é rotativo: reaproveitar um refresh já usado revoga os tokens daquela conexão. O registro de cliente só aceita endereços de retorno de uma lista fechada de hosts.

Para ferramentas de desenvolvimento, vale também como Bearer uma chave de API criada por sócio ou gestor em Configurações, aba API keys. Essa chave consulta e lê os autos, mas não escreve. É um caminho avançado, que não testamos com clientes de terceiros.

Quem escolhe o que o Claude pode fazer é a pessoa, na tela de autorização, que mostra quatro permissões. O parâmetro scope enviado pelo cliente não concede permissão nenhuma; só openid e email, se pedidos, habilitam o endereço userinfo, que identifica a pessoa. Toda conexão carrega autos:read.

Existe ainda o escopo escrita:externa, para mensagem escrita ao cliente e convite de equipe. Só uma chave criada à mão o recebe: a conexão do Claude nunca.

Os metadados do recurso protegido anunciam em scopes_supported os 9 escopos que o conector concede: prazos:read, processos:read, dashboard:read, autos:read, autos:write, autos:analisar, minutas:write, escrita:interna, prazos:write. O escrita:externa não está nessa lista, porque o conector nunca o concede. Os metadados do servidor de autorização listam os escopos da plataforma, esse inclusive, mais openid e email.

Com as quatro permissões marcadas, a conexão enxerga 32 ferramentas. 21 são só leitura e 11 gravam alguma coisa no Juspronto. Elas cobrem processos, prazos, agenda, autos, minutas, clientes e tarefas. Financeiro, documentos, portal do cliente e WhatsApp não têm ferramenta. Ler páginas dos autos conta na cota mensal de páginas do plano.

O servidor oferece também 5 leituras prontas (resources) e 9 comandos (prompts), como Bom dia e Fechar o dia. As leituras são juspronto://hoje, juspronto://intimacoes, juspronto://prazos-sugeridos, juspronto://desfazer, juspronto://processo/{processoId}.

• Ações de gestão: no máximo 10 por minuto, 60 por hora e 300 em 24 horas, por conexão.
• Desfazer: o que a permissão de gestão escreveu pode ser desfeito por 24 horas, com listar_acoes_reversiveis e desfazer.
• As ferramentas que alteram ou apagam dados vão marcadas como destrutivas no protocolo (destructiveHint), para o cliente pedir aprovação antes de usar. Quem pede é o cliente: o servidor sinaliza, não garante.
• O conector não protocola nada no tribunal. A minuta fica pendente até o advogado aprovar no Juspronto.
• Lote JSON-RPC é recusado com 400: envie uma mensagem por requisição. O endpoint limita as requisições por credencial; ao passar do limite, espere e tente de novo.
• Se a assinatura do escritório vence, o conector deixa de responder.
• Cada chamada fica registrada com a ferramenta, a hora e, quando houver, o processo.

• As respostas da API trazem RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset e RateLimit-Policy, com o teto e a janela. Passou do teto, a resposta é 429 com Retry-After, em segundos: espere esse tempo antes de repetir. O registro de cliente tem um teto próprio por hora.
• Os erros da API têm o formato { "error": "...", "statusCode": 429 }. Os endpoints OAuth usam o formato do RFC 6749, com error e error_description. Os erros do transporte MCP (400, 406 e 415) vêm como erro JSON-RPC.
• O endpoint MCP responde 401 sem credencial, com WWW-Authenticate, e 402 quando a assinatura do escritório não permite a operação.
• Os documentos de descoberta do site respondem 405 a qualquer verbo que não seja GET, HEAD ou OPTIONS, em application/problem+json (RFC 9457), com type, title e status.
• Os metadados OAuth espelhados no site respondem 404 no mesmo formato a um sufixo que não servem.

A resposta de quem chega sem token mostra para onde ir e o que pedir. Sem credencial e sem dado de ninguém:

curl -i -X POST https://api.juspronto.com.br/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://api.juspronto.com.br/.well-known/oauth-protected-resource/api/mcp", scope="prazos:read processos:read dashboard:read autos:read"

O corpo é JSON com o campo error. Listar as ferramentas exige token: um servidor sem credencial não mostra o catálogo.

• /llms.txt: índice do site para modelos: quando usar o Juspronto, quando não usar, segurança e links técnicos.
• /llms-full.txt: o texto das páginas principais e dos artigos, num arquivo só.
• /index.md: a página inicial em Markdown. As páginas principais também respondem Markdown quando o pedido manda Accept: text/markdown.
• /precos.md: planos, preços e limites em Markdown.
• /openapi.json: especificação OpenAPI 3.1 da superfície pública (servidor MCP, OAuth e descoberta), com os 9 escopos do conector nomeados em securitySchemes. Não cataloga as APIs internas do aplicativo.
• /.well-known/api-catalog: catálogo de APIs (RFC 9727): aponta a especificação, a documentação, os metadados e o status das APIs.
• /.well-known/mcp: server card MCP: nome, endereço do servidor e revisões do protocolo.
• /mcp/server-card: o mesmo server card, no caminho de documentação.
• /.well-known/oauth-protected-resource: metadados do recurso protegido (RFC 9728), os mesmos que a API publica, espelhados no site.
• /.well-known/oauth-authorization-server: metadados do servidor de autorização (RFC 8414), os mesmos que a API publica, espelhados no site.
• /sitemap.xml: todas as páginas públicas.
• /robots.txt: rastreadores de IA liberados nas páginas públicas e barrados nas áreas de cliente; sinal de conteúdo para busca, resposta e treino.
• /.well-known/security.txt: contato para relatar falha de segurança.

A superfície de descoberta do site (a especificação em /openapi.json, o catálogo de APIs, o server card e os metadados OAuth espelhados) está na versão 1: cada documento responde com o cabeçalho API-Version: 1. O protocolo MCP negocia a revisão dele no initialize, e as revisões que o servidor atende estão no server card.

Mudança compatível, como um campo opcional ou um link novo, não muda o número. Mudança incompatível sobe para a versão 2, e a anterior é descontinuada com os cabeçalhos Deprecation e Sunset, com no mínimo 90 dias de aviso. Hoje nada está descontinuado.

Só o Claude foi testado por nós. O servidor segue o padrão MCP, mas não afirmamos que outros clientes de IA funcionam enquanto não testarmos, e esta página muda quando houver prova. Também não há ainda uma conta de demonstração pública para testar o conector.

Dúvida de integração ou falha de segurança: contato@juspronto.com.br, o mesmo endereço do security.txt. Os outros canais estão em /contato. O que o conector faz com os dados está na Política de Privacidade.