Cómo conectar Iterable a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Iterable, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Iterable + Cursor

Haz que tu IA trabaje con Iterable: consulta usuarios con sus eventos y mensajes, revisa listas, campañas y sus métricas, plantillas y catálogos, actualiza perfiles, registra eventos, gestiona la pertenencia a listas y envía un email triggered después de que confirmes.

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:

ITERABLE_API_URL, ITERABLE_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas un usuario de Iterable que pueda crear API keys en el proyecto y saber si el proyecto está alojado en EE. UU. o en la UE.

1. En Iterable, abre Integrations → API Keys en los ajustes del proyecto y pulsa New API Key. Elige una clave Server-side si la IA debe leer y escribir, o Read-only si solo debe leer. Las claves JavaScript y Mobile no sirven aquí.
2. Copia la clave y pégala en ITERABLE_API_KEY. Cada clave pertenece a un solo proyecto, así que un conector trabaja con un proyecto de Iterable. La clave solo se envía a Iterable, en la cabecera Api-Key.
3. Pon en ITERABLE_API_URL el centro de datos del proyecto: https://api.iterable.com para proyectos en EE. UU., https://api.eu.iterable.com para proyectos en la UE (los que abres en app.eu.iterable.com), sin /api ni otra ruta.
4. Instala el conector y empieza con iterable_list_channels: comprueba la clave y muestra los canales de marketing y transaccionales del proyecto.

Una clave para todo el proyecto: la clave actúa en nombre del proyecto, no de una persona. Quien use este conector ve todos los usuarios y campañas que la clave puede leer, así que comparte el servidor MCP solo con quien pueda verlos.

Qué cubre: perfiles de usuario por email o userId con todos sus campos, sus eventos más recientes (eventos propios, compras, envíos, aperturas, clics, rebotes, bajas) y los mensajes que recibieron; listas con su tamaño y sus miembros; campañas con sus detalles y métricas; plantillas, canales, tipos de mensaje, catálogos y sus elementos. Las métricas llegan como tabla, una fila por campaña, con envíos, entregas, aperturas y clics únicos, rebotes, quejas, bajas, compras e ingresos.

Los cambios esperan tu sí: la IA muestra lo que va a escribir y espera tu confirmación antes de cada cambio.

• iterable_update_user fusiona campos en un perfil. Los campos cambiados pueden mover al usuario a listas dinámicas e iniciar journeys.
• iterable_track_event registra un evento propio, como un alta o una reserva, que también puede iniciar un journey.
• iterable_subscribe_to_list y iterable_unsubscribe_from_list cambian la pertenencia a listas. Dar de baja con la opción de canal equivale a una baja global de ese canal.
• iterable_send_email envía un email real de una campaña triggered a una persona, ahora o a una hora fijada. Los envíos a muchas personas siguen siendo campañas en Iterable.

Desactivadas al instalar: iterable_delete_user_by_email e iterable_delete_user_by_user_id borran perfiles y sus datos para siempre. Un administrador solo las activa a propósito. Con una clave Read-only, cada escritura responde 403; para un uso de solo lectura, desactiva las herramientas de escritura.

Email o userId: según el proyecto sea por email, por userID o híbrido, la IA identifica a un usuario por email o por userId, nunca con los dos en la misma llamada. Las horas en las respuestas son milisegundos epoch.

Límites por proyecto: la mayoría de lecturas 100 llamadas por segundo, métricas de campañas 10 por minuto, tamaño y miembros de listas 5 por minuto, mensajes enviados 3 por segundo. Los miembros de listas grandes se cortan en unos 100 KB; la IA mira antes el tamaño de la lista.

Errores habituales: 401 "Invalid API key" significa que la clave es incorrecta o se borró, es una clave JavaScript o Mobile, o es del otro centro de datos; revisa ITERABLE_API_URL. 400 con un código como BadParams o RequestFieldsTypesMismatched: un parámetro o el tipo de un campo es incorrecto, y el mensaje dice cuál. 404 o NotFound: el usuario, la lista o la campaña no existe en este proyecto. 429: se alcanzó un límite; espera y vuelve a intentarlo.

El conector no lanza trabajos de exportación ni usa endpoints bulk, no edita plantillas ni snippets, no gestiona experimentos ni journeys, no envía mensajes in-app, push, SMS ni web push, no cambia suscripciones por tipo de mensaje y no modifica catálogos.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Iterable.

Herramientas disponibles

Ejemplos de prompts

• "Busca [email protected] en Iterable: los campos de su perfil, sus últimos 20 eventos y las campañas que le enviaron un email este mes."
• "Compara en una tabla envíos, aperturas únicas, clics únicos y bajas de nuestras últimas cinco campañas blast."
• "¿Cuántos usuarios hay en la lista VIP Newsletter y qué plantillas usa la campaña Welcome?"
• "Añade [email protected] a la lista Beta testers y registra para él un evento beta_signup, pero antes enséñame qué vas a escribir."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT