Gerencie sua vitrine do Mercader com Claude, ChatGPT ou Cursor

Se você já usa o Claude, o ChatGPT ou o Cursor para escrever descrições ou responder mensagens, dá para ir um passo além: deixar seu assistente atualizar sua vitrine do Mercader diretamente. Você pede “suba o preço dos brincos de argila para 26 €” ou “adicione a feira de artesanato de sábado na praça” e a mudança aparece em sua-loja.mercader.app assim que ele confirmar.

Para isso, o Mercader oferece um servidor MCP (o padrão que os assistentes usam para se conectar a outras ferramentas) e uma API REST. Você decide qual assistente se conecta e pode cortar o acesso quando quiser.

O que seu assistente pode fazer

• Ler sua vitrine: perfil, produtos, eventos, links e os limites do seu plano.
• Criar, editar e apagar produtos: nome, preço, descrição, foto e disponibilidade.
• Publicar e atualizar eventos e feiras, com data, horário e local.
• Mudar seu nome, sua apresentação, a cor da sua marca, seu logo e sua capa.
• Adicionar ou corrigir seus links: Instagram, WhatsApp, site, e-mail…

O que ele não pode fazer: ver seus contatos ou suas avaliações, mudar o endereço da sua vitrine, mexer no seu plano ou na sua cobrança, nem apagar sua conta.

Antes de começar

Você precisa de uma conta no Mercader com sua vitrine criada. Se ainda não tem, crie sua vitrine: você tem 14 dias de teste com todos os recursos e em poucos minutos ela fica pronta.

Tudo o que você configurar fica no seu painel, em Admin › Assistentes de IA.

Opção 1: Claude ou ChatGPT, sem copiar chaves

É o jeito mais simples. Seu assistente vai pedir permissão em uma página do Mercader e você não precisa copiar nenhuma chave.

1. No seu assistente, procure a opção para adicionar um conector ou um servidor MCP personalizado. No Claude fica em Configurações › Conectores; no ChatGPT, nas configurações de aplicativos e conectores (dependendo do seu plano, talvez você precise ativar o modo desenvolvedor). Os menus mudam com frequência: se não encontrar, procure “conector” na ajuda do seu assistente.

2. Cole este endereço:

   https://web.mercader.app/api/mcp/me
   

3. Uma página do Mercader vai abrir. Entre na sua conta se for preciso, confira o que o assistente poderá fazer e clique em Permitir acesso.

4. Volte ao seu assistente e peça: “Me mostre como está minha vitrine do Mercader”.

Opção 2: Claude Code ou Cursor

Se você trabalha com um assistente de programação, é igualmente rápido.

No Claude Code, execute:

claude mcp add --transport http mercader https://web.mercader.app/api/mcp/me

No Cursor, adicione isto ao seu arquivo mcp.json:

{
  "mcpServers": {
    "mercader": { "url": "https://web.mercader.app/api/mcp/me" }
  }
}

Na primeira vez, o navegador vai abrir para você aprovar o acesso, como na opção 1.

Opção 3: token pessoal e API REST

Para scripts próprios (por exemplo, sincronizar o estoque com uma planilha) ou assistentes sem suporte a OAuth, crie um token pessoal em Admin › Assistentes de IA. Escolha um nome e as permissões e copie na hora: ele não aparece de novo.

curl https://web.mercader.app/api/v1/me \
  -H "Authorization: Bearer mk_live_…"

A API está documentada em OpenAPI em web.mercader.app/api/v1/openapi.json. Trate o token como uma senha: quem tiver o token pode editar sua vitrine.

Ideias para pedir ao seu assistente

• “Adicione estes três produtos com estes preços e escreva uma descrição curta para cada um.”
• “Marque as bolsas de ráfia como esgotadas.”
• “Publique a feira de Natal de 12 de dezembro, das 10h às 20h, na praça principal.”
• “Revise as descrições dos meus produtos e sugira melhorias antes de mudar.”
• “Mude minha apresentação para dizer que faço encomendas personalizadas.”
• “Apague os eventos que já passaram.”

Um bom hábito: peça primeiro para ele mostrar a mudança e confirme você mesmo. As mudanças são publicadas na hora para seus clientes.

Fotos dos produtos

Seu assistente também pode enviar fotos. Primeiro ele pede ao Mercader um endereço de envio seguro, envia a imagem e associa ao produto. Assistentes como o Claude Code fazem isso sozinhos com uma foto do seu computador; nos assistentes de chat, depende de eles conseguirem trabalhar com arquivos. Se não conseguirem, envie a foto pelo seu painel, como sempre.

Se tiver dúvidas sobre as fotos, confira o checklist de fotos de produto.

Você no controle

• Permissões: ao conectar, você vê o que o assistente poderá fazer. Os tokens pessoais podem ser limitados a “Perfil e links” ou a “Produtos e eventos”.
• Revogar: em Admin › Assistentes de IA você vê cada conexão, quando foi usada pela última vez e um botão para revogá-la.
• Limites do seu plano: seu assistente tem os mesmos limites que você tem no painel. Se você chegar ao máximo de produtos do seu plano, ele vai avisar em vez de passar do limite.
• Nada inventado: pedimos ao assistente que não invente preços nem dados e que pergunte antes de apagar qualquer coisa. Mesmo assim, dê uma olhada na sua vitrine de vez em quando.

Comece com um pedido pequeno

Conecte seu assistente e peça algo simples, como corrigir uma descrição ou adicionar sua próxima feira. Quando vir a mudança na sua vitrine, você vai saber quanto tempo ele pode economizar.

Crie sua vitrine com 14 dias de teste e conecte ao seu assistente desde o primeiro dia.