> For the complete documentation index, see [llms.txt](https://trf2.gitbook.io/apoia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trf2.gitbook.io/apoia/outras-funcionalidades/servidor-mcp.md).

# Servidor MCP

{% embed url="<https://youtu.be/6uOwTVOrQgI>" %}

### O que é o Servidor MCP?

O Model Context Protocol (MCP) é um protocolo padrão de comunicação que permite integrar as ferramentas e fontes de dados da Apoia diretamente a clientes externos de Inteligência Artificial, tais como o Claude (Anthropic) e o ChatGPT (OpenAI).

Através do Servidor MCP da Apoia, magistrados e servidores podem consultar as peças e metadados de processos diretamente das interfaces dessas plataformas externas de IA.

### Requisitos de Privacidade e LGPD

O uso do Servidor MCP exige atenção rigorosa às diretrizes de segurança da informação e proteção de dados pessoais:

* Zero Retenção de Dados: O cliente de IA externo selecionado deve garantir a não retenção de dados e o não aproveitamento das informações submetidas para treinamento de modelos.
* Conformidade Legal: A utilização de ferramentas externas sem garantias explícitas de privacidade viola a Lei Geral de Proteção de Dados Pessoais (LGPD) e a Resolução CNJ nº 615/2025.

### Gerando a URL de Conexão (Token)

Para conectar o Apoia a um cliente externo via MCP, é necessário gerar uma URL de autenticação pessoal:

1. Acesse o menu "MCP" na barra superior da Apoia.
2. Clique no botão "Gerar URL" para criar o link de conexão que contém o seu token de acesso individual.
3. Copie o link exibido.

> ⚠️ Validade do Token: A URL gerada possui validade de até 8 horas a contar do momento do login. Expirado este prazo, será necessário realizar um novo login na Apoia e gerar um novo link de conexão.
>
> 🔒 Segurança: O link gerado funciona como uma credencial pessoal e nunca deve ser compartilhado com terceiros.

### Configuração em Clientes de IA

#### Anthropic (Claude)

1. No Claude, acesse as configurações da sua conta e vá para a seção Customize > Connectors.
2. Clique em Add custom connector.
3. Defina um nome para a conexão (ex.: `Apoia`) e cole a URL gerada na Apoia.
4. Clique em Connect e autorize o uso das ferramentas disponíveis (`processMetadata` e `piecesText`).

#### OpenAI (ChatGPT)

1. No ChatGPT, abra o menu de configurações de plugins/conectores e selecione a opção para adicionar um novo plugin.
2. Insira o nome da integração (ex.: `Apoia`), cole a URL de conexão e selecione a opção No Auth (a autenticação é realizada diretamente pelo token contido na URL).
3. Conecte e configure as permissões da aplicação marcando a opção Allow all actions.

### Ferramentas Disponíveis via MCP

Após a conexão, o cliente de IA externo passará a ter acesso automático às ferramentas do ecossistema Apoia, sendo as principais:

* `processMetadata`: Consulta e retorna os metadados e informações gerais do processo a partir do número informado (com anonimização/proteção de dados sensíveis).
* `piecesText`: Realiza a busca e a leitura do teor das peças e documentos processuais.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://trf2.gitbook.io/apoia/outras-funcionalidades/servidor-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.