Saltar al contenido principal
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

Edita claude_desktop_config.json:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "manglai": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.manglai.io/sse",
        "--header",
        "Authorization:Bearer ${MANGLAI_TOKEN}"
      ],
      "env": {
        "MANGLAI_TOKEN": "tu_token_aqui"
      }
    }
  }
}

​
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

ToolDatos que devuelve
get_companiesLista de empresas
get_company_buildingsEdificios de una empresa
get_company_departmentsDepartamentos
get_company_year_configurationAños activos
get_consumptionsConsumos con filtros
get_consumptionDetalle de un consumo
get_consumptions_dashboardResumen de consumos
get_emissionsLista de emisiones
get_emissions_dashboardDashboard por scope/categoría
get_invoicesLista de facturas
get_invoiceDetalle de factura
get_invoices_dashboardResumen de facturas
get_vehiclesFlota de vehículos
get_vehicleDetalle de vehículo
get_vehicles_dashboardResumen de flota
get_employeesLista de empleados
get_employeeDetalle de empleado
get_business_travelsViajes de negocio
get_business_travels_dashboardDashboard de viajes
get_service_footprint_glecServicios logísticos GLEC
get_service_footprint_glec_dashboardDashboard GLEC
get_goalsObjetivos de reducción
get_tasksTareas de objetivos
get_scenariosEscenarios de proyección
get_categoriesCategorías GHG Protocol
get_emission_factorsFactores de emisión custom
get_recommended_inputsInputs recomendados
get_suppliersProveedores y clientes
get_waste_operatorsOperadores de residuos
get_usersUsuarios de la organización
El MCP de Manglai es de solo lectura. Para crear o modificar datos, usa 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