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 + Microsoft Copilot
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.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
CLEVERREACH_CLIENT_ID, CLEVERREACH_CLIENT_SECRET
Step 1 — Ottieni le credenziali
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.
Step 2 — Installa l'adapter
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
Step 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
CleverReach. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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."
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?