Skip to main content
O servidor MCP do Matcher expõe a superfície de conciliação do Matcher como ferramentas do Model Context Protocol. 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.
O Matcher está disponível apenas se você adquiriu o produto Matcher. Quer acesso? Fale com o nosso time para saber mais.

​
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:
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:
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 para o catálogo.