# eminuxCRM — istruzioni per agenti (Cursor CLI, Claude Code, Codex)

Quando l'utente chiede di **interagire con il CRM**, lavorare su prospect, pipeline, task, follow-up o "cosa fare oggi", usa i tool MCP **eminuxcrm**. Non usare `curl` sull'API se i tool sono disponibili.

## Come collegarti

1. Il CRM deve essere avviato (`docker compose up`, porta **3001**).
2. Crea un token in UI: **Token API** (menu utente).
3. Esporta il token **prima** di lanciare l'agente:

```bash
export CRM_API_TOKEN='crm_…'
```

Endpoint MCP: `http://localhost:3001/mcp` (Bearer). In produzione usa l’URL pubblico del CRM (`https://<host>/mcp`). Config già nel repo: `.cursor/mcp.json` (Cursor / Cursor CLI) e `.mcp.json` (Claude Code). Per il CRM in LAN/produzione cambia `url` e tieni il token in `CRM_API_TOKEN`.

## Flusso di lavoro

1. `list_projects` — ottieni i `project_code` (matchlivetv, riskmeter, cardoo, …).
2. `today` con quel codice — task scaduti / oggi / in arrivo e opportunità ferme.
3. `search` o `get_organization` per il contesto.
4. Agisci con `create_activity`, `complete_task`, `create_task`, `update_opportunity_stage`.

## Limiti

- Non inviare mailing, non cancellare record, non gestire utenti o SMTP.
- Restai nello scope dei progetti abilitati per il token.
- Annota sempre in timeline (`create_activity`) quello che fai, così l'utente lo vede in scheda.

Frase tipo: *«Interagisci col CRM su MatchLiveTV: dimmi cosa c'è da fare oggi e completa i follow-up ovvi.»*