Guía de integración MCP

El MCP (Model Context Protocol) de Manglai expone todos los datos de tu plataforma como herramientas invocables por tu agente de IA. Esta guía te lleva desde la configuración inicial hasta ejemplos de uso con cada área de datos.

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:

{
  "mcpServers": {
    "manglai": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.manglai.io/sse",
        "--header",
        "Authorization:Bearer ${MANGLAI_TOKEN}"
      ],
      "env": {
        "MANGLAI_TOKEN": "tu_token_aqui"
      }
    }
  }
}

Sustituye tu_token_aqui y reinicia Cursor. El MCP aparecerá disponible en el panel de herramientas.

Claude Desktop

Abre Configuración → Conectores → Agregar → Agregar conector personalizado

Completa los campos (pasa el cursor sobre cada valor para copiarlo):

Nombre

Manglai

URL del servidor MCP remoto

https://mcp.manglai.io/sse

OAuth Client ID — cualquier valor (recomendado: slug de tu empresa)

acme-corp

Secreto del cliente OAuth — tu token de API de Manglai

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:

"Lista mis empresas en Manglai"

El agente invocará get_companies y mostrará tus empresas. Si no responde, revisa el token y reinicia el agente.

Paso 4 — Consulta tus datos por área

Empresas y estructura organizativa

"¿Cuáles son mis empresas en Manglai?"
"¿Qué edificios tiene la empresa Acme S.L.?"
"¿Qué departamentos hay en la empresa con ID {companyId}?"
"¿Qué años tiene activos la empresa?"

Tools usadas: get_companies, get_company_buildings, get_company_departments, get_company_year_configuration

Emisiones — La consulta más importante

"¿Cuáles son mis emisiones de 2024 por scope?"
"Dame el desglose mensual de CO₂e del primer trimestre de 2024"
"¿Qué categoría genera más emisiones en mi empresa?"
"Compara mis emisiones de 2023 vs 2024"

Ejemplo de respuesta del agente:

Tus emisiones de 2024 totalizan 1.234 tCO₂e:

  Scope 1 (emisiones directas): 234 tCO₂e — 19%
    → Combustión de combustibles, flota propia

  Scope 2 (energía indirecta): 456 tCO₂e — 37%
    → Electricidad y calor comprado

  Scope 3 (cadena de valor): 544 tCO₂e — 44%
    → Logística, viajes de negocio, compras

Tools usadas: get_emissions, get_emissions_dashboard

Consumos energéticos

"¿Cuánta electricidad consumí en 2024?"
"Dame un resumen de consumos de gas natural por edificio"
"¿Qué edificio consume más energía?"
"Muestra los consumos de combustible de este año"

Tools usadas: get_consumptions, get_consumption, get_consumptions_dashboard

Facturas

"Lista las facturas de electricidad del último trimestre"
"¿Cuánto gasté en facturas de agua en 2024?"
"Dame el detalle de la factura con ID {invoiceId}"
"¿Cuál es el coste total de mis facturas de residuos?"

Tools usadas: get_invoices, get_invoice, get_invoices_dashboard

Flota de vehículos

"¿Cuántos vehículos tengo registrados?"
"¿Qué emisiones generó mi flota en 2024?"
"Dame el detalle del vehículo con matrícula 1234ABC"
"¿Qué vehículos son eléctricos?"

Tools usadas: get_vehicles, get_vehicle, get_vehicles_dashboard

Logística GLEC

"¿Cuántas toneladas de CO₂e generó mi logística en 2024?"
"Lista los servicios de transporte del cliente {clientId} en el primer semestre"
"¿Cuál es la huella logística por scope para el año 2024?"
"Dame el dashboard de logística GLEC de este año"

Tools usadas: get_service_footprint_glec, get_service_footprint_glec_dashboard

Viajes de negocio

"¿Cuántos viajes de negocio se registraron en 2024?"
"¿Qué medio de transporte genera más emisiones en los viajes corporativos?"
"Lista los viajes de negocio del empleado {employeeId}"
"Dame el dashboard de viajes de negocio de 2024"

Tools usadas: get_business_travels, get_business_travels_dashboard

Empleados

