> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watahub.dev/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](https://docs.watahub.dev/api/introduccion.md) 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](https://docs.watahub.dev/mcp/inventario.md) — `inventory:read`
* [Conversaciones](https://docs.watahub.dev/mcp/conversaciones.md) — `conversations:read`
* [Negocios](https://docs.watahub.dev/mcp/negocios.md) — `opportunities:read`
* [Tesorería](https://docs.watahub.dev/mcp/tesoreria.md) — `treasury:read`
* [Reportes](https://docs.watahub.dev/mcp/reportes.md) — `reports:read`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.