MCP (Model Context Protocol)

El Model Context Protocol (MCP) es un estándar abierto que permite a las consolas de agentes IA (Claude Code, Cursor, OpenCode, entre otras) conectarse de forma segura a sistemas externos y usar sus capacidades como herramientas.

Con la integración MCP de Gestia, tu agente IA preferido puede consultar y operar tu ERP directamente: leer clientes, revisar inventario, crear ventas, consultar contabilidad, gestionar tickets y mucho más — todo desde el chat de tu consola, con permisos explícitos que tú controlas.

¿Cómo funciona con Gestia?

1. Gestia expone un servidor MCP en https://app.gestia.lat/mcp.
2. Tu consola de agente se autentica con OAuth2 Authorization Code + PKCE (flujo estándar de MCP): no compartes contraseñas, solo emites tokens temporales con scopes limitados.
3. Una vez conectada, la consola descubre automáticamente las herramientas disponibles (una por operación de cada dominio) y las ofrece a tu agente.
4. Cada llamada se ejecuta con los permisos del usuario que autorizó la conexión y queda registrada en la auditoría del sistema.

Quickstart (3 pasos)

1. Genera tus credenciales

Inicia sesión en Gestia y ve a Configuración > Agentes (MCP). Crea una aplicación MCP y anota el client_id y el client_secret. Marca los dominios y scopes que tu agente podrá usar.

2. Configura tu cliente MCP

Agrega el servidor MCP en tu consola de agente apuntando al endpoint OAuth:

{
  "mcpServers": {
    "gestia": {
      "type": "oauth",
      "url": "https://app.gestia.lat/mcp",
      "clientId": "tu_client_id",
      "clientSecret": "tu_client_secret",
      "scopes": ["crm:read", "sales:write", "inventory:read"]
    }
  }
}

3. Empieza a usar las herramientas

Autoriza la conexión en el navegador (flujo OAuth) y listo: tu agente ya puede consultar y operar tu ERP. Ejemplo de petición:

"Consulta el stock de la bodega principal y crea una orden de compra
para reponer los productos con menos de 10 unidades."

Dominios y herramientas

Dominio	Herramientas principales
crm	Clientes, contactos, pipeline comercial, interacciones
inventory	Productos, categorías, bodegas, proveedores, kardex, traslados
sales	Cotizaciones, facturas, pagos, notas crédito/débito, retenciones
accounting	Plan de cuentas, asientos, gastos, reportes financieros
hr	Empleados, nómina, prestaciones, ausencias, contratos
requests	Tickets, comentarios, plantillas de respuesta, base de conocimiento
assets	Activos fijos, mantenimientos, componentes, licencias
purchases	Órdenes de compra, facturas de proveedor, cuentas por pagar
email	Correos, plantillas, adjuntos

Scopes y permisos

Cada dominio expone dos scopes:

Scope	Permiso
{domain}:read	Leer datos del dominio
{domain}:write	Leer, crear y modificar datos del dominio

Solicita siempre el menor privilegio necesario para tu caso de uso. Por ejemplo, un agente de soporte solo necesita requests:read para revisar tickets, sin acceso de escritura.

Límites de uso

• Rate limit: 60 requests/min por conexión.
• Tokens: los access tokens expiran; el cliente MCP los renueva de forma transparente con el refresh token.

Clientes compatibles

• Claude Code — agrega el servidor MCP en tu configuración de Claude.
• Cursor — soporta servidores MCP OAuth en su configuración.
• OpenCode — define el servidor en opencode.json bajo mcp.servers.

Consulta el API Reference para el detalle exacto de cada herramienta y su scope.