<img src="docs/cover.svg" width="100%" alt="JurisprudênciaIA MCP. Pesquisa jurídica conectada ao seu assistente de IA.">

# JurisprudênciaIA MCP

**Pesquise jurisprudência brasileira dentro da conversa em que você trabalha.**

Este conector aproxima o serviço JurisprudênciaIA de assistentes compatíveis com MCP. Você configura um servidor próprio no Cloudflare Workers; as pessoas autorizadas entram com a conta Google e passam a usar as ferramentas de pesquisa no assistente.

**[Configure com seu agente de IA ↗](https://brunoflma.github.io/jurisprudenciaia-mcp/deploy-guide.html#instalar-com-ia)** · [Explore o projeto e os roteiros](https://brunoflma.github.io/jurisprudenciaia-mcp/) · [Instalação manual](https://brunoflma.github.io/jurisprudenciaia-mcp/deploy-guide.html#instalar) · [Conectar no Claude ou Codex](https://brunoflma.github.io/jurisprudenciaia-mcp/deploy-guide.html#conectar)

**O conector foi útil para você?** Use **Star**, no topo do repositório, para salvá-lo e apoiar o projeto. Se já utilizou, [conte sua experiência ou sugira uma melhoria](https://github.com/brunoflma/jurisprudenciaia-mcp/issues/new?template=experiencia.yml). A estrela é opcional.

## 14 ferramentas, vários recortes de pesquisa

| Frente | O que as ferramentas solicitam ao serviço |
| :--- | :--- |
| **Pesquisa** | Consulta livre, jurisprudência, precedentes, informativos e precedentes qualificados. |
| **Teses** | Análise de uma tese e comparação de duas teses para a mesma questão. |
| **Processos** | Decisões e andamentos relevantes a partir de um número CNJ, conforme a cobertura da fonte. |
| **Normas** | Legislação, citações de dispositivos e histórico de alterações. |
| **Panorama** | Amostra de julgados, linha do tempo e entendimentos superados ou revistos. |

Veja o [catálogo na página do projeto](https://brunoflma.github.io/jurisprudenciaia-mcp/#ferramentas) e as [definições no código](src/mcp/tool-definition.ts). São recortes que orientam pedidos ao mesmo serviço, e não bases independentes. O panorama da amostra não representa estatística oficial ou exaustiva de um tribunal.

### Um pedido para experimentar após conectar

```text
Use o JurisprudênciaIA MCP para buscar precedentes sobre [TEMA].
Apresente as referências, o tribunal, a data, os links e os pontos de cautela.
Preserve a ementa e o inteiro teor disponibilizados pela fonte.
Se o inteiro teor não estiver disponível, informe isso explicitamente.
```

Os [roteiros da página](https://brunoflma.github.io/jurisprudenciaia-mcp/#exemplos) mostram formas de pedir a pesquisa, sem realizar consultas nem apresentar julgados fictícios como resultados reais.

## Da pesquisa à conversa

| O que você precisa | Como o conector ajuda |
| :--- | :--- |
| Consultar jurisprudência durante a análise de um assunto | Disponibiliza a pesquisa do JurisprudênciaIA como ferramentas do assistente. |
| Compartilhar o acesso com pessoas autorizadas | Usa login Google e uma lista de e-mails permitidos no servidor. |
| Manter a integração sob seu controle | O servidor é hospedado no seu próprio Cloudflare Worker. |
| Conectar sem distribuir um token manual a cada usuário | O cliente compatível descobre o fluxo OAuth e apresenta o login. |

O conector cuida da integração e do acesso. A base e o serviço de pesquisa são do **JurisprudênciaIA**. Os resultados precisam ser lidos e conferidos nas fontes antes de uso profissional.

## Escolha seu ponto de partida

### Quero usar no meu assistente

1. Peça a URL do servidor à pessoa responsável pela configuração.
2. Adicione essa URL como conector no seu cliente compatível.
3. Entre com a conta Google que foi autorizada.
4. Confirme que o assistente executa uma ferramenta sem erro; a lista exibida pode estar em cache.

O [guia de instalação e conexão](https://brunoflma.github.io/jurisprudenciaia-mcp/deploy-guide.html) acompanha a configuração na Cloudflare, o login Google e a primeira pesquisa no assistente. Para ler offline, [baixe o guia completo](docs/assets/oauth-guide/guia-conexao-advogado.zip), extraia o pacote e abra `deploy-guide.html`. O pacote inclui os estilos, a fonte e os recursos de cópia; os links para serviços externos precisam de internet.

**Quer configurar com um agente de IA?** [Copie o prompt completo no guia](https://brunoflma.github.io/jurisprudenciaia-mcp/deploy-guide.html#instalar-com-ia) ou [baixe em texto](docs/agent-setup-prompt.txt). Ele orienta o agente desde a verificação do ambiente até o teste de pesquisa. Você acompanha os logins e a inclusão de credenciais; a execução depende das ferramentas e permissões do agente.

### Quero configurar meu servidor

Siga o [guia de implantação](docs/deployment.md). Ele reúne os requisitos, as variáveis e a configuração de autenticação.

Os pontos centrais são:

- **Servidor:** Cloudflare Workers.
- **Identidade:** conta Google, com OAuth 2.1 e PKCE S256.
- **Acesso:** e-mails autorizados em `MCP_ALLOWED_EMAILS`.
- **Segredo do Google:** `MCP_GOOGLE_CLIENT_SECRET`, armazenado no Worker.
- **Clientes:** registro dinâmico no fluxo de autenticação descrito nos guias.

## O caminho de uma consulta

```mermaid
flowchart LR
    A["Claude ou Codex"] --> B["Seu servidor MCP"]
    B --> C["Login Google + e-mail autorizado"]
    C --> D["Pesquisa no JurisprudênciaIA"]
    D --> A
```

## Clientes documentados

| Cliente | Guia | Autenticação |
| :--- | :--- | :--- |
| Claude | [Conexão no Claude](docs/claude-3p.md) | OAuth 2.1, PKCE S256 e Google |
| Codex | [Conexão no Codex](docs/codex.md) | OAuth 2.1, PKCE S256 e Google |

Outros clientes MCP podem ter requisitos próprios. Verifique a compatibilidade do cliente com o fluxo de autenticação antes de utilizá-lo.

<details>
<summary><strong>Veja as etapas de conexão</strong></summary>

As telas abaixo são ilustrativas e usam dados fictícios.

**1. Adicionar o conector**

![Adicionar o conector](docs/assets/oauth-guide/01-adicionar-conector.png)

**2. Autorizar a conta Google**

![Autorizar com Google](docs/assets/oauth-guide/02-autorizar-google.png)

**3. Confirmar a conexão**

![Conexão concluída](docs/assets/oauth-guide/03-conexao-concluida.png)

</details>

## Documentação e colaboração

[Implantação](docs/deployment.md) · [Guia visual](https://brunoflma.github.io/jurisprudenciaia-mcp/deploy-guide.html) · [Compatibilidade e segurança](docs/compatibility-and-security.md) · [Problemas e sugestões](https://github.com/brunoflma/jurisprudenciaia-mcp/issues)

Ao relatar um problema, informe o cliente utilizado e a etapa em que a conexão falhou. Remova tokens, segredos e dados de processos dos exemplos enviados.

Desenvolvido por [Bruno Ferreira](https://github.com/brunoflma). Conheça também o [Jusmanizer](https://github.com/brunoflma/jusmanizer), voltado à revisão do estilo da escrita jurídica.