Skip to main content
El servidor MCP de Matcher expone la superficie de conciliación de Matcher como herramientas de Model Context Protocol. Un asistente de IA, o cualquier cliente MCP, puede entonces operar Matcher en tu nombre. Puede inspeccionar contextos, iniciar ejecuciones de conciliación, trabajar excepciones y traer informes. Tiene los mismos permisos que tú ya tienes.
Matcher está disponible solo si adquiriste el producto Matcher. ¿Quieres acceso? Habla con nuestro equipo para saber más.

Cómo se conecta


El servidor habla Streamable HTTP. Se ejecuta como su propio servicio junto a la API de Matcher y expone un único endpoint MCP (POST /mcp) más una sonda simple de liveness (GET /healthz). No hay transporte stdio: cada cliente se conecta a él como un servidor remoto por la red. Apunta cualquier cliente MCP de Streamable HTTP al endpoint que provee tu equipo de plataforma y envía tu Bearer token de Matcher en la conexión. Por ejemplo, con Claude Code:
Para el desarrollo local, el relay también se distribuye como un paquete npm público. Inícialo apuntando a tu API de Matcher y conéctate a http://localhost:4019/mcp:
Cualquier cliente MCP compatible con Streamable HTTP funciona igual: dale la URL y el header Authorization: Bearer <matcher-jwt>.

Postura de autenticación


El servidor es un relay de credenciales sin estado que no agrega ninguna identidad propia:
  • Bearer token para las llamadas a la API. Las herramientas que despachan solicitudes a la API de Matcher fallan de forma cerrada sin un Bearer token. Reenvían la credencial que provee el cliente sin registrarla, almacenarla ni devolverla.
  • Utilidades locales. mcp_ping, matcher_list_operations y matcher_describe_operation se ejecutan localmente y no necesitan token. mcp_whoami no llama a Matcher. Aun así necesita una credencial bearer, porque informa que llegó una credencial. Sin una credencial, devuelve un error de herramienta.
  • El tenant sigue al token en las llamadas a la API. Ninguna herramienta que despacha a la API acepta un parámetro de tenant. Matcher resuelve el tenant a partir del JWT retransmitido.
  • Sin estado de sesión. Cada solicitud construye un servidor nuevo en memoria, así puedes escalar y reiniciar el relay con libertad.
Para revisar la configuración de tu cliente, llama a mcp_whoami con una credencial bearer después de conectarte. Informa solo que la credencial llegó, nunca su valor.

Qué puedes hacer con él


El servidor expone familias curadas de herramientas para la configuración, las ejecuciones de conciliación, las excepciones y disputas, la ingesta y los informes. También expone un puente genérico para las operaciones con cuerpos de solicitud JSON. Consulta Herramientas MCP de Matcher para ver el catálogo.