> ## 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 el Model Context Protocol, una superficie de herramientas segura y con retransmisión de token sobre el motor de conciliación.

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

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

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

```bash theme={null}
claude mcp add --transport http matcher https://your-matcher-mcp.example.com/mcp \
  --header "Authorization: Bearer <matcher-jwt>"
```

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

```bash theme={null}
MATCHER_API_URL=https://your-matcher-api npx @lerianstudio/matcher-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](/es/products/matcher/mcp/matcher-mcp-tools) para ver el catálogo.