MCP HTTP Remoto & OAuth

Integrações de IA para Direito Português

Uma Ligação. Ferramentas Jurídicas no Teu Cliente de IA.

Liga um cliente de IA compatível ao Lauyer para pesquisar legislação, publicações oficiais e decisões judiciais portuguesas. A ligação usa um ponto de acesso MCP partilhado e autorização OAuth no navegador.

Cliente de IA

Cliente de IA

  • MCP por HTTP remoto
  • OAuth no navegador

Lauyer

OAuth · MCP

Ponto de acesso partilhadohttps://lauyer.org/api/mcp

Requisitos de Compatibilidade

O Cliente Precisa de Duas Capacidades. Não Precisa de uma Chave de API.

O Lauyer é um servidor MCP remoto protegido por OAuth. O cliente tem de aceitar um URL HTTPS de servidor MCP e conseguir iniciar a autorização no navegador. Uma integração limitada a servidores locais por stdio, ou sem OAuth para MCP remoto, não consegue concluir esta ligação.

Transporte HTTP remoto

O cliente envia pedidos MCP para o endereço HTTPS do Lauyer. Não há servidor Lauyer para instalar localmente nem um endpoint REST público para configurar.

OAuth iniciado pelo cliente

Quando o Lauyer responde que o recurso está protegido, o cliente consulta os metadados de autorização, regista-se e abre o navegador para início de sessão e consentimento.

Registo dinâmico

O servidor aceita o registo dinâmico do cliente. O fluxo usa PKCE e tokens bearer; não deves copiar tokens nem guardar uma chave do Lauyer em ficheiros de configuração.

Compatibilidade por Cliente

A Mesma Entrada. Configurações Diferentes no Lado do Cliente.

A compatibilidade depende do plano, da política do espaço de trabalho e da versão do cliente. As instruções abaixo distinguem os percursos documentados no repositório dos clientes que deves confirmar antes de configurar.

Matriz de Compatibilidade

Claude Code

Configuração documentada no README do projeto.

MCP remoto

Adicionar com --transport http e o URL do Lauyer.

Autorização

Abrir /mcp, selecionar Lauyer e escolher Authenticate.

claude.ai

Conector personalizado documentado. A disponibilidade depende do plano e da política do espaço de trabalho.

MCP remoto

Adicionar o URL como conector personalizado.

Autorização

O cliente conduz o fluxo OAuth no navegador.

Outros Clientes MCP

ChatGPT, Cursor, Codex e outros clientes não são apresentados como verificados nesta página. Confirma a versão, o plano e as capacidades atuais do teu cliente.

MCP remoto

Tem de aceitar um servidor MCP HTTPS remoto.

Autorização

Tem de suportar OAuth e registo dinâmico para esse servidor.

Os menus e as funcionalidades de terceiros podem mudar. Se o cliente apenas pedir uma chave de API ou um comando stdio, esse percurso não corresponde à ligação OAuth do Lauyer.

Autorização no Navegador

O Cliente Pede Acesso. Tu Decides no Lauyer.

A autorização separa a configuração técnica da decisão de dar acesso à tua conta. Inicia o processo no cliente em que confias, confirma o endereço do Lauyer no navegador e revê as permissões apresentadas antes de permitir o acesso.

Descoberta

O cliente tenta aceder a /api/mcp, recebe uma resposta 401 e segue os metadados do recurso protegido e do servidor de autorização.

Início de sessão

O navegador abre o Lauyer. O valor de regresso ao cliente é preservado durante o início de sessão e a verificação do email.

Consentimento

O Lauyer mostra as permissões pedidas. Se recusares, o cliente não recebe autorização para usar as ferramentas.

Código & tokens

Depois da aprovação, o cliente troca o código com PKCE por tokens e repete o pedido MCP com um token bearer.

Pedido do Cliente MCP

Autorizar o Acesso às Ferramentas do Lauyer

Inicia sessão com a Google ou com um endereço de email verificado e palavra-passe. Depois, o Lauyer apresenta as permissões pedidas pelo cliente.

Permissões pedidas

  • openid
  • profile
  • email
  • offline_access

A tua decisão

Permitir o acesso

OAuth

Recusar e regressar ao cliente

Pedido do Cliente MCP

Depois da Autorização