"¿Cuántos empleados tengo en Manglai?"
"Dame el detalle del empleado con ID {employeeId}"
"Lista los empleados de la empresa {companyId}"

Tools usadas: get_employees, get_employee

Objetivos de reducción

"¿Qué objetivos de reducción tengo activos?"
"Lista las tareas pendientes de mis objetivos"
"¿Cuántos escenarios de proyección tengo definidos?"
"¿Qué tareas tienen prioridad alta?"

Tools usadas: get_goals, get_tasks, get_scenarios

Datos de referencia

"¿Qué categorías GHG Protocol de Scope 3 tienes disponibles?"
"Lista mis factores de emisión personalizados"
"¿Qué proveedores de electricidad están disponibles en España?"
"Lista mis proveedores y clientes registrados"

Tools usadas: get_categories, get_emission_factors, get_recommended_inputs, get_suppliers, get_waste_operators, get_users

Referencia de todas las tools

Tool	Datos que devuelve
`get_companies`	Lista de empresas
`get_company_buildings`	Edificios de una empresa
`get_company_departments`	Departamentos
`get_company_year_configuration`	Años activos
`get_consumptions`	Consumos con filtros
`get_consumption`	Detalle de un consumo
`get_consumptions_dashboard`	Resumen de consumos
`get_emissions`	Lista de emisiones
`get_emissions_dashboard`	Dashboard por scope/categoría
`get_invoices`	Lista de facturas
`get_invoice`	Detalle de factura
`get_invoices_dashboard`	Resumen de facturas
`get_vehicles`	Flota de vehículos
`get_vehicle`	Detalle de vehículo
`get_vehicles_dashboard`	Resumen de flota
`get_employees`	Lista de empleados
`get_employee`	Detalle de empleado
`get_business_travels`	Viajes de negocio
`get_business_travels_dashboard`	Dashboard de viajes
`get_service_footprint_glec`	Servicios logísticos GLEC
`get_service_footprint_glec_dashboard`	Dashboard GLEC
`get_goals`	Objetivos de reducción
`get_tasks`	Tareas de objetivos
`get_scenarios`	Escenarios de proyección
`get_categories`	Categorías GHG Protocol
`get_emission_factors`	Factores de emisión custom
`get_recommended_inputs`	Inputs recomendados
`get_suppliers`	Proveedores y clientes
`get_waste_operators`	Operadores de residuos
`get_users`	Usuarios de la organización

El MCP de Manglai es de solo lectura. Para crear o modificar datos, usa la API REST.

Introducción

API REST

Guías de integración

Ejemplos

MCP (Model Context Protocol)

MCP Tools

Integraciones MCP

Paso 1 — Genera tu token

Paso 2 — Configura tu agente

Cursor

Claude Desktop

ChatGPT / Gemini

Paso 3 — Verifica la conexión

Paso 4 — Consulta tus datos por área

Empresas y estructura organizativa

Emisiones — La consulta más importante

Consumos energéticos

Facturas

Flota de vehículos

Logística GLEC

Viajes de negocio

Empleados

Objetivos de reducción

Datos de referencia

Referencia de todas las tools

Siguiente paso

Integración API REST

Tools por área

​Paso 1 — Genera tu token

​Paso 2 — Configura tu agente

​Cursor

​Claude Desktop

​ChatGPT / Gemini

​Paso 3 — Verifica la conexión

​Paso 4 — Consulta tus datos por área

​Empresas y estructura organizativa

​Emisiones — La consulta más importante

​Consumos energéticos

​Facturas

​Flota de vehículos

​Logística GLEC

​Viajes de negocio

​Empleados

​Objetivos de reducción

​Datos de referencia

​Referencia de todas las tools

​Siguiente paso

Integración API REST

Tools por área

Paso 1 — Genera tu token

Paso 2 — Configura tu agente

Cursor

Claude Desktop

ChatGPT / Gemini

Paso 3 — Verifica la conexión

Paso 4 — Consulta tus datos por área

Empresas y estructura organizativa

Emisiones — La consulta más importante

Consumos energéticos

Facturas

Flota de vehículos

Logística GLEC

Viajes de negocio

Empleados

Objetivos de reducción

Datos de referencia

Referencia de todas las tools

Siguiente paso