Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi CleverReach con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Email marketing con CleverReach dalla Germania: gruppi e destinatari con attributi, tag ed eventi, upsert in blocco, attivazione e mail di double opt-in, blacklist e bounce, bozze di mailing con anteprima e modelli, e report dei mailing inviati con aperture, clic e bounce. REST API v3 con OAuth; l'invio finale a una lista resta in CleverReach.
Prova a chiedere
Prompt di esempio per CleverReach
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → CleverReach, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
CleverReach
Email marketing con CleverReach dalla Germania: gruppi e destinatari con attributi, tag ed eventi, upsert in blocco, attivazione e mail di double opt-in, blacklist e bounce, bozze di mailing con anteprima e modelli, e report dei mailing inviati con aperture, clic e bounce. REST API v3 con OAuth; l'invio finale a una lista resta in CleverReach.
Setup
La configurazione richiede circa 10 minuti. Ti servono i diritti di amministratore nel tuo account CleverReach per creare un'app OAuth.
- In CleverReach apri Account, Extras, REST API e crea un'app OAuth.
- Seleziona gli scope Recipients (
oa_receivers), Reports (oa_reports), Forms (oa_forms) ed Emails (oa_mailings). - Registra l'URL di reindirizzamento
<your AnythingMCP URL>/api/mcp-oauth/callback. Su AnythingMCP Cloud èhttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - Copia il Client ID dell'app in
CLEVERREACH_CLIENT_IDe il Client Secret inCLEVERREACH_CLIENT_SECRET. Lascia vuotoCLEVERREACH_REFRESH_TOKENe installa il connettore. - Nella pagina del connettore clicca Authorize with Provider e accedi a CleverReach. Il refresh token viene compilato e salvato per te, e gli access token si rinnovano da soli.
- Esegui
cleverreach_whoami: mostra l'account a cui appartiene il token e conferma la connessione.
Cosa legge: i gruppi (liste di destinatari) con il numero di destinatari totali, attivi, inattivi e in bounce, e i loro filtri (segmenti); i destinatari di un gruppo con email, stato attivo, timestamp, fonte e attributi; un destinatario per id o email con attributi globali, tag, punti e stato di bounce, i gruppi in cui si trova e i suoi eventi da shop o app; destinatari in più gruppi trovati con un filtro temporaneo (non viene salvato nulla); tag e attributi (campi dati); la blacklist e i bounce per categoria (hardbounce, softbounce, blocked, delayed, spam); i moduli di iscrizione; i mailing per stato (finished, draft, waiting, running, automation) con contenuto e link; i tuoi modelli e i canali dei mailing; i report dei mailing inviati con aperture, clic, bounce, disiscrizioni, statistiche dettagliate per modalità (client, paesi, prime ore, link, conversioni e altro) e i destinatari che hanno aperto, cliccato, fatto bounce o si sono disiscritti.
Cosa scrive: gruppi con cleverreach_create_group e cleverreach_update_group; destinatari con cleverreach_create_receiver, cleverreach_upsert_receivers (molti insieme, abbinati per email, in blocchi di qualche centinaio), cleverreach_update_receiver, cleverreach_activate_receiver e cleverreach_deactivate_receiver (resta nel gruppo ma non riceve mailing); tag con cleverreach_add_receiver_tags e cleverreach_remove_receiver_tags; campi dati con cleverreach_create_attribute (globali, o per gruppo con group_id); la blacklist con cleverreach_add_to_blacklist e cleverreach_remove_from_blacklist; bozze di mailing con cleverreach_create_mailing e cleverreach_update_mailing, e invii di prova con cleverreach_send_mailing_preview, che accetta solo indirizzi email di utenti del tuo account CleverReach.
Double opt-in: l'AI crea il destinatario con registered impostato ad adesso e activated "0", poi chiama cleverreach_send_form_mail con tipo activate e l'id di un modulo da cleverreach_list_forms, passando doidata come prova del consenso. CleverReach attiva il destinatario quando viene cliccato il link. Senza registered e activated un nuovo destinatario è attivo subito, e per questo serve un consenso dimostrabile.
Consenso: i destinatari sono dati personali ai sensi del GDPR. L'AI aggiunge o attiva solo indirizzi con consenso documentato, ti mostra cosa cambierà e aspetta il tuo sì prima di ogni scrittura.
Disattivato all'installazione: cleverreach_delete_receiver, che elimina definitivamente un destinatario da un gruppo, ad esempio per una richiesta di cancellazione dei dati; il suo storico in quel gruppo va perso. Un amministratore del workspace lo attiva di proposito. Fino ad allora, disattivare il destinatario lo tiene fuori dai mailing.
Formati dei dati: gli id sono numeri inviati come stringhe. Gli strumenti sui destinatari accettano l'id del destinatario o l'indirizzo email. Gli orari (registered, activated, deactivated, stamp, date dei report) sono timestamp Unix in secondi; 0 significa non impostato. Un destinatario è attivo in un gruppo quando activated è impostato e deactivated è 0. global_attributes valgono in tutti i gruppi, attributes in un solo gruppo. I tag usano lettere, numeri, _ e -, con un prefisso di origine facoltativo prima di un punto, ad esempio shop.vip.
Paginazione: le pagine partono da 0. I destinatari accettano pagesize (fino a 5000) e page; i bounce arrivano fino a 500 per pagina; i mailing accettano limit e page (paginazione solo se state non è all). Una pagina più corta della dimensione di pagina è l'ultima.
Errori comuni: la risposta contiene un codice e un messaggio di errore. 401 indica che il token è scaduto o revocato: clicca di nuovo Authorize with Provider e verifica che Client ID e secret appartengano alla stessa app. 403 indica che all'app OAuth manca lo scope per quell'area: aggiungi Recipients, Reports, Forms o Emails all'app e autorizza di nuovo. 404 indica un id sconosciuto, o un indirizzo che non è in quel gruppo o non è in blacklist. 400 indica dati non validi, come un nome di attributo o un timestamp errato.
Il connettore non invia un mailing alla sua lista: CleverReach concede questa possibilità solo con uno scope aggiuntivo su richiesta, quindi l'invio finale lo avvii in CleverReach dopo aver controllato l'anteprima. Non elimina gruppi o mailing e non crea moduli o modelli.
Prerequisiti: CLEVERREACH_CLIENT_ID, CLEVERREACH_CLIENT_SECRET
Installazione locale del connettore
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Apri http://localhost:3000/connectors/store, scegli CleverReach e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
cleverreach_whoami | Information about the CleverReach account the token belongs to: client id, company, login and contact data |
cleverreach_list_groups | List the groups (receiver lists) of the account with id, name, description (receiver_info), locked and backup flags and last changes |
cleverreach_get_group | Get one group (receiver list) by id: name, receiver_info, locked, backup and timestamps |
cleverreach_get_group_stats | Counts of a group: total, active, inactive and bounced receivers, average points, quality and order figures |
cleverreach_create_group | Create a group (receiver list) with a name and optional description |
cleverreach_update_group | Rename a group or change its description, locked or backup flag |
cleverreach_list_group_filters | List the filters (segments) of a group with id, name, operator and rules |
cleverreach_list_group_receivers | List the receivers (subscribers) of a group with email, active flag, registered, activated and deactivated timestamps, source and attributes |
cleverreach_get_receiver | Get one receiver by id or email: global attributes, tags, points, bounce state |
cleverreach_find_receivers | Find receivers across groups with a temporary filter: rules on email, source, timestamps, points or attributes, combined with AND or OR |
cleverreach_list_receiver_groups | List the groups a receiver (id or email) is in, optionally only those where it is active or inactive |
cleverreach_list_receiver_events | List the events of a receiver (id or email): custom events added by shops or apps, with type, value and timestamp |
cleverreach_create_receiver | Add one receiver (subscriber) to a group with email, timestamps, source, attributes and tags |
cleverreach_update_receiver | Update a receiver in a group (by id or email): attributes, tags, source or timestamps |
cleverreach_upsert_receivers | Create or update many receivers of a group in one call, matched by email (send large lists in chunks of a few hundred) |
cleverreach_activate_receiver | Activate a receiver in a group (by id or email) so mailings reach it |
cleverreach_deactivate_receiver | Deactivate a receiver in a group (by id or email), e.g. after an unsubscribe request |
cleverreach_delete_receiver | Delete a receiver from a group for good, e.g. for a data erasure request; its history in that group is lost |
cleverreach_add_receiver_tags | Add tags to a receiver (id or email) |
cleverreach_remove_receiver_tags | Remove tags from a receiver (id or email): one tag, several comma-separated, or all tags of an origin with origin.* |
cleverreach_list_tags | List the tags used in the account with their origin and how many receivers carry them |
cleverreach_list_attributes | List receiver attributes (data fields): global ones, or with group_id the group-specific ones |
cleverreach_create_attribute | Create a receiver attribute (data field), global or for one group: name, type (text, number, gender, date), description, preview and… |
cleverreach_list_blacklist | List the account blacklist: addresses and patterns that never receive mailings, with comment and date |
cleverreach_get_blacklist_entry | Check whether an email address is on the blacklist and read its comment and date |
cleverreach_add_to_blacklist | Put an email address on the account blacklist so no mailing reaches it any more, with an optional comment (e.g. complaint by phone) |
cleverreach_remove_from_blacklist | Remove an email address from the blacklist so it can receive mailings again |
cleverreach_list_bounces | List bounces of the account: email, category (hardbounce, softbounce, blocked, delayed, spam), occurrences, bounce message, last update and… |
cleverreach_list_bounced_receivers | List receivers that have a bounce date, page by page, to clean up lists |
cleverreach_list_forms | List the signup forms of the account with id, name and group |
cleverreach_send_form_mail | Send the double opt-in (activate) or opt-out confirmation (deactivate) email of a form to a receiver already in the form's group |
cleverreach_list_mailings | List mailings by state (finished, draft, waiting, running, automation) with id, name, subject, sender and dates. start and end filter by… |
cleverreach_get_mailing | Get one mailing by id: name, subject, sender, HTML and text content, receivers (groups or filter), settings and state |
cleverreach_create_mailing | Create a mailing as a draft: name, subject, sender, HTML and text content, target groups or filter and tracking settings |
cleverreach_update_mailing | Update a draft mailing: name, subject, sender, content, receivers, settings or tags |
cleverreach_send_mailing_preview | Send a preview of a mailing to test addresses |
cleverreach_get_mailing_links | List the links in a mailing with their ids and URLs; link ids filter cleverreach_list_report_receivers by clicks |
cleverreach_list_templates | List the user's own mailing templates with id and name, to start a new mailing from a design |
cleverreach_list_mailing_channels | List mailing categories (channels) with id and name, used to group mailings and reports |
cleverreach_list_reports | List reports of sent mailings with sent count, opens, clicks, bounces, unsubscribes and send date |
cleverreach_get_report | Get the report of one sent mailing (same id as the mailing): recipients, opens, clicks, bounces, unsubscribes and rates |
cleverreach_get_report_stats | Detailed statistics of a report by mode: full, clients, mediaclients, countries, quality (bounces), firsthours, traffic, daily (with start… |
cleverreach_list_report_receivers | List the receivers of a report by state: sent, opened, clicked (optionally one link), notopened, notclicked, bounced or unsubscribed |
Esempi di prompt
- "Quanti destinatari attivi, inattivi e in bounce ha il gruppo Newsletter IT?"
- "Aggiungi [email protected] al gruppo Lead webinar con nome Max e mandagli la mail di double opt-in del nostro modulo di iscrizione."
- "Quali destinatari hanno cliccato il link ai prezzi nella newsletter della settimana scorsa? Elenca i loro indirizzi email."
- "Crea una bozza di mailing per il gruppo Clienti con oggetto "Le novità d'autunno" e invia un'anteprima al mio indirizzo."
- "Confronta i tassi di apertura e di clic delle ultime tre newsletter inviate."
Prossimi passi
Questa guida ti è stata utile?