Documentación — Conecta Ecom Magic AI con tu IA

Genera anuncios, landings, logos, mockups, investigación, espionaje de anuncios y análisis financiero desde Claude, ChatGPT, Codex, Cursor o cualquier cliente compatible con MCP.

URL del servidor MCP (pégala en tu cliente de IA)

https://ecom-magic.ai/mcp/v1

Clientes validados con esta URL: Claude.ai, Claude Desktop, Claude Code y Codex (Cursor y ChatGPT son compatibles, aún sin validar). En Claude o ChatGPT: Configuración → Conectores → Agregar conector personalizado → pega la URL → inicia sesión en Ecom Magic y autoriza. En Claude Code: claude mcp add --transport http ecom-magic <URL>. En Codex: codex mcp add ecom-magic --url <URL> y luego codex mcp login ecom-magic. En Cursor: agrega el servidor con la URL y haz clic en Autenticar. Luego pídele a tu IA que genere anuncios, landings, etc.

Cómo funciona

Conceptos clave: conexión, jobs asíncronos, créditos e imágenes.

  • Asíncrono + polling Generar, traducir, redimensionar e investigar devuelven un job_id. Consulta jobs_get cada 3-5 s hasta status='succeeded' (output trae la URL/datos) o 'failed'.
  • Créditos Generar/traducir/redimensionar/editar cuesta 1 crédito por pieza. Investigación de producto 3-6 según modelo; ángulos y avatar 3-6. Espionaje: gratis con suscripción mensual, mentores y admin; prepago y prueba pagan 1 por búsqueda nueva (paginar no cobra). Masivos de anuncios/landings: 1 por pieza, hasta el tope vigente (máx. 50). Palabra clave 1. Competencia 20 (al completar). Video: traducir 1 crédito por cada 10s POR idioma; transcribir 1. El análisis financiero, research_generic_angle, las lecturas (list/get/download) y traducir el texto transcrito son gratis.
  • Imágenes: URL o base64 En cada campo de imagen puedes pasar una URL pública (campo *_url) o la imagen en base64 (campo *_base64 + *_mime_type: PNG/JPEG/WebP). Si el usuario adjunta una imagen, súbela con assets_upload y usa la URL.
  • Referencia vs foto de producto La imagen de REFERENCIA (reference_*) define el estilo/diseño (plantilla del catálogo o imagen propia). La(s) foto(s) de PRODUCTO (product_image_*) son del producto real que se integra. Anuncio: 1 producto; landing/logo/mockup: hasta 3.
  • Campos de marketing Opcionales pero mejoran el resultado: sales_angle (ángulo de venta), specific_problem (problema que resuelve), target_avatar (cliente ideal), ideal_solution, additional_instructions. Si no los das, el motor los infiere.
  • Acceso por plan MCP/CLI y API REST: plan Prepago y desde el plan Basic en adelante (Basic, Pro, Business, Agency), mentores y admin. La cuenta de prueba no conecta MCP ni API. Todos los planes de pago acceden a todas las herramientas.
  • Generador de anuncios Crea, traduce y redimensiona anuncios (banners) con IA.
  • Generador de landings Genera secciones de landing page, incluida oferta y logística.
  • Generador de logos Crea logos de marca con IA.
  • Generador de mockups Crea y traduce mockups de packaging.
  • Investigación de producto Investigación IA: producto, ángulos de venta y avatar.
  • Investigación de palabras clave Volumen, CPC, competencia, relacionadas y tendencia de un término de búsqueda.
  • Investigación de competencia Analiza la competencia de un producto en un mercado y da un veredicto de oportunidad.
  • Videos: traducir y transcribir Traduce videos con doblaje + lip-sync y transcribe su guion a texto.
  • Espionaje de anuncios Anuncios de la competencia en Meta, Google y TikTok Shop.
  • Análisis financiero Calculadora de precio de venta y KPIs (COD y pago anticipado).
  • Productos Catálogo de productos del usuario.
  • Plantillas Galería de plantillas de referencia.
  • Assets e imágenes Subir imágenes y listar piezas generadas.
  • Cuenta y créditos Perfil, balance y uso de créditos.
  • Jobs Estado de las operaciones asíncronas.
  • Ayuda Manual de uso embebido.