Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade CleverReach con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Email marketing con CleverReach desde Alemania: grupos y destinatarios con atributos, etiquetas y eventos, upserts masivos, activación y correos de doble opt-in, lista negra y rebotes, borradores de mailing con vista previa y plantillas, e informes de mailings enviados con aperturas, clics y rebotes. REST API v3 con OAuth; el envío final a una lista se hace en CleverReach.
Prueba a pedir
Prompts de ejemplo para CleverReach
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → CleverReach, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
CleverReach
Email marketing con CleverReach desde Alemania: grupos y destinatarios con atributos, etiquetas y eventos, upserts masivos, activación y correos de doble opt-in, lista negra y rebotes, borradores de mailing con vista previa y plantillas, e informes de mailings enviados con aperturas, clics y rebotes. REST API v3 con OAuth; el envío final a una lista se hace en CleverReach.
Configuración
La configuración lleva unos 10 minutos. Necesitas permisos de administrador en tu cuenta de CleverReach para crear una app OAuth.
- En CleverReach abre Account, Extras, REST API y crea una app OAuth.
- Selecciona los scopes Recipients (
oa_receivers), Reports (oa_reports), Forms (oa_forms) y Emails (oa_mailings). - Registra la URL de redirección
<your AnythingMCP URL>/api/mcp-oauth/callback. En AnythingMCP Cloud eshttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - Copia el Client ID de la app en
CLEVERREACH_CLIENT_IDy su Client Secret enCLEVERREACH_CLIENT_SECRET. DejaCLEVERREACH_REFRESH_TOKENvacío e instala el conector. - En la página del conector haz clic en Authorize with Provider e inicia sesión en CleverReach. El refresh token se rellena y se guarda por ti, y los access tokens se renuevan solos.
- Ejecuta
cleverreach_whoami: muestra la cuenta a la que pertenece el token y confirma la conexión.
Qué lee: grupos (listas de destinatarios) con el número de destinatarios totales, activos, inactivos y rebotados, y sus filtros (segmentos); los destinatarios de un grupo con email, estado activo, marcas de tiempo, origen y atributos; un destinatario por id o email con atributos globales, etiquetas, puntos y estado de rebote, los grupos en los que está y sus eventos de tiendas o apps; destinatarios de varios grupos encontrados con un filtro temporal (no se guarda nada); etiquetas y atributos (campos de datos); la lista negra y los rebotes por categoría (hardbounce, softbounce, blocked, delayed, spam); formularios de alta; mailings por estado (finished, draft, waiting, running, automation) con contenido y enlaces; tus propias plantillas y canales de mailing; informes de mailings enviados con aperturas, clics, rebotes, bajas, estadísticas detalladas por modo (clientes, países, primeras horas, enlaces, conversión y más) y los destinatarios que abrieron, hicieron clic, rebotaron o se dieron de baja.
Qué escribe: grupos con cleverreach_create_group y cleverreach_update_group; destinatarios con cleverreach_create_receiver, cleverreach_upsert_receivers (muchos a la vez, emparejados por email, en bloques de unos cientos), cleverreach_update_receiver, cleverreach_activate_receiver y cleverreach_deactivate_receiver (sigue en el grupo pero no recibe mailings); etiquetas con cleverreach_add_receiver_tags y cleverreach_remove_receiver_tags; campos de datos con cleverreach_create_attribute (globales, o por grupo con group_id); la lista negra con cleverreach_add_to_blacklist y cleverreach_remove_from_blacklist; borradores de mailing con cleverreach_create_mailing y cleverreach_update_mailing, y envíos de prueba con cleverreach_send_mailing_preview, que solo acepta direcciones de usuarios de tu cuenta de CleverReach.
Doble opt-in: la IA crea el destinatario con registered en este momento y activated "0", y después llama a cleverreach_send_form_mail con el tipo activate y el id de un formulario de cleverreach_list_forms, pasando doidata como prueba del consentimiento. CleverReach activa al destinatario cuando hace clic en el enlace. Sin registered ni activated, un destinatario nuevo queda activo al momento, y para eso necesitas un consentimiento que puedas demostrar.
Consentimiento: los destinatarios son datos personales según el RGPD. La IA solo añade o activa direcciones con consentimiento documentado, te muestra qué va a cambiar y espera tu sí antes de cualquier escritura.
Desactivada al instalar: cleverreach_delete_receiver, que borra definitivamente a un destinatario de un grupo, por ejemplo ante una solicitud de supresión de datos; su historial en ese grupo se pierde. Un administrador del workspace la activa a propósito. Mientras tanto, desactivar al destinatario lo deja fuera de los mailings.
Formatos de datos: los ids son números enviados como cadenas. Las herramientas de destinatarios aceptan el id del destinatario o la dirección de email. Las horas (registered, activated, deactivated, stamp, fechas de informes) son marcas de tiempo Unix en segundos; 0 significa sin valor. Un destinatario está activo en un grupo cuando activated tiene valor y deactivated es 0. global_attributes se aplican en todos los grupos, attributes en uno. Las etiquetas usan letras, números, _ y -, con un prefijo de origen opcional antes de un punto, como shop.vip.
Paginación: las páginas empiezan en 0. Los destinatarios aceptan pagesize (hasta 5000) y page; los rebotes llegan hasta 500 por página; los mailings aceptan limit y page (solo se pagina cuando state no es all). Una página más corta que el tamaño de página es la última.
Errores comunes: la respuesta incluye un código y un mensaje de error. 401 indica que el token caducó o se revocó: vuelve a hacer clic en Authorize with Provider y comprueba que Client ID y secret son de la misma app. 403 indica que a la app OAuth le falta el scope de esa área: añade Recipients, Reports, Forms o Emails a la app y vuelve a autorizar. 404 indica un id desconocido, o una dirección que no está en ese grupo o no está en la lista negra. 400 indica datos no válidos, como un nombre de atributo o una marca de tiempo incorrectos.
El conector no envía un mailing a su lista: CleverReach solo lo permite con un scope adicional bajo petición, así que el envío final lo lanzas tú en CleverReach después de revisar la vista previa. No borra grupos ni mailings y no crea formularios ni plantillas.
Requisitos previos: CLEVERREACH_CLIENT_ID, CLEVERREACH_CLIENT_SECRET
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige CleverReach e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| 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 |
Ejemplos de prompts
- "¿Cuántos destinatarios activos, inactivos y rebotados tiene el grupo Newsletter ES?"
- "Añade [email protected] al grupo Leads del webinar con el nombre Max y envíale el correo de doble opt-in de nuestro formulario de alta."
- "¿Qué destinatarios hicieron clic en el enlace de precios de la newsletter de la semana pasada? Lista sus emails."
- "Crea un borrador de mailing para el grupo Clientes con el asunto "Novedades de otoño" y envía una vista previa a mi dirección."
- "Compara las tasas de apertura y de clic de las tres últimas newsletters enviadas."
Siguientes pasos
¿Te ha sido útil esta guía?