Cómo conectar CleverReach a Gemini vía MCP

💡 ¿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 + Gemini

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.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

CLEVERREACH_CLIENT_ID, CLEVERREACH_CLIENT_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos. Necesitas permisos de administrador en tu cuenta de CleverReach para crear una app OAuth.

1. En CleverReach abre Account, Extras, REST API y crea una app OAuth.
2. Selecciona los scopes Recipients (oa_receivers), Reports (oa_reports), Forms (oa_forms) y Emails (oa_mailings).
3. Registra la URL de redirección <your AnythingMCP URL>/api/mcp-oauth/callback. En AnythingMCP Cloud es https://cloud.anythingmcp.com/api/mcp-oauth/callback.
4. Copia el Client ID de la app en CLEVERREACH_CLIENT_ID y su Client Secret en CLEVERREACH_CLIENT_SECRET. Deja CLEVERREACH_REFRESH_TOKEN vacío e instala el conector.
5. 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.
6. 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.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de CleverReach.

Herramientas disponibles

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."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot