> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP do Matcher

> Conecte assistentes de IA ao Matcher pelo Model Context Protocol, uma superfície de ferramentas segura e com repasse de token sobre o motor de conciliação.

O **servidor MCP do Matcher** expõe a superfície de conciliação do Matcher como ferramentas do [Model Context Protocol](https://modelcontextprotocol.io). Um assistente de IA, ou qualquer cliente MCP, pode então operar o Matcher em seu nome. Ele pode inspecionar contextos, começar execuções de conciliação, trabalhar exceções e puxar relatórios. Ele tem as mesmas permissões que você já tem.

<Warning>
  O Matcher está disponível apenas se você adquiriu o produto Matcher. Quer acesso? [Fale com o nosso time](https://lerian.studio/contact) para saber mais.
</Warning>

## Como ele se conecta

***

O servidor fala **Streamable HTTP**. Ele roda como serviço próprio ao lado da API do Matcher e expõe um único endpoint MCP (`POST /mcp`) mais uma sonda simples de liveness (`GET /healthz`). Não existe transporte stdio: cada cliente se conecta a ele como um servidor *remoto* pela rede.

Aponte qualquer cliente MCP com Streamable HTTP para o endpoint que o seu time de plataforma fornece e envie o seu token bearer do Matcher na conexão. Por exemplo, com o Claude Code:

```bash theme={null}
claude mcp add --transport http matcher https://your-matcher-mcp.example.com/mcp \
  --header "Authorization: Bearer <matcher-jwt>"
```

Para desenvolvimento local, o relay também é distribuído como pacote npm público. Suba-o apontado para a sua API do Matcher e conecte em `http://localhost:4019/mcp`:

```bash theme={null}
MATCHER_API_URL=https://your-matcher-api npx @lerianstudio/matcher-mcp
```

Qualquer cliente MCP que ofereça suporte a Streamable HTTP funciona da mesma forma: dê a ele a URL e o header `Authorization: Bearer <matcher-jwt>`.

## Postura de autenticação

***

O servidor é um **relay de credenciais sem estado** que não acrescenta identidade própria:

* **Token bearer para chamadas de API.** As ferramentas que despacham requisições à API do Matcher falham fechadas sem um token bearer. Elas repassam a credencial fornecida pelo cliente sem registrar em log, guardar nem devolver o valor.
* **Utilitários locais.** `mcp_ping`, `matcher_list_operations` e `matcher_describe_operation` rodam localmente e não precisam de token. `mcp_whoami` não chama o Matcher. Ainda assim ele precisa de uma credencial bearer, porque informa que uma credencial chegou. Sem credencial, ele retorna um erro de ferramenta.
* **O tenant segue o token nas chamadas de API.** Nenhuma ferramenta que despacha para a API aceita um parâmetro de tenant. O Matcher resolve o tenant a partir do JWT repassado.
* **Sem estado de sessão.** Cada requisição monta um servidor novo em memória, então você pode escalar e reiniciar o relay à vontade.

Para conferir a configuração do seu cliente, chame `mcp_whoami` com uma credencial bearer depois de conectar. Ele informa apenas que a credencial chegou, nunca o valor dela.

## O que você pode fazer com ele

***

O servidor expõe famílias de ferramentas curadas para configuração, execuções de conciliação, exceções e disputas, ingestão e relatórios. Ele também expõe uma ponte genérica para operações com corpo de requisição em JSON. Veja [Ferramentas MCP do Matcher](/pt/products/matcher/mcp/matcher-mcp-tools) para o catálogo.