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>
1.5 KiB
1.5 KiB
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
- Il CRM deve essere avviato (
docker compose up, porta 3001). - Crea un token in UI: Token API (menu utente).
- 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
list_projects— ottieni iproject_code(matchlivetv, riskmeter, cardoo, …).todaycon quel codice — task scaduti / oggi / in arrivo e opportunità ferme.searchoget_organizationper il contesto.- 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.»