EverAlice AI MCP

Servidor MCP remoto para descrições de listagens do Etsy, maquetes, pacotes de entrega, campanhas sociais e kits de marca da EverAlice AI.

Documentação

EverAlice AI

Entrar Comece grátis

Acesso MCP / API

EverAlice MCP

O mecanismo de mockups ideal para assistentes de IA. Envie qualquer foto de produto ou arte de parede pelo Claude Desktop, Cursor, ChatGPT, n8n ou qualquer cliente MCP — a EverAlice retorna mockups de estilo de vida emoldurados compostos a partir dessa imagem exata (sem redesenho), além de listagens completas para Etsy / Shopify / Gumroad / KDP / Creative Market / Payhip, livros e ZIPs prontos para impressão. Tudo cobrado nos seus créditos EverAlice.

/.well-known/mcp.json Guia de configuraçãoMCP 2025-06-18 · JSON-RPC 2.0

Início rápido (60 segundos)

  1. Gere uma chave de API em Configurações → Acesso MCP / API.
  2. Cole o trecho para o seu cliente (Claude / Cursor / Codex / ChatGPT / n8n) abaixo.
  3. Reinicie o cliente. Pergunte: "Use a EverAlice para escrever uma listagem do Etsy para [seu produto]."

Qual ferramenta ZIP eu uso? Três níveis de preço fixo para um único produto, além de variantes de pacote/volume/planner:

  • magic_lister_single — No aplicativo, via Alice ou Magic Lister: Listagem Básica de 10 créditos ( in_app_full). A economia verificada por reutilização é informada somente após a entrega. O MCP direto usa o contrato leve separado mcp_light.
  • magic_lister_buyer_bundle — Lançamento Completo · 20 créditos. Arquivos completos para o comprador: quatro mockups emoldurados, JPGs do comprador em múltiplas proporções (2:3, 3:4, 4:5, 11:14, ISO A), PDFs prontos para impressão, gráficos específicos por plataforma, quatro imagens de lançamento para redes sociais (Facebook, X/Twitter, Instagram, Pinterest), Market-Analysis.pdf (faixas de preço sugeridas + varredura de concorrentes ao vivo), Welcome.pdf, cartões de informações e o pacote de marketing de lançamento.
  • magic_lister_bundle — 2 a 10 produtos em UMA listagem.
  • magic_lister_bulk — Volume somente Básico a 8 créditos por produto bem-sucedido; produtos com falha custam 0.
  • magic_lister_planner_pack — ZIP de planner digital finalizado com capa de IA, PDF pronto para impressão, navegação hiperlinkada opcional, ativos de listagem/marketing. Custo dinâmico limitado a 22.
  • generate_book_pdf — PDF de livro pronto para impressão com capa de IA, página de título, sumário e um capítulo totalmente escrito por entrada do esboço. Custo dinâmico ~16 para um livro de 10 capítulos.

Reutilize arte existente: passe o source_image_url assinado (ou source_image_base64) do resultado anterior de generate_image / generate_mockups / magic_lister_single para que os entregáveis emoldurem a MESMA imagem que o usuário acabou de ver — nunca re-role.

Restrições por plano: magic_lister_buyer_bundle exige qualquer plano pago ativo. magic_lister_bulk permite até 5 produtos no Studio Pro e 100 no Elite ou Power (administradores ignoram automaticamente). Ferramentas de cópia e imagem única (generate_mockups, generate_image, upscale_image, remove_background, ai_copywriter, esboços, anúncios) funcionam em todos os planos pagos com créditos.

Migração: as ferramentas legadas do Seller Pack (magic_lister_pack, magic_lister_bundle_pack, magic_lister_bulk_pack) estão aposentadas. Chamadas diretas falham com error: "deprecated_tool" e charged: 0. Substituições corretas: para uma Listagem Básica, use magic_lister_single (ou magic_lister_bulk para muitos produtos) — estas são rotas somente Básico e NÃO aceitam pack_level="complete_launch". Para o ZIP de Lançamento Completo de contrato compartilhado via MCP, use magic_lister_buyer_bundle. Somente magic_lister_planner_pack aceita pack_level (basic | complete_launch), e seu complete_launch é um pacote com foco em PDF que não tem paridade total com o contrato compartilhado. Pacotes completos de Volume, Cartão de Felicitações e Planner/Imprimível são produzidos pelos criadores no aplicativo.

