> ## 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 de Matcher

> Conecta asistentes de IA a Matcher mediante Model Context Protocol — una superficie de herramientas segura, con relay de token, sobre la conciliación.

El **servidor MCP de Matcher** expone la superficie de reconciliación de Matcher como herramientas del [Model Context Protocol](https://modelcontextprotocol.io), 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.

<Warning>
  Matcher solo está disponible si has adquirido el producto Matcher. ¿Quieres acceso? [Ponte en contacto con nuestro equipo](https://lerian.studio/contact) para saber más.
</Warning>

## 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:

```bash theme={null}
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`:

```bash theme={null}
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:

* **Bearer token para llamadas de API.** Las herramientas que despachan solicitudes a la API de Matcher fallan de forma cerrada sin un bearer token y reenvían la credencial proporcionada por el cliente sin registrarla, almacenarla ni repetirla.
* **Utilidades locales.** `mcp_ping`, `matcher_list_operations` y `matcher_describe_operation` se ejecutan localmente y no necesitan token. `mcp_whoami` no llama a Matcher, pero requiere una credencial bearer para informar que fue reenviada; sin ella devuelve un error de herramienta.
* **El tenant sigue al token en llamadas de API.** Ninguna herramienta que despacha a la API acepta un parámetro de tenant; Matcher resuelve el tenant desde el JWT reenviado.
* **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 `mcp_whoami` con una credencial bearer después de conectarte; la herramienta informa solo de que 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 un puente genérico para operaciones con cuerpos de solicitud JSON. Consulta [Herramientas MCP de Matcher](/es/matcher/mcp/matcher-mcp-tools) para ver el catálogo.