> ## Documentation Index
> Fetch the complete documentation index at: https://developers.manglai.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Guía de integración MCP
> Conecta Claude, Cursor, ChatGPT o Gemini a tus datos de Manglai y consúltalos en lenguaje natural
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](https://www.manglai.io/saas/settings/api-tokens/docs#models) 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:
```json theme={null}
{
"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`
```json theme={null}
{
"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:
* [Integración con Claude →](/mcp/es/integrations/claude)
* [Integración con ChatGPT →](/mcp/es/integrations/chatgpt)
* [Integración con Gemini →](/mcp/es/integrations/gemini)
***
## 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](/guides/integrate-api).
## Siguiente paso
Guía completa para crear y sincronizar datos vía API
Referencia detallada de cada tool MCP disponible