Tudo o que você precisa para integrar

Servidor MCP para Claude Desktop

Ferramentas disponíveis (22 tools + 1 alias legado)

Sem cota de chamadas. O volume real depende do PJe do tribunal, que aplica os próprios limites e pode ficar lento ou indisponível. A coluna Exige diz o que a chamada precisa além da API key — a chave de OCR é opcional e só entra quando o documento é PDF, porque HTML e RTF são extraídos localmente, de graça.

Configuração por cliente

O servidor é HTTP remoto: https://pje-mni-mcp-production.up.railway.app/mcp. Em todos os clientes vai a API key. O seu CPF e senha do PJe do TJCE (X-MNI-CPF/X-MNI-SENHA) e os do TRF5 (X-MNI-CPF-TRF5/X-MNI-SENHA-TRF5) — um cadastro por tribunal — vão no cliente só se não estiverem cadastrados no painel — é com o seu login que a consulta funciona, e não há mais credencial compartilhada. X-MISTRAL-API-KEY (ou X-TECJUSTICA-PARSE-KEY) é opcional: sem ela, o PDF é lido pelo motor do serviço. E X-OPENAI-API-KEY só é lida pela perguntar_peca.

Mais simples ainda: cadastre tudo uma vez no painel — Configuração › Acesso ao PJe, Leitura de PDF e Chaves de IA. Aí o cliente precisa só da linha Authorization, e os headers abaixo viram override, para quando você quiser usar outra chave naquele cliente.

Dois motores de OCR. O padrão é o Mistral: 6 a 10× mais rápido, com a mesma precisão em processo escaneado. A TecJustica é melhor quando a peça é um PDF nascido digital com foto colada dentro (print de contrato, RG fotografado) — comum em ação bancária, porque só ela lê o texto de dentro da foto. Escolha com X-OCR-PROVIDER (mistral ou tecjustica) ou fixe no seu painel. Se um motor falhar, o outro assume.

Aumente o timeout do cliente. Uma leitura com OCR pode levar minutos — o servidor trabalha com até 420 s por chamada. O Claude Code e o Codex cortam em 60 s por padrão, e o erro que chega não parece timeout: parece servidor fora do ar. As configurações abaixo já sobem esse teto (timeout e tool_timeout_sec); mantenha as linhas.

Claude Code (nativo, recomendado)

claude mcp add-json --scope user pje-mni '{
  "type": "http",
  "url": "https://pje-mni-mcp-production.up.railway.app/mcp",
  "timeout": 600000,
  "headers": {
    "Authorization": "Bearer SUA_API_KEY",
    "X-MNI-CPF": "SEU_CPF_PJE",
    "X-MNI-SENHA": "SUA_SENHA_PJE",
    "X-MISTRAL-API-KEY": "SUA_CHAVE_MISTRAL_PARA_PDF",
    "X-OPENAI-API-KEY": "SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
  }
}'

É add-json, e não claude mcp add --header, porque só assim dá para definir o timeout. No Windows, passar esse JSON pela linha de comando dá dor de cabeça com aspas: cole o mesmo objeto direto no ~/.claude.json, dentro de "mcpServers".

Claude Desktop / Cursor (macOS e Linux — HTTP nativo)

Claude Desktop: claude_desktop_config.json · Cursor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "pje-mni": {
      "type": "http",
      "url": "https://pje-mni-mcp-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY",
        "X-MNI-CPF": "SEU_CPF_PJE",
        "X-MNI-SENHA": "SUA_SENHA_PJE",
        "X-MISTRAL-API-KEY": "SUA_CHAVE_MISTRAL_PARA_PDF",
        "X-OPENAI-API-KEY": "SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
      }
    }
  }
}

Claude Desktop no Windows (via mcp-remote)

Cole o JSON abaixo em %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "pje-mni": {
      "command": "cmd",
      "args": [
        "/c", "npx", "mcp-remote",
        "https://pje-mni-mcp-production.up.railway.app/mcp",
        "--header", "Authorization: Bearer SUA_API_KEY",
        "--header", "X-MNI-CPF: SEU_CPF_PJE",
        "--header", "X-MNI-SENHA: SUA_SENHA_PJE",
        "--header", "X-MISTRAL-API-KEY: SUA_CHAVE_MISTRAL_PARA_PDF",
        "--header", "X-OPENAI-API-KEY: SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
      ]
    }
  }
}

⚠️ O cmd do Windows troca %…% por variáveis de ambiente: se a sua senha do PJe tiver %, cadastre-a no painel (Configuração › Acesso ao PJe) e deixe só o Authorization no bloco.

Codex CLI (OpenAI)

Em ~/.codex/config.toml. Os segredos vão por env_http_headers, que recebe o nome da variável de ambiente — http_headers guardaria o valor em claro no arquivo:

[mcp_servers.pje-mni]
url = "https://pje-mni-mcp-production.up.railway.app/mcp"
bearer_token_env_var = "PJE_MNI_API_KEY"
startup_timeout_sec = 30
tool_timeout_sec = 600
http_headers = { "X-MNI-CPF" = "SEU_CPF_PJE" }
env_http_headers = { "X-MNI-SENHA" = "PJE_MNI_SENHA", "X-MISTRAL-API-KEY" = "PJE_MISTRAL_API_KEY", "X-OPENAI-API-KEY" = "PJE_OPENAI_API_KEY" }

E as variáveis no seu shell (~/.bashrc, ~/.zshrc):

export PJE_MNI_API_KEY=...          # a API key criada no painel
export PJE_MNI_SENHA=...            # sua senha do PJe
export PJE_MISTRAL_API_KEY=...      # leitura de PDF
export PJE_OPENAI_API_KEY=sk-...    # só perguntar_peca

O prefixo PJE_ evita colisão: OPENAI_API_KEY cru é a variável que o próprio Codex lê para se autenticar, e exportá-la pode mudar o login dele — e quem paga a conta.

OpenCode

Em opencode.json (projeto) ou ~/.config/opencode/opencode.json:

{
  "mcp": {
    "pje-mni": {
      "type": "remote",
      "url": "https://pje-mni-mcp-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY",
        "X-MNI-CPF": "SEU_CPF_PJE",
        "X-MNI-SENHA": "SUA_SENHA_PJE",
        "X-MISTRAL-API-KEY": "SUA_CHAVE_MISTRAL_PARA_PDF",
        "X-OPENAI-API-KEY": "SUA_CHAVE_OPENAI_PARA_PERGUNTAR_PECA"
      }
    }
  }
}

O servidor MCP é hospedado por nós e roda no TJCE e no TRF5. Ele NÃO faz parte do código-fonte à venda — o que se compra (R$200) é o código da API REST. O MCP você usa na conta gratuita; não hospeda.

CLI pje-baixar

Instalação

Linux / WSL / macOS

curl -fsSL https://pje-mni-api-production.up.railway.app/cli/install.sh | bash

Windows (PowerShell)

irm https://pje-mni-api-production.up.railway.app/cli/install.ps1 | iex

Uso

pje-baixar config                      # configura CPF/senha do PJe (uma vez só)
pje-baixar NNNNNNN-DD.AAAA.J.TR.OOOO    # baixa todos os documentos do processo

Cria a pasta NNNNNNN-DD.AAAA.J.TR.OOOO/ no diretório atual com todos os documentos (PDF, HTML, RTF, imagens) nomeados como NNN_<descrição>_<idDocumento>.<ext> — a Petição Inicial fica em 001.

Subcomandos

Duas formas de usar