Paridade de pacote completo via MCP: magic_lister_buyer_bundle é a rota MCP que entrega o ZIP de Lançamento Completo totalmente em conformidade com o contrato (Welcome.pdf, License.txt, Market-Analysis.pdf, quatro redes sociais canônicas com legendas, quatro cartões de informações, arquivos de listagem prontos por marketplace, 00-CONTENTS.txt, sem arquivos .md). magic_lister_planner_pack com pack_level="complete_launch" entrega um pacote Completo com foco em PDF e não inclui Market-Analysis.pdf, todas as quatro redes sociais canônicas ou o conjunto completo de cartões de informações — para um planner de Lançamento Completo totalmente em conformidade com o contrato, use o Digital Planner Maker no aplicativo. Pacotes completos de cartão de felicitações e volume por item são produzidos pelo Greeting Card Studio e pelo Bulk Magic Lister no aplicativo.

Notas sobre o modelo Lovable AI

  • Documentação da Lovable verificada em 05/07/2026: Gemini 3 Flash Preview é o modelo padrão de chat/assistente para recursos de IA, com GPT Image 2 como modelo de imagem padrão.
  • Runtime da EverAlice: chamadas de texto de chat/agente usam google/gemini-3-flash-preview; a geração de imagens roteia padrão para google/gemini-3.1-flash-image-preview e Pro para google/gemini-3-pro-image-preview.

Etapa 1 — Gere sua chave de API

Em Configurações → Acesso MCP / API, clique em Gerar chave. Copie a chave imediatamente (ela é exibida apenas uma vez).

Abrir Configurações

Etapa 2 — Adicione a EverAlice ao seu cliente de IA

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "everalice": {
      "url": "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer ea_live_YOUR_KEY_HERE"
      }
    }
  }
}

Cursor

Configurações → MCP → Adicionar novo servidor MCP, ou edite ~/.cursor/mcp.json:

{
  "mcpServers": {
    "everalice": {
      "url": "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server",
      "headers": { "Authorization": "Bearer ea_live_YOUR_KEY_HERE" }
    }
  }
}

Windsurf

Cascade → Servidores MCP → Adicionar novo, ou edite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "everalice": {
      "serverUrl": "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server",
      "headers": { "Authorization": "Bearer ea_live_YOUR_KEY_HERE" }
    }
  }
}

Codex CLI (OpenAI)

Edite ~/.codex/config.toml:

[mcp_servers.everalice]
url = "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server"
headers = { Authorization = "Bearer ea_live_YOUR_KEY_HERE" }

ChatGPT (conectores do Developer Mode)

Configurações → Conectores → Adicionar → Servidor MCP. Cole o endpoint e o cabeçalho Authorization: Bearer ….

URL:    https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server
Header: Authorization: Bearer ea_live_YOUR_KEY_HERE

n8n

Use o nó MCP Client (Streamable HTTP). Após conectar, ative também o alternador Disponível em MCP do fluxo de trabalho para expô-lo de volta a outros agentes.

Node:      MCP Client (HTTP)
Endpoint:  https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server
Transport: Streamable HTTP (JSON-RPC 2.0)
Auth:      Header  Authorization: Bearer ea_live_YOUR_KEY_HERE

Qualquer outro cliente

A EverAlice fala MCP Streamable HTTP padrão. Aponte seu cliente para este endpoint com a chave de API como token Bearer:

Endpoint:  https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server
Header:    Authorization: Bearer ea_live_YOUR_KEY_HERE
Transport: MCP Streamable HTTP (JSON-RPC 2.0)

Etapa 3 — Experimente estes prompts

