eminuxCRM/AGENTS.md

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:

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, update_organization_email, check_mail_bounces.
5. Per i bounce della casella mittente: check_mail_bounces (IMAP = stesse credenziali SMTP della MailIdentity).

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