As Ferramentas Surgem Onde Já Trabalhas com IA.

Após uma ligação concluída, o cliente pode listar e chamar as ferramentas do Lauyer. Começa uma conversa ou sessão nova se o cliente só atualizar o catálogo de ferramentas no arranque.

Decisões Judiciais · DGSI

Pesquisa dez bases da DGSI, consulta o conteúdo público de uma decisão e obtém os códigos de tribunal disponíveis.

  • dgsi_search
  • dgsi_fetch
  • dgsi_courts

Legislação & Publicações · DR

Pesquisa o Diário da República, consulta um diploma, vê as publicações do dia e identifica os tipos de atos aceites.

  • dr_search
  • dr_fetch
  • dr_today
  • dr_types

Resumos por IA

Resume uma decisão ou um diploma para triagem inicial. O resumo é uma ajuda gerada por IA, não uma fonte jurídica nem uma conclusão profissional.

  • dgsi_tldr
  • dr_tldr

Ligar, Voltar a Ligar & Revogar

A Ligação Tem um Ciclo de Vida. O URL Não Muda.

Configurar o servidor, autorizar a conta e manter a autorização são ações distintas. Se a ligação deixar de funcionar, não cries uma chave improvisada: volta ao fluxo OAuth do cliente.

Ligar

Adiciona o ponto de acesso partilhado no cliente e conclui o início de sessão e o consentimento no navegador.

Voltar a ligar

Usa a opção Authenticate ou Connect do cliente. Se necessário, remove a ligação antiga, volta a adicionar o mesmo URL e autoriza novamente.

Revogar

Usa primeiro o controlo de desligar ou revogar do cliente. Se o cliente não disponibilizar esse controlo, pede ajuda através de privacy@lauyer.org.

Estados da Ligação

O navegador não abre

O cliente pode não suportar OAuth para MCP remoto, a funcionalidade pode estar desativada pelo plano ou a configuração pode estar a usar stdio.

Confirma HTTP remoto, OAuth e o URL exato. Não introduzas uma chave de API.

O consentimento foi recusado

Sem aprovação, o cliente regressa sem autorização para listar ou chamar as ferramentas do Lauyer.

Reinicia o fluxo apenas no cliente que escolheste e revê novamente as permissões.

A autorização deixou de funcionar

O token pode ter caducado, sido revogado ou ficado associado a uma configuração antiga do cliente.

Escolhe Authenticate ou Connect. Se persistir, remove a entrada e adiciona novamente o mesmo URL.

Ligado, mas sem ferramentas

Alguns clientes só atualizam a lista de ferramentas quando uma conversa, sessão ou aplicação é reiniciada.

Inicia uma sessão nova e confirma que o cliente aponta para https://lauyer.org/api/mcp.

Dados ao Longo da Ligação

Cliente, Lauyer & Fonte Têm Papéis Diferentes.

Uma pesquisa pode passar por vários intervenientes. Para trabalho jurídico, laboral ou de compliance, remove dados desnecessários e confirma as políticas e os deveres aplicáveis antes de enviares informação confidencial ou pessoal.

Percurso dos Dados

Cliente de IA

Vê a conversa, os parâmetros das ferramentas e os resultados. Pode conservá-los segundo as definições, o contrato e a política do teu espaço de trabalho.

Lauyer

Trata os dados de conta, autenticação, consentimento, utilização e faturação necessários. Encaminha cada pesquisa ou consulta para a fonte pedida.

Fonte Jurídica

A DGSI ou o Diário da República recebe o pedido necessário e devolve o conteúdo público disponível no momento. Pode manter registos técnicos próprios.

Ramo Separado: Resumo por IA

Só quando pedes um resumo, o Lauyer envia o texto jurídico relevante e as instruções à OpenRouter e ao fornecedor de modelo subjacente.

O Lauyer não mantém uma cópia paralela do acervo integral da DGSI ou do Diário da República. Abre sempre a ligação original e confirma o texto, a data, a vigência, as alterações, os recursos e o contexto antes de confiares no resultado.

Acesso, Utilização & Créditos

Autorizar Não É o Mesmo que Consumir uma Ferramenta.

A ligação OAuth dá ao cliente autorizado a possibilidade de pedir ferramentas. A utilização só é contabilizada quando essas ferramentas são chamadas, segundo o respetivo peso.

