Tutorial · Conector MCP

Como conectar o Claude ao seu processo em 2 minutos

Para conectar o Claude ao Juspronto: no claude.ai, abra Configurações, Conectores, Adicionar conector personalizado, cole a URL api.juspronto.com.br/api/mcp, clique em Vincular e autorize com o seu login do Juspronto. Pronto: a IA passa a consultar seus processos, prazos, agenda e autos por conversa, sempre citando a folha. Leva dois minutos e é feito uma única vez.

Os 3 passos (claude.ai ou app do Claude)

1 · Adicione o conector
No Claude: Configurações, Conectores, Adicionar, Conector personalizado. Nome: Juspronto. Na URL do servidor MCP remoto, cole:
```
https://api.juspronto.com.br/api/mcp
```
Clique em Adicionar. Os campos de ID e Secret OAuth ficam em branco: o Claude descobre a autenticação sozinho.
2 · Vincule e autorize
Na lista de conectores, clique em Vincular no Juspronto. O navegador abre a tela de autorização do Juspronto: entre com o seu login (o mesmo do sistema), revise o que o Claude poderá acessar e clique em Autorizar conexão. A conexão vira uma API key com o seu nome, e revogá-la em Configurações desconecta o Claude na hora.
3 · A primeira pergunta
"Qual a minha agenda da semana?"
"Tenho algum prazo atrasado?"
"O que movimentou no escritório nos últimos 7 dias?"
"Monta a linha do tempo do processo da pasta 20."
"Onde nos autos aparece o laudo pericial? Me mostra a folha."
"Anota um prazo de apelação para 26/08 na pasta 20."

Avançado: Cursor, Claude Code e scripts (com API key)

Ferramentas de desenvolvedor autenticam por header. Crie uma key em Configurações, aba API keys (só sócio ou gestor), e use o header Authorization: Bearer jp_live_. No Claude Desktop também dá para conectar por arquivo de configuração, com o Node.js instalado:

{
  "mcpServers": {
    "juspronto": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.juspronto.com.br/api/mcp",
        "--header", "Authorization:${JUSPRONTO_AUTH}"
      ],
      "env": {
        "JUSPRONTO_AUTH": "Bearer SUA_KEY_AQUI"
      }
    }
  }
}

O desvio pela variável JUSPRONTO_AUTH contorna um problema do Windows, que quebra argumentos com espaço (e o header "Authorization: Bearer" tem um).

Se algo não funcionar

Cliquei em Vincular e nada abriu

O navegador pode ter bloqueado o pop-up. Permita pop-ups para claude.ai e clique em Vincular de novo. Se a tela do Juspronto abrir pedindo login, entre com o mesmo e-mail e senha do sistema.

O Claude diz que a conexão falhou ou expirou

Alguém pode ter revogado a key do conector em Configurações, API keys. Clique em Vincular de novo no Claude e autorize outra vez: uma key nova é criada na hora.

Erro de autenticação (401) no caminho avançado

Confira se o valor em JUSPRONTO_AUTH começa com "Bearer " (com espaço) seguido da key jp_live_ completa, e se a key não foi revogada em Configurações.

Erro citando npx ou mcp-remote (caminho avançado)

O Node.js não está instalado ou o computador não foi reiniciado depois da instalação. Instale o LTS em nodejs.org e reinicie.

O Claude responde que não encontrou o processo

Peça "busque o processo pelo CNJ" com o número completo, com ou sem pontuação. Se o processo ainda não está cadastrado no Juspronto, importe antes pela tela Processos.

Continua travado? Fale direto com quem desenvolve: contato@juspronto.com.br ou WhatsApp (61) 99176-1178.

Ainda não tem conta no Juspronto?

Crie a conta, importe o primeiro processo pelo CNJ e conecte o seu Claude. Sem cartão, sem fidelidade.