Documentação — Conecte o Ecom Magic AI à sua IA
Gere anúncios, landings, logos, mockups, pesquisa, espionagem de anúncios e análise financeira a partir do Claude, ChatGPT, Codex, Cursor ou qualquer cliente compatível com MCP.
URL do servidor MCP (cole no seu cliente de IA)
https://ecom-magic.ai/mcp/v1
Clientes validados com esta URL: Claude.ai, Claude Desktop, Claude Code e Codex (o Cursor e o ChatGPT são compatíveis, ainda não validados). No Claude ou ChatGPT: Configurações → Conectores → Adicionar conector personalizado → cole a URL → faça login no Ecom Magic e autorize. No Claude Code: claude mcp add --transport http ecom-magic <URL>. No Codex: codex mcp add ecom-magic --url <URL> e depois codex mcp login ecom-magic. No Cursor: adicione o servidor com a URL e clique em Autenticar. Depois peça à sua IA para gerar anúncios, landings, etc.
Como funciona
Conceitos-chave: conexão, jobs assíncronos, créditos e imagens.
- Assíncrono + polling Gerar, traduzir, redimensionar e pesquisar retornam um job_id. Chame jobs_get a cada 3-5s até status='succeeded' (output traz a URL/dados) ou 'failed'.
- Créditos Gerar/traduzir/redimensionar/editar custa 1 crédito por peça. Pesquisa de produto 3-6 conforme o modelo; ângulos e avatar 3-6. Espionagem: grátis com assinatura mensal, mentores e admin; pré-pago e teste pagam 1 por busca nova (paginar não cobra). Em massa de anúncios/landings: 1 por peça, até o limite vigente (máx. 50). Palavra-chave 1. Concorrência 20 (ao concluir). Vídeo: traduzir 1 crédito a cada 10s POR idioma; transcrever 1. Análise financeira, research_generic_angle, leituras (list/get/download) e traduzir o texto transcrito são gratuitos.
- Imagens: URL ou base64 Em cada campo de imagem passe uma URL pública (*_url) ou a imagem em base64 (*_base64 + *_mime_type: PNG/JPEG/WebP). Se o usuário anexar uma imagem, envie-a com assets_upload e use a URL.
- Referência vs foto do produto A imagem de REFERÊNCIA (reference_*) define o estilo/design (modelo do catálogo ou própria). A(s) foto(s) de PRODUTO (product_image_*) são do produto real a integrar. Anúncio: 1 produto; landing/logo/mockup: até 3.
- Campos de marketing Opcionais, mas melhoram o resultado: sales_angle, specific_problem, target_avatar, ideal_solution, additional_instructions. Se omitidos, o motor os infere.
- Acesso por plano MCP/CLI e API REST: plano Pré-pago e a partir do plano Basic (Basic, Pro, Business, Agency), mentores e admin. A conta de teste não conecta MCP nem API. Todos os planos pagos acessam todas as ferramentas.
- Gerador de anúncios Crie, traduza e redimensione anúncios (banners) com IA.
- Gerador de landings Gere seções de landing page, incluindo oferta e logística.
- Gerador de logos Crie logos de marca com IA.
- Gerador de mockups Crie e traduza mockups de embalagem.
- Pesquisa de produto Pesquisa por IA: produto, ângulos de venda e avatar.
- Pesquisa de palavras-chave Volume, CPC, concorrência, relacionadas e tendência de um termo de busca.
- Pesquisa de concorrência Analisa a concorrência de um produto em um mercado e retorna um veredito de oportunidade.
- Vídeos: traduzir e transcrever Traduza vídeos com dublagem + lip-sync e transcreva o roteiro em texto.
- Espionagem de anúncios Anúncios da concorrência no Meta, Google e TikTok Shop.
- Análise financeira Calculadora de preço de venda e KPIs (COD e pré-pago).
- Produtos Catálogo de produtos do usuário.
- Modelos Galeria de modelos de referência.
- Assets e imagens Enviar imagens e listar peças geradas.
- Conta e créditos Perfil, saldo e uso de créditos.
- Jobs Status das operações assíncronas.
- Ajuda Manual de uso integrado.
