Skip to main content
El MCP (Model Context Protocol) de Manglai expone el catálogo de tools de dominio de tu empresa. Esta guía te lleva desde la configuración inicial hasta ejemplos de uso por área.

Paso 1 — Genera tu token

Dirígete a Manglai → Ajustes → API Tokens y crea un token de acceso personal. Guárdalo en un lugar seguro.

Paso 2 — Configura tu agente

Cursor

Edita o crea el archivo .cursor/mcp.json en la raíz de tu proyecto:
Sustituye tu_token_aqui y reinicia Cursor. El MCP aparecerá disponible en el panel de herramientas.

Claude Desktop

  1. Abre Configuración → Conectores → Agregar → Agregar conector personalizado
Modal Agregar conector personalizado en Claude Desktop
  1. Completa los campos (pasa el cursor sobre cada valor para copiarlo):
Nombre
URL del servidor MCP remoto
OAuth Client ID — cualquier valor (recomendado: slug de tu empresa)
Secreto del cliente OAuth — tu token de API de Manglai
  1. Pulsa Agregar y autoriza.
Detalle completo: Integración con Claude →

ChatGPT / Gemini

Consulta las guías específicas de cada integración:

Paso 3 — Verifica la conexión

Una vez configurado, abre un chat y prueba:
El agente invocará list_buildings y mostrará tus instalaciones. Si no responde, revisa el token y reinicia el agente.

Paso 4 — Consulta tus datos por área

Inventario

Tools usadas: list_buildings, list_vehicles, upsert_building, upsert_vehicle Las escrituras piden preview (userConfirmed: false) y luego confirmación (userConfirmed: true).

Emisiones — La consulta más importante

Ejemplo de respuesta del agente:
Tools usadas: get_emissions_summary, list_emissions

Consumos, facturas y viajes

Tools usadas: list_consumptions, get_invoice_summary, get_electricity_by_cup, get_business_travel_summary, list_purchases_goods_and_services

Informes y alertas

Tools usadas: list_reports, get_report, list_invoice_alerts

Factores de emisión

Tools usadas: list_custom_emission_factors, get_available_emission_factors

Referencia de tools

La lista completa está en Tools disponibles. Nombres en snake_case (list_buildings, get_emissions_summary, upsert_vehicle). Las tools de acción requieren userConfirmed.
Las tools de datos son de lectura. Las de acción (crear o actualizar inventario, facturas, encuestas o informes) exigen confirmación explícita. También puedes usar la API REST.

Siguiente paso

Integración API REST

Guía completa para crear y sincronizar datos vía API

Tools por área

Referencia detallada de cada tool MCP disponible