Saltar al contenido principal
El servidor MCP de Matcher expone la superficie de reconciliación de Matcher como herramientas del Model Context Protocol, para que un asistente de IA — o cualquier cliente MCP — opere Matcher en tu nombre: inspecciona contextos, inicia ejecuciones de reconciliación, trabaja excepciones y extrae reportes, todo con los mismos permisos que ya tienes.
Matcher solo está disponible si has adquirido el producto Matcher. ¿Quieres acceso? Ponte en contacto con nuestro equipo para saber más.

​
Cómo se conecta

El servidor habla Streamable HTTP. Se ejecuta como un servicio propio junto a la API de Matcher y expone un único endpoint MCP (POST /mcp) más una sonda de liveness (GET /healthz). No hay transporte stdio: todo cliente se conecta a él como un servidor remoto a través de la red. Apunta cualquier cliente MCP con Streamable HTTP al endpoint que te proporcione tu equipo de plataforma y envía tu bearer token de Matcher en la conexión. Por ejemplo, con Claude Code: 
claude mcp add --transport http matcher https://tu-matcher-mcp.example.com/mcp \
  --header "Authorization: Bearer <matcher-jwt>"
Para desarrollo local, el relay también se publica como un paquete npm público — inícialo apuntando a tu API de Matcher y conéctate a http://localhost:4019/mcp: 
MATCHER_API_URL=https://tu-api-matcher npx @lerianstudio/matcher-mcp
Cualquier cliente MCP compatible con Streamable HTTP funciona de la misma manera: indícale la URL y el header Authorization: Bearer <matcher-jwt>.

​
Postura de autenticación

El servidor es un relay de credenciales sin estado — no añade identidad propia:
  • Tu token, reenviado tal cual. El cliente envía el mismo JWT de Matcher que usarías contra la API directamente (emitido por tu Access Manager). El servidor lo reenvía a la API de Matcher en cada llamada de herramienta y nunca registra, almacena ni repite el token.
  • Fail-closed. Una llamada de herramienta que llega sin bearer token se rechaza antes de que ninguna petición alcance Matcher. No existe un fallback anónimo ni de tenant por defecto.
  • El tenant sigue al token. Ninguna herramienta acepta un parámetro de tenant; Matcher resuelve tu tenant íntegramente a partir del JWT reenviado, así que la superficie MCP nunca cruza fronteras de tenant.
  • Sin estado de sesión. Cada petición construye un servidor nuevo en memoria, por lo que el relay puede escalarse y reiniciarse libremente.
Para verificar que tu cliente está configurado correctamente, llama a la herramienta mcp_whoami después de conectar — informa solo de si la credencial llegó, nunca de su valor.

​
Qué puedes hacer con él

El servidor expone familias de herramientas curadas que cubren configuración, ejecuciones de reconciliación, excepciones y disputas, ingesta y reportes, además de una vía de escape genérica sobre toda la API de Matcher. Consulta Herramientas MCP de Matcher para ver el catálogo.