Files
eminuxCRM/AGENTS.md
T
eminuxandCursor 936930e691 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>
2026-09-02 22:43:46 +02:00

1.5 KiB
Raw Blame History

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