Pular para o conteúdo principal
O servidor MCP do Matcher expõe uma superfície de ferramentas curada — uma ferramenta ergonômica e validada por operação comum — mais um trio genérico que alcança qualquer operação da API do Matcher. As ferramentas seguem a convenção de nomes family_action (por exemplo, context_list ou match_run_start), então ferramentas relacionadas compartilham um prefixo. Esta página lista as famílias com exemplos representativos; ela deliberadamente não é um catálogo exaustivo. Conecte um cliente e liste as ferramentas disponíveis para ver a superfície completa da sua versão.

Famílias curadas


CategoriaFamíliasO que cobremFerramentas representativas
Configuraçãocontext_*, source_*, field_map_*Contextos de reconciliação, suas fontes de dados e os mapeamentos de campos que normalizam os registros recebidos.context_create, context_setup_progress, source_list, field_map_update
Regras de matchingmatch_rule_*As regras de matching que um contexto aplica, incluindo a ordem de avaliação.match_rule_create, match_rule_reorder
Tarifasfee_schedule_*, fee_rule_*Tabelas de tarifas esperadas e as regras associadas a elas, incluindo simulação antes da ativação.fee_schedule_simulate, fee_rule_create
Execuções de reconciliaçãomatch_run_*Conduzir a reconciliação — iniciar uma execução, acompanhar o progresso, inspecionar os grupos de match resultantes.match_run_start, match_run_groups
Exceçõesexception_*Trabalhar transações não conciliadas — listagem, histórico e comentários, ações por exceção e operações em lote.exception_list, exception_force_match, exception_bulk_resolve
Disputasdispute_*O ciclo de vida de disputas para exceções contestadas.dispute_submit_evidence, dispute_close
Ingestãoingestion_*O ciclo de vida de importação — enviar dados, inspecionar jobs e erros por linha, buscar e ignorar transações.ingestion_upload, ingestion_job_errors_list
Relatóriosdashboard_*, report_*Agregados do dashboard e recortes focados, além de leituras, contagens e exportações de relatórios.dashboard_match_rate, report_summary, report_export_unmatched

Trio genérico


Quando uma ferramenta curada não cobre uma operação, o trio genérico alcança toda a superfície da API do Matcher:
FerramentaPropósito
matcher_list_operationsLista todas as operações que o Matcher conectado expõe.
matcher_describe_operationDescreve uma operação — parâmetros, schema do corpo da requisição e respostas.
matcher_invokeMonta, valida e despacha qualquer operação com as suas credenciais repassadas.
As ferramentas curadas e o matcher_invoke compartilham um único cliente HTTP e um único relay de token, então autorização e mapeamento de erros se comportam de forma idêntica nas duas superfícies — os erros do Matcher voltam como problem details RFC 9457 em ambos os casos.

Utilitários


FerramentaPropósito
mcp_pingConfirma que o servidor está acessível.
mcp_whoamiInforma se a credencial bearer do seu cliente chegou — apenas a presença, nunca o valor.