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
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)
- Gere uma chave de API em Configurações → Acesso MCP / API.
- Cole o trecho para o seu cliente (Claude / Cursor / Codex / ChatGPT / n8n) abaixo.
- 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 separadomcp_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).
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.
| Ferramenta | Créditos | Argumentos | O que faz |
|---|---|---|---|
| generate_mockups ★ | 2 × scene_count | image_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_single | 10 | product_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_bundle | 20 (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_bulk | 8 × produtos com sucesso | products[] (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_pack | pá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_pdf | 1 + 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_copywriter | 1 | brief, 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_image | 1 | prompt, 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_image | 3 | image_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_background | 1 | image_url | image_base64 | Remove o fundo de uma imagem, retornando um PNG transparente limpo. |
| generate_greeting_card | 5 | occasion, tone?, recipient? | Texto de cartão de felicitações interno/externo + 3 direções de design. |
| generate_kdp_cover_copy | 5 | topic, 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_outline | 5 | theme, 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_idea | 3 | niche, season_or_holiday? | Conceito de produto printable: o que é, para quem é, direção de design, formatos de arquivo, ângulo de listagem. |
| generate_book_outline | 5 | topic, 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_concept | 1 | product_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_copy | 1 | product_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
- Manifesto de descoberta: /.well-known/mcp.json
- Guia de configuração completo (imprimível): /resources/mcp-server-playbook.html
- Catálogo de ferramentas ao vivo: GET https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server
- Anúncio de lançamento: Blog →
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 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.
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
- Blog
- Veja uma Amostra ao Vivo (Sem Cadastro)
- Comparar
- Programa de Afiliados
- Torne-se um Afiliado
- Gerador de Listagens Etsy
- Ferramenta de SEO Etsy
- AI Etsy Lister
- Etsy SEO AI
- AI Mockup Generator
- AI Listing Generator
- Gerador de Arte de Parede Printable
- Criador de Livros de Colorir com IA
- Cartões de Felicitações Printable
- Arte Printable para Quarto de Bebê
- Printables de Casamento (IA)
- Desenvolvedores / API MCP
Empresa
- Sobre
- Imprensa
- Fatos e Referência Rápida
- Melhores Ferramentas de IA para Etsy
- Melhores Geradores de Listagens com IA
- Contatar Suporte
- Enviar E-mail
- Preferências de E-mail
- Instalar como Aplicativo
Legal