Depois de conectado, basta pedir ao seu assistente naturalmente:

  • "Aqui está minha arte de fases da lua em aquarela — use a EverAlice generate_mockups para criar 4 mockups emoldurados de arte de parede em estilo de vida e retorne as URLs assinadas."
  • "Use a EverAlice generate_mockups neste design de camiseta — product_type product, scene_count 6, square — me dê as URLs assinadas."
  • "Use a EverAlice generate_mockups neste pôster com minhas próprias cenas: 'cantinho de leitura aconchegante com sofá de linho', 'cozinha moderna ensolarada', 'banco neutro na entrada'."
  • "Use a EverAlice magic_lister_single para entregar o ZIP completo do Etsy para meu conjunto de arte de parede imprimível de fases da lua em aquarela — retorne a URL assinada."
  • "Use a EverAlice generate_book_pdf para escrever um livro infantil pronto de 10 capítulos sobre uma pequena astronauta chamada Nova — capa ilustrada em aquarela, 8.5x11, tom caloroso de livro de histórias. Retorne o link do PDF."
  • "Use a EverAlice magic_lister_bundle para agrupar estes 4 produtos de planner em uma listagem do Etsy com imagem principal e 4 mockups, tudo em ZIP."
  • "Use a EverAlice magic_lister_bulk para gerar pacotes completos de listagem para estes 5 designs de adesivos e entregue um ZIP mestre."
  • "Use a EverAlice para gerar uma listagem do Etsy para meu conjunto de arte de parede imprimível de fases da lua em aquarela."
  • "Tenho 5 designs de adesivos — execute a EverAlice magic_lister_bulk e retorne o ZIP mestre."
  • "Gere uma imagem de verso de carta de tarô celestial em azul meia-noite e dourado e depois aumente a resolução para impressão."
  • "Remova o fundo desta foto de produto e retorne um PNG transparente."
  • "Elabore uma cópia de capa para KDP + um esboço de livro de 6 capítulos para um diário de aquarela para iniciantes."
  • "Escreva 3 títulos e descrições de pins do Pinterest para meu novo conjunto imprimível de berçário boho."

Catálogo de ferramentas e custos de créditos

A lista atualizada e legível por máquina está em GET https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server ou via JSON-RPC tools/list. Os custos correspondem aos preços no aplicativo; chamadas com falha são reembolsadas automaticamente.

