> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conector MCP

> Lee Yampi desde un agente: OAuth, scopes de solo lectura y 28 tools.

El conector MCP de Yampi deja que un agente **lea** el dominio de tu inmobiliaria: inventario, bandejas, negocios, tesorería y reportes. No escribe. Si necesita mutar datos, usa la [API de cuenta](/api/introduccion) con `api_access_token`.

Piensa el conector como una ventana controlada al mismo dato que ve el equipo en Yampi — con scopes que tú otorgas.

## Autenticación

El conector usa **OAuth Bearer** (Doorkeeper). No envíes `api_access_token` al host MCP: ese header es de la API de cuenta.

Otorgas solo los scopes que el cliente necesita. Ninguno viene activo por defecto.

## Scopes

| Scope                | Qué abre                                                     |
| -------------------- | ------------------------------------------------------------ |
| `inventory:read`     | Propiedades y ubicaciones                                    |
| `conversations:read` | Conversaciones que necesitan atención y su contexto          |
| `opportunities:read` | Negocios quietos                                             |
| `treasury:read`      | Cartera, mora, comisiones, liquidación, garantías            |
| `reports:read`       | Reportes agregados (servicio, comercial, captación, agenda…) |

`tools/list` solo muestra las tools cuyo scope tienes: el modelo elige entre lo que puede llamar.

## Dónde vive

* Conector en el host MCP de Yampi (OAuth + consent en la app).
* También `POST /api/v1/accounts/{account_id}/mcp` en la API de cuenta (feature `mcp_server`), autenticado con `api_access_token`.

## Privacidad

Varias tools omiten a propósito teléfonos, emails, direcciones exactas y el texto de los mensajes del contacto. Devuelven lo que un agente necesita para operar sin filtrar datos sensibles de más.

## Tools por familia

* [Inventario](/mcp/inventario) — `inventory:read`
* [Conversaciones](/mcp/conversaciones) — `conversations:read`
* [Negocios](/mcp/negocios) — `opportunities:read`
* [Tesorería](/mcp/tesoreria) — `treasury:read`
* [Reportes](/mcp/reportes) — `reports:read`