> ## 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.

# Quickstart

> Configura tu primera llamada a la API de Manglai en minutos

## 1. Genera tu token

Dirígete a [Generar token](https://www.manglai.io/saas/settings/api-tokens/docs#models) y crea un token de acceso. Guárdalo en un lugar seguro.

## 2. Llama a la API

### Obtener empresas

```bash theme={null}
curl -X GET "https://www.manglai.io/api/v1/companies" \
  -H "Authorization: Bearer TU_TOKEN_AQUI"
```

### Obtener edificios de una empresa

```bash theme={null}
curl -X GET "https://www.manglai.io/api/v1/companies/{companyId}/buildings?companyId={companyId}" \
  -H "Authorization: Bearer TU_TOKEN_AQUI"
```

### Crear un consumo

```bash theme={null}
curl -X POST "https://www.manglai.io/api/v1/consumptions" \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "entityId": "invoice-123-abc",
    "categoryId": "668f3fcb-7fb0-4b65-b77d-9303c551632f",
    "startDate": "2024-01-01T00:00:00.000Z",
    "endDate": "2024-01-31T23:59:59.999Z",
    "companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
    "buildingId": "7fef7760-f9e7-4de9-ae35-8c37db65e4a3",
    "quantity": 1500.5,
    "unitType": "kWh"
  }'
```

## 3. Usar el MCP (opcional)

Si quieres integrar con ChatGPT, Claude, Gemini o Cursor, consulta la [Guía de MCP](/mcp/intro).