jud — servidor MCP

Documentação pública para quem vai conectar um agente ao jud.

O que é

O jud é o sistema de gestão de recuperação judicial da TM Digital. Este servidor MCP dá a um agente Claude acesso de leitura — e, quando autorizado, de escrita — a esse sistema, para uso de escritórios parceiros e gestores de fundo que já operam causas e carteiras no jud.

Quem pode usar

Só usuários externos já cadastrados no jud, com vínculo ativo a um escritório ou a um fundo. Não existe autocadastro: pedir o código de acesso só envia e-mail para quem já está cadastrado como usuário ativo — para qualquer outro e-mail, o pedido não devolve erro nenhum ao remetente, mas também não sai e-mail nenhum.

Um usuário cadastrado mas sem vínculo nenhum (nem escritório, nem fundo) consegue completar a autenticação e obter um token — mas toda chamada ao servidor MCP responde 403 {"error":"no active grants"}: o token existe, e não enxerga causa, tarefa ou devedor nenhum.

Como conectar

URL do servidor: https://judicial.tmdigital.ag/mcp

Adicione o servidor como connector.
O navegador abre a tela de login do jud — informe o e-mail já cadastrado.
Um código de 6 dígitos chega por e-mail, na mesma caixa cadastrada no jud.
Informe o código na tela seguinte e autorize o acesso.

A sessão fica atrelada a esse e-mail: só funciona para quem já tem conta ativa no jud.

Autenticação

OAuth 2.1 com registro dinâmico de cliente (/oauth/register) e PKCE obrigatório com S256 — o servidor recusa qualquer outro método de desafio.

Token de acesso: válido por 1 hora.
Refresh token: válido por 30 dias, rotacionado a cada uso — usar um refresh token que já foi trocado por um novo revoga toda a cadeia de tokens derivados dele.
Código de autorização: válido por 60 segundos, uso único.

O token é emitido para este servidor especificamente e é recusado se apresentado a qualquer outro recurso — a checagem roda na emissão e em cada chamada.

Que dados o agente acessa

Sempre recortado pelo vínculo do usuário que autorizou (ver "Isolamento entre organizações"), o agente lê — e, com o escopo jud:write concedido, escreve em — três famílias:

Carteira de causas — causas da carteira do usuário, linha do tempo de eventos de cada causa, processos monitorados com o último andamento, notificações do próprio usuário, mudanças recentes na carteira.
Tarefas e comentários — tarefas atribuídas ao usuário, criação/edição/ conclusão de tarefas, comentários publicados numa causa.
Ficha do devedor (Dossiê) — lista de devedores alcançáveis, perfil cadastral, linha do tempo de marcos da carteira, dívidas e títulos, histórico de esforço de cobrança, patrimônio de veículos levantado.

Isso inclui dado de devedor: nome, situação da dívida, patrimônio levantado, histórico de cobrança. Nas ferramentas que devolvem o documento do devedor diretamente (causas e lista de devedores), o CPF/CNPJ vem mascarado — só os últimos quatro caracteres ficam visíveis, o resto vira asterisco.

Catálogo completo

Ferramenta	Tipo	O que faz
`list_cases`	leitura	Lista as causas da carteira do usuário, com recorte opcional por fundo.
`get_case`	leitura	Devolve a ficha de uma causa da carteira do usuário.
`list_case_timeline`	leitura	Lista os eventos registrados numa causa da carteira do usuário.
`list_notifications`	leitura	Lista as notificações do próprio usuário no jud.
`list_lawsuits`	leitura	Lista os processos monitorados de uma causa, com o último andamento.
`list_recent_activity`	leitura	Lista o que mudou nas causas da carteira nos últimos dias.
`list_tasks`	leitura	Lista as tarefas atribuídas ao próprio usuário.
`create_task`	escrita	Cria uma tarefa vinculada a causas da carteira. Sem responsável informado, atribui a você com notificação in-app e sem e-mail. Responsável diferente recebe e-mail e notificação in-app.
`update_task`	escrita	Edita título, descrição ou prazo de uma tarefa que o usuário administra. Registra o evento na linha do tempo das causas vinculadas e sincroniza com o gerenciador de tarefas externo — não notifica ninguém, não move a tarefa entre causas.
`complete_task`	escrita	Conclui uma tarefa que o usuário administra. Registra o evento na linha do tempo das causas vinculadas e sincroniza com o gerenciador de tarefas externo — não notifica ninguém.
`list_case_comments`	leitura	Lista os comentários de uma causa da carteira do usuário.
`add_case_comment`	escrita	Publica um comentário numa causa da carteira do usuário, visível a quem acompanha a causa depois. A tool não aceita menção a ninguém — sem menção, a publicação não notifica nem envia e-mail para nenhum interno ou externo. A publicação não pode ser editada nem removida depois.
`list_debtors`	leitura	Lista os devedores do Dossiê ao alcance do usuário, com recorte opcional por fundo.
`get_debtor_profile`	leitura	Devolve o perfil cadastral do devedor de uma carteira que o usuário alcança. Consulta o BigQuery a cada chamada, sem cache.
`get_debtor_timeline`	leitura	Devolve os marcos da carteira do devedor em ordem cronológica. A primeira leitura de cada carteira consulta as fontes e o resultado fica em cache por 7 dias; não aciona modelo de linguagem.
`get_debtor_liabilities`	leitura	Devolve, até o limite pedido, as dívidas e títulos da carteira do devedor. Consulta o BigQuery a cada chamada, sem cache.
`get_debtor_effort`	leitura	Devolve o histórico de esforço de cobrança sobre o devedor. A primeira leitura de cada carteira pode gerar o texto por modelo de linguagem pago e grava cache por 7 dias.
`get_debtor_patrimony`	leitura	Devolve o patrimônio de veículos levantado do devedor de uma carteira alcançável, sem imóveis. Consulta o Postgres a cada chamada, sem cache.

