# Mirlo para Claude

Conectá tu CRM de Mirlo con Claude para consultar y gestionar oportunidades, contactos, tickets y tareas usando lenguaje natural.

## ¿Qué puedo hacer?

Preguntale a Claude cosas como:

- *"¿Cuántos deals abiertos tengo arriba de $100k?"*
- *"Creame un ticket de soporte con prioridad alta"*
- *"¿Qué tareas tengo vencidas?"*
- *"Dame los contactos de la empresa Farmacias del Ahorro"*
- *"¿Cuáles oportunidades cierran esta semana?"*
- *"Creá una tarea para llamar al cliente mañana"*

---

## Configuración paso a paso

### Paso 1: Obtené tu API Key de Mirlo

1. Ingresá a [app.mirlo.com](https://app.mirlo.com)
2. Andá a **Mi Organización** → **API Keys**
3. Hacé click en **+ Crear API Key**
4. Copiá la key (empieza con `sk_live_`)

### Paso 2: Instalá Node.js (si no lo tenés)

Descargá e instalá Node.js desde [nodejs.org](https://nodejs.org). Elegí la versión LTS (recomendada).

Para verificar que está instalado, abrí la Terminal y escribí:
```
node --version
```
Debería mostrar algo como `v22.x.x`.

### Paso 3: Configurá Claude Desktop

1. Abrí **Claude Desktop**
2. Andá a **Settings** (Configuración) → **Developer** → **Edit Config**
3. Se abre un archivo. Reemplazá el contenido con:

```json
{
  "mcpServers": {
    "mirlo": {
      "command": "npx",
      "args": ["-y", "@mirlo/mcp", "--api-key=TU_API_KEY_AQUI"]
    }
  }
}
```

4. Reemplazá `TU_API_KEY_AQUI` con tu API key de Mirlo (la que copiaste en el Paso 1)
5. Guardá el archivo y **reiniciá Claude Desktop**

### Paso 4: ¡Listo!

Abrí una nueva conversación en Claude y preguntá algo sobre tu CRM:

> *"¿Cuántos tickets abiertos tengo?"*

Claude va a usar las herramientas de Mirlo automáticamente para responder.

---

## Configuración con Claude Code (CLI)

Si usás Claude Code en la terminal:

```bash
# Agregar el MCP server
claude mcp add mirlo npx -y @mirlo/mcp --api-key=sk_live_xxx
```

---

## ¿Qué puede hacer?

### CRM — Oportunidades
| Acción | Ejemplo |
|--------|---------|
| Listar deals | *"Dame las oportunidades abiertas ordenadas por monto"* |
| Buscar deals | *"¿Hay deals que cierran esta semana?"* |
| Crear deal | *"Creá una oportunidad para Acme Corp por $50,000"* |
| Mover de etapa | *"Mové el deal de Acme a Negociación"* |
| Filtrar por tiempo | *"¿Qué deals llevan más de 24 horas en Prospecto?"* |

### CRM — Contactos y Cuentas
| Acción | Ejemplo |
|--------|---------|
| Buscar contactos | *"Buscame los contactos de la empresa Café Digital"* |
| Crear contacto | *"Creá un contacto: Ana García, ana@empresa.com"* |
| Listar cuentas | *"¿Qué cuentas tenemos en la industria Tecnología?"* |

### CRM — Tickets
| Acción | Ejemplo |
|--------|---------|
| Ver tickets abiertos | *"¿Cuántos tickets abiertos hay?"* |
| Crear ticket | *"Creá un ticket urgente: Error en la integración"* |
| Filtrar por prioridad | *"Mostrá los tickets de prioridad alta"* |

### CRM — Tareas
| Acción | Ejemplo |
|--------|---------|
| Ver tareas pendientes | *"¿Qué tareas tengo para hoy?"* |
| Tareas vencidas | *"¿Hay tareas vencidas?"* |
| Crear tarea | *"Creá una tarea para llamar a Ana García mañana"* |
| Completar tarea | *"Marcá como completada la tarea de llamar a Ana"* |

### Messaging
| Acción | Ejemplo |
|--------|---------|
| Enviar mensaje | *"Mandá un WhatsApp a +52 55 1234 5678 diciendo: Hola, te contacto de Mirlo"* |
| Ver conversaciones | *"Mostrá las últimas conversaciones"* |

### Voz
| Acción | Ejemplo |
|--------|---------|
| Ver llamadas | *"¿Cuántas llamadas entrantes hubo hoy?"* |
| Transcripción | *"Dame la transcripción de la última llamada"* |

---

## Solución de problemas

### "Claude no encuentra las herramientas de Mirlo"
- Verificá que reiniciaste Claude Desktop después de editar la configuración
- Verificá que tu API Key es válida en [app.mirlo.com](https://app.mirlo.com) → API Keys

### "Error de autenticación"
- Tu API Key puede haber expirado. Generá una nueva en Mi Organización → API Keys

### "npx no se encuentra"
- Instalá Node.js desde [nodejs.org](https://nodejs.org)

---

## Soporte

¿Necesitás ayuda? Contactanos en [mirlo.com](https://mirlo.com) o por WhatsApp.

---

## Para desarrolladores

### Instalación manual

```bash
npm install -g @mirlo/mcp
mirlo-mcp --api-key=sk_live_xxx
```

### Variables de entorno

```bash
MIRLO_API_KEY=sk_live_xxx    # API key (requerida)
MIRLO_BASE_URL=https://...   # URL base (opcional, default: api.mirlo.com)
```

### Herramientas disponibles (21 tools)

**CRM:** `mirlo_list_deals`, `mirlo_get_deal`, `mirlo_create_deal`, `mirlo_update_deal`, `mirlo_move_deal_stage`, `mirlo_list_contacts`, `mirlo_get_contact`, `mirlo_create_contact`, `mirlo_list_accounts`, `mirlo_create_account`, `mirlo_list_tickets`, `mirlo_create_ticket`, `mirlo_list_tasks`, `mirlo_create_task`, `mirlo_complete_task`, `mirlo_list_pipelines`

**Messaging:** `mirlo_send_message`, `mirlo_send_template`, `mirlo_list_conversations`

**Voice:** `mirlo_list_calls`, `mirlo_get_call_transcript`

## Licencia

MIT