eminuxandCursor
36b3ffe507
Permette di leggere i bounce dalla stessa MailIdentity SMTP, aggiornare le email in anagrafica e saltare gli indirizzi invalidi nei mailing. Co-authored-by: Cursor <cursoragent@cursor.com>
32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# 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`, `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.»*
|