Pesquisa & Consulta

O plano Pro custa 10 € por mês e inclui 1.000 unidades de pedidos por mês civil UTC. Pesquisas e consultas usam unidades com pesos diferentes; as ferramentas de tipos e tribunais são gratuitas.

Resumos por IA

O Pro inclui separadamente 40 resumos por IA por mês civil UTC. Cada dgsi_tldr ou dr_tldr usa uma unidade desta utilização de IA. Um resumo não substitui a leitura da fonte original.

Carregamentos Opcionais

Podes comprar entre 10 € e 50 € em créditos, mesmo sem Pro. Cada euro acrescenta 100 unidades de pedidos e 4 unidades de resumos por IA; os lotes caducam 12 meses após o pagamento.

Antes de Ligares

Perguntas Frequentes sobre Integrações de IA

O que tem de suportar o meu cliente de IA?+

Tem de aceitar um servidor MCP por HTTP remoto através de HTTPS e iniciar OAuth no navegador, incluindo o registo dinâmico do cliente. O suporte apenas para servidores locais por stdio não é suficiente.

Qual é o endereço do servidor MCP do Lauyer?+

O ponto de acesso de produção é https://lauyer.org/api/mcp. O mesmo endereço dá acesso ao catálogo de ferramentas depois da autorização; não existem URLs diferentes para DGSI e Diário da República.

Preciso de uma chave de API?+

Não. A ligação usa OAuth no navegador. Se um cliente pedir apenas uma chave de API, confirma se suporta autenticação OAuth para servidores MCP HTTP remotos. Não copies tokens de acesso para a configuração.

Como inicio sessão durante a ligação?+

Podes usar a Google ou um endereço de email verificado e uma palavra-passe. O Lauyer preserva o regresso ao fluxo MCP durante o início de sessão, a verificação e o consentimento.

Que permissões aparecem no consentimento?+

O fluxo atual pode pedir openid, profile, email e offline_access. Revê sempre o ecrã apresentado. A permissão offline_access permite ao cliente manter o acesso através do mecanismo de renovação até a autorização caducar ou ser revogada.

Posso ligar mais do que um cliente?+

Sim, desde que cada cliente seja compatível. Cada ligação inicia o seu próprio pedido de autorização e pode ter práticas diferentes de armazenamento, auditoria e administração do espaço de trabalho.

Como volto a ligar um cliente?+

Usa a opção Authenticate ou Connect do cliente e conclui novamente o fluxo no navegador. Se houver uma configuração antiga, remove-a e volta a adicionar https://lauyer.org/api/mcp antes de autorizar.

Como revogo uma autorização?+

Começa pelo controlo de desligar ou revogar disponibilizado pelo cliente. Se não existir ou não funcionar, contacta privacy@lauyer.org para obter ajuda. Revogar a ligação não apaga automaticamente os dados que o cliente conserve de forma independente.

O que fica disponível depois da autorização?+

O cliente pode listar ferramentas para pesquisar e consultar a DGSI e o Diário da República, ver tribunais e tipos de atos e pedir resumos por IA. Alguns clientes exigem uma conversa ou sessão nova para atualizar o catálogo.

Que dados vê o cliente de IA?+

O cliente vê a conversa, os parâmetros enviados às ferramentas e os resultados devolvidos. Pode ainda conservar autorizações e registos segundo as suas políticas e as definições do espaço de trabalho. Confirma essas condições antes de usar dados profissionais.

Um resultado ou resumo dispensa a fonte original?+

Não. As fontes podem estar incompletas ou indisponíveis e os resumos por IA podem omitir contexto ou estar errados. Abre a DGSI ou o Diário da República e confirma o documento, a versão, a vigência, as alterações e o contexto relevante.

A autorização inclui utilização ilimitada?+

Não. O OAuth autoriza a ligação, mas cada ferramenta continua sujeita à dotação disponível na conta. Ligar vários clientes também não cria limites separados: todos usam a mesma conta Lauyer.

Leva as Fontes para o Teu Fluxo de Trabalho

Liga o Cliente. Autoriza o Acesso. Começa na Fonte.

Adiciona o endpoint, conclui o consentimento no navegador e confirma que o catálogo de ferramentas fica disponível no cliente.

Obter as Ferramentas