Espone API JSON e MCP HTTP per far lavorare gli agenti sul CRM.

Gli agenti autenticati con token Bearer possono leggere today/pipeline e annotare attività, con host MCP allineati a quelli di produzione.

Co-authored-by: Cursor <cursoragent@cursor.com>

AGENTS.md

@@ -0,0 +1,30 @@
+# 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.»*