O que o agente NÃO acessa

Dado de qualquer organização que não seja a do usuário (ver "Isolamento entre organizações").
Contatos do devedor (telefone, e-mail, pessoas vinculadas) — servidos só na tela do Dossiê, sem ferramenta MCP correspondente.
A ficha agregada do Dossiê — o agente lê cada bloco (perfil, linha do tempo, dívidas, esforço, patrimônio) em ferramentas separadas, nunca o agregado inteiro de uma vez.
Os verbos de escrita do módulo Judicial da causa: registrar medida, editar estratégia, lançar custas, mudar fase da causa. Nenhum deles tem ferramenta MCP — só existem na tela do jud.

Isolamento entre organizações

O escopo de cada chamada é resolvido no servidor a partir do vínculo do usuário autenticado — nunca de um parâmetro que o agente informa. Toda leitura é filtrada por esse escopo antes de tocar o banco. Um identificador de causa, tarefa ou devedor de outra organização responde do mesmo jeito que um identificador que não existe: "não encontrado" — o servidor não distingue as duas situações na resposta, para não confirmar que o recurso existe em outra organização.

É a mesma regra que vale para a interface web do jud: o MCP não tem caminho próprio de acesso, lê pelo mesmo escopo.

Escrita

Com o escopo jud:write concedido no momento da autorização, o agente pode:

Criar tarefa vinculada a causas da carteira.
Editar título, descrição ou prazo de uma tarefa que o usuário administra.
Concluir uma tarefa que o usuário administra.
Comentar numa causa da carteira.

Toda ferramenta de escrita é anunciada ao cliente MCP como não-somente-leitura — é esse sinal que faz o Claude pedir confirmação ao usuário antes de executar.

O que notifica

Criar tarefa para outra pessoa dispara e-mail e notificação in-app para quem foi designado; criar tarefa para si mesmo gera só notificação in-app, sem e-mail.

O que não notifica

Editar tarefa, concluir tarefa e comentar numa causa não enviam e-mail nem notificação a ninguém — a ferramenta de comentário não aceita menção a ninguém, então não existe canal para acionar alguém a partir dela. Um comentário publicado não pode ser editado nem removido depois.

Toda escrita fica registrada na trilha permanente da causa, assinada com o e-mail de quem operou.

Registro e auditoria

Toda chamada ao servidor — leitura ou escrita — grava uma linha com a ferramenta usada, o token que a fez e o desfecho; o log da aplicação acrescenta o e-mail do usuário. Esse registro não guarda o conteúdo da chamada: nem documento consultado, nem nome de devedor, nem termo de busca.

Escritas, além disso, ficam na trilha permanente da causa, assinadas pelo e-mail de quem operou.

Limites de uso

Recurso	Teto	Janela
Chamadas de ferramenta, qualquer uma	60	1 minuto, por token
Família Ficha do devedor (Dossiê)	20	1 minuto, por token — dentro do teto geral, não além dele

O teto da Ficha do devedor é mais apertado porque essas seis ferramentas consultam BigQuery a cada chamada, ou podem acionar geração de texto por modelo de linguagem pago.

Suporte

Para relatar problema, escreva para anderson.feitosa@tmdigital.ag — líder de engenharia e produto da tmdigital.

O tratamento de dados pessoais neste servidor está descrito na Política de Privacidade do conector.