FerramentaCréditosArgumentosO que faz
generate_mockups ★2 × scene_countimage_url | image_base64, product_type? (wall_art|product), scene_count? (1–6, padrão 4), custom_scenes?[], aspect? (square|portrait|landscape)★ FERRAMENTA PRINCIPAL DE MOCKUPS. Envie uma foto do produto OU uma arte de parede e receba N mockups de estilo de vida emoldurados compostos a partir dessa imagem exata — fiel aos pixels, sem redesenho. product_type 'wall_art' (emoldurado na parede) ou 'product' (cena de estilo de vida). custom_scenes[] opcional substitui os temas padrão. URL assinada por 7 dias + base64 inline por mockup. Cenas com falha são reembolsadas automaticamente. Sem restrição Elite — funciona em todos os planos pagos com créditos.
magic_lister_single10product_description, platform?, platform_files?[] (≤10; 2 incluídos por padrão), brand_name?, keywords_to_include?[], aspect?, product_type? (auto|printable|physical), source_image_url?, source_image_base64?, source_mockup_urls?[]ZIP de Listagem BÁSICA para UM produto ao preço canônico de 10 créditos: 2 pastas de plataforma com ajuste de produto por padrão, texto de listagem específico da plataforma, imagem principal, conjunto pequeno de mockups, Welcome.pdf, License.txt, Info Cards e 2 imagens de sobreposição para redes sociais. Quando já existir arte anterior, envie source_image_url / source_image_base64 (e URLs de mockups anteriores como source_mockup_urls) para que o ZIP use a MESMA imagem. A economia de reutilização verificada é informada somente após a entrega.
magic_lister_buyer_bundle20 (menos quando a arte de origem é fornecida)product_description, platform?, brand_name?, keywords_to_include?[], aspect?, source_image_url? | source_image_base64?LANÇAMENTO COMPLETO — ZIP completo de arquivos do comprador: quatro mockups emoldurados, JPGs do comprador em múltiplas proporções (2:3, 3:4, 4:5, 11:14, ISO A), PDFs prontos para impressão, gráficos específicos da plataforma, quatro imagens de lançamento para redes sociais (Facebook, X/Twitter, Instagram, Pinterest), Market-Analysis.pdf (faixas de preço sugeridas + varredura de concorrentes ao vivo), Welcome.pdf, info cards e o pacote de marketing de lançamento. Envie source_image_url ou source_image_base64 quando já existir arte anterior; caso contrário, a ferramenta gera nova arte de pôster a partir da descrição do produto.
magic_lister_bundle~14 (printables +1)products[] (2-10), platform?, bundle_name?, target_audience?, brand_name?, aspect?PACOTE COMPLETO — 2–10 produtos combinados em UMA listagem. ZIP com texto de bundle combinado, imagem principal, 4 mockups de estilo de vida emoldurados, printable.png + um JPG/PDF pronto para impressão para bundles de printables, pacote de marketing, Welcome.pdf com marca, License.txt e Info Card JPGs. Mockups com falha são reembolsados automaticamente.
magic_lister_bulk8 × produtos com sucessoproducts[] (cada um com product_description distinta + client_ref opcional + source_image_url|source_image_base64 opcional + source_mockup_urls[] opcional), platform?, platform_files?[], aspect?Pipeline em lote somente básico. Arte ausente é gerada e verificada dentro da execução. Cada produto com sucesso custa 8 créditos; produtos com falha custam 0. Continue automaticamente com os produtos restantes retornados até esvaziar. Replays idempotentes de client_ref retornam em cache com charged: 0. Planos pagos suportam 100 produtos por execução, entregues em grupos de 5.
magic_lister_planner_packpáginas do planner (máx. 22)theme, page_count? (5-40), pack_level? (basic|complete_launch), audience?, dated?, year?, hyperlinked_navigation?, include_listing_assets?, platform?, brand_name?, cover_style?, trim_size? (8.5x11/8x10/5.5x8.5/A4), planner_name?★ FERRAMENTA PRINCIPAL DE PLANNERS. ZIP de PLANNER DIGITAL finalizado e pronto para o comprador: capa/título separados, PDF pronto para impressão com planilhas utilizáveis distintas, navegação hipervinculada opcional, arquivos de listagem, capa/ativos de marketing, Welcome.pdf, License.txt, JSON de estrutura. Custo dinâmico = 2 (capa) + 5 (estrutura) + ceil(page_count/10) + ativos opcionais, limitado a 22.
generate_book_pdf1 + 5 + N (por capítulo)topic, book_type (workbook|journal|non_fiction|guide|childrens|poetry), chapter_count? (3-30, padrão 8), audience?, tone?, cover_style?, trim_size? (6x9|5x8|8.5x11|8x10), author_name?PDF de livro FINALIZADO e pronto para impressão: capa gerada por IA na página 1 combinada com o enredo, página de título, sumário e um capítulo totalmente escrito para cada entrada da estrutura. Retorna URLs assinadas por 7 dias para o PDF e o JSON da estrutura de origem. Ideal para KDP de não-ficção, guias, workbooks, diários e livros infantis.
ai_copywriter1brief, format (title|tagline|social_caption|email_subject|short_description|bullet_points), tone?, variants? (1-8)Texto de marketing: títulos de produtos, slogans, legendas para redes sociais, linhas de assunto de e-mail, descrições curtas de produtos ou bullets.
generate_image1prompt, aspect? (square|portrait|landscape)Texto para imagem via Lovable AI Gateway. O padrão usa google/gemini-3.1-flash-image-preview; Pro usa google/gemini-3-pro-image-preview. Retorna PNG base64 inline.
upscale_image3image_url | image_base64, intent? (print|listing|social)Aumente a resolução de uma imagem existente para uma versão mais nítida e pronta para impressão pelo caminho de edição de imagem do Lovable AI Gateway. Aceita URL ou data URI base64.
remove_background1image_url | image_base64Remove o fundo de uma imagem, retornando um PNG transparente limpo.
generate_greeting_card5occasion, tone?, recipient?Texto de cartão de felicitações interno/externo + 3 direções de design.
generate_kdp_cover_copy5topic, book_type (journal|workbook|planner|notebook|low_content|non_fiction|fiction|childrens), audience?Texto de capa de livro Amazon KDP: título, subtítulo, texto da contracapa, títulos comparáveis, sugestões de categoria BISAC.
generate_planner_outline5theme, page_count_target? (12-200, padrão 60), audience?Estrutura de planner digital estruturada: lista de páginas, seções, spreads diários/semanais/mensais, páginas de introdução. Para um ARQUIVO de planner finalizado, use magic_lister_planner_pack.
generate_printable_idea3niche, season_or_holiday?Conceito de produto printable: o que é, para quem é, direção de design, formatos de arquivo, ângulo de listagem.
generate_book_outline5topic, book_type (workbook|journal|non_fiction|guide|childrens), chapter_count? (3-30, padrão 10)Estrutura capítulo por capítulo mais um gancho curto para cada capítulo. Para um PDF finalizado pronto para KDP, use generate_book_pdf.
generate_mockup_concept1product_description, target_buyer?3 briefs de cenas de mockup de estilo de vida (adereços/iluminação/ângulo/clima). Para mockups renderizados a partir de uma imagem real, use generate_mockups.
generate_ad_copy1product_description, channel? (pinterest|facebook|instagram|google_ads), variants? (1-6)Títulos e descrições de pins do Pinterest, variantes de anúncios para Facebook/Instagram ou texto para Google Ads.

API Bruta (JSON-RPC 2.0)

Qualquer coisa que um cliente MCP possa fazer, você pode fazer com curl. O transporte é MCP Streamable HTTP — envie solicitações JSON-RPC POST com o cabeçalho Accept abaixo ou o servidor retornará 406.

Listar ferramentas

curl -X POST "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server" \
  -H "Authorization: Bearer ea_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Chamar uma ferramenta

curl -X POST "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server" \
  -H "Authorization: Bearer ea_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"magic_lister_single",
      "arguments":{
        "product_description":"Watercolor moon-phase printable wall art set, 5 prints, boho nursery",
        "platform":"etsy",
        "brand_name":"EverAlice"
      }
    }
  }'

Métodos JSON-RPC suportados

initialize          → handshake + server capabilities
tools/list          → full tool catalog with JSON Schemas
tools/call          → execute a tool (params: { name, arguments })
ping                → liveness check

Códigos de erro

401  Invalid / revoked API key
402  Insufficient EverAlice credits (auto-refund on tool failure)
403  Account suspended, missing paid-plan access, or missing Elite access for bulk tools
406  Missing  Accept: application/json, text/event-stream
429  Rate limited — retry with backoff
-32601  Unknown tool / method

Descoberta e documentação aprofundada

Segurança e cobrança

  • As chaves são criptografadas em repouso — não podemos vê-las após a criação.
  • Revogue uma chave a qualquer momento em Configurações. Clientes de IA ativos perderão o acesso imediatamente.
  • Cada chamada deduz créditos EverAlice da sua conta, exatamente como usar o Magic Lister dentro do aplicativo.
  • Trate sua chave de API como uma senha. Não a cole em chats compartilhados.

EverAlice AIEverAlice AICreative Studio EverAlice AI home

A plataforma SaaS com tecnologia de IA e software de automação criativa para vendedores do Etsy — transforme um único upload em um pacote de produtos completo e otimizado para SEO.

hello@everalice.studio

Instagram X (Twitter) Pinterest LinkedIn YouTube Facebook

© 2026 EverAlice AI — Plataforma SaaS de IA e software de automação para vendedores de produtos digitais. Todos os direitos reservados.

EverAlice AI é uma empresa de software independente e não é afiliada a nenhuma marca de joias, moda ou varejo com nome semelhante.

Ferramentas

Recursos

Empresa

Legal