Workshop Operação Lucrativa · Agenda da manhã · 17/10

Bom dia e boas‑vindas!

Que bom ter você no Workshop Operação Lucrativa. Esta é a página da agenda da manhã: deixe aberta e siga junto com a aula, da abertura ao plugin exclusivo instalado, conectado à sua conta do Mercado Livre e fazendo as primeiras análises. Marque cada etapa ao concluir.

9h00 início (Brasília) Online e ao vivo Manhã · 7 etapas
9h00

01 Abertura

Abertura e combinados do dia

Hoje você sai com a IA trabalhando na sua operação do Mercado Livre. De manhã, o Claude Desktop e o plugin exclusivo conectados à sua conta. À tarde, o seu primeiro sistema próprio. Antes de começar:

Combinados

Nossos combinados

Leia e clique em cada um para confirmar. O resto da agenda abre quando você concordar com todos.

0 de 7 confirmados ✓ Combinados aceitos. Bora!

O restante da agenda aparece depois que você concordar com os combinados.

Agora

Confira o seu Claude Desktop

  • Aberto e logado na sua conta.
  • Atualizado: se o app oferecer uma atualização, instale antes de começar.
  • O Cowork abre: procure “Cowork” (ou “Início”) na barra lateral.
  • Serviço no ar: status.claude.com mostra se há instabilidade.

Cronograma do dia

Manhã · a partir das 9h

IA na sua conta do ML

  1. Revisão geral do Claude DesktopModos, skills, plugins e habilidades · etapa 02
  2. API do Mercado LivreO app no DevCenter que abre a porta da sua conta · etapa 05
  3. Conexão da sua conta MLUma vez só, e ela se renova sozinha · etapa 06
  4. Uso do plugin exclusivoHN Anúncio ML baixado e instalado · etapas 03 e 04
  5. Análises iniciais dos seus dadosRaio-x, Product Ads e as decisões do dia · etapa 07
Tarde

Do plugin à sua plataforma

  1. Claude CodeO modo em que o Claude programa por você
  2. Princípios de desenvolvimento de plataformas
  3. Calculadora de margemCriação e uso
  4. Plataformas e ferramentas
  5. Seu 1º sistema próprio
02

02 Claude Desktop

As peças do Claude Desktop

Os modos e as seis palavras que vão aparecer o dia inteiro. Entenda cada uma antes de instalar qualquer coisa: o resto do dia fica muito mais fácil.

Modos

Três jeitos de trabalhar com o Claude

Chat

A conversa. Perguntas, ideias, textos, a análise de um arquivo que você anexa. É o modo de pensar junto.

Cowork manhã

O Claude trabalha por você: lê e cria arquivos numa pasta, roda scripts e entrega relatórios prontos. É aqui que o plugin roda.

Code tarde

O Claude programa: cria e roda sistemas inteiros a partir do seu pedido em português.

Skill

Uma habilidade

Um manual de procedimento: ensina o Claude a fazer uma tarefa do jeito certo, sempre do mesmo jeito. Você não precisa chamar pelo nome: ele escolhe a skill pelo sentido do pedido. Digite / para ver a lista.

“faz o raio-x do MLB…” → raio-x-anuncio-ml
Plugin

Um pacote completo

Junta skills, agentes e scripts num arquivo só. Instala tudo de uma vez e liga ou desliga numa chave. O HN Anúncio ML traz 17 skills e 4 agentes.

hn-anuncio-ml-1.7.0.plugin
Agente

Um especialista à parte

Um ajudante que o Claude chama para uma parte pesada do trabalho: extrair um anúncio, pesquisar o mercado, conferir os números. Ele trabalha separado e devolve só o resumo, e a conversa principal não se perde.

pesquisa-mercado-ml
Projeto

O seu lugar de trabalho

Reúne as conversas de um assunto, as instruções que valem para todas elas e uma pasta do seu computador. Crie um para a sua loja: o que o plugin gerar fica guardado na pasta dele.

Projeto “Minha Loja ML”
Artefato

O resultado pronto

O que o Claude entrega para você usar fora da conversa: uma página, um relatório, uma planilha, um gráfico, um documento. Você abre, pede ajustes e baixa.

o relatório em HTML do raio-x
Conector

Uma ponte com outro sistema

Liga o Claude a um serviço externo. O plugin não precisa de conector: ele fala direto com a API do Mercado Livre usando a conexão guardada no seu computador.

Pense numa loja: o Claude é o funcionário. No Chat vocês conversam, no Cowork ele trabalha na mesa e no Code ele constrói uma ferramenta nova. As skills são os procedimentos que ele segue, o plugin é o treinamento completo que você entrega de uma vez, os agentes são os especialistas que ele chama, o projeto é a mesa dele, com a pasta da sua loja em cima, e o artefato é o relatório pronto que ele deixa para você.

03

03 O plugin

O plugin exclusivo da Operação Lucrativa

O HN Anúncio ML foi feito pelo Henrique Niada só para quem está aqui. É um time completo para o Mercado Livre dentro do seu Claude: do raio-x do anúncio à publicação, dos Product Ads às várias lojas — tudo pedindo em português.

Exclusivo para participantes 17 skills4 agentes especialistasNada muda na sua conta sem o seu “pode”

Raio-x do anúncio

Descobre por que um anúncio não vende: título, fotos, preço, ficha técnica e concorrência. Não altera nada.

O anúncio perfeito

Estratégia, título, descrição, ficha técnica, preço com margem para promoção e o roteiro das fotos, de ponta a ponta.

Publicação com travas

Revisão completa antes de subir. Só publica depois do seu “pode publicar”.

Product Ads

Diagnóstico da conta e de cada campanha: ROAS, ACOS, TACOS e onde o dinheiro está indo embora. Não mexe nas campanhas.

Decisões do dia

Uma fila curta do que mexer hoje nos ads, com o valor em jogo e quando conferir de novo.

Várias lojas

A mesma análise em todas as suas contas de uma vez, num relatório só para comparar.

HN

HN Anúncio ML · versão 1.7.0

O arquivo do plugin, pronto para instalar na etapa 04. O download é liberado durante o workshop — quando abrir, um clique e ele vai para a sua pasta Downloads, sem precisar abrir nem descompactar.

17 skills4 agentes749 KB.plugin
Não descompacte o arquivo. Se o navegador perguntar, escolha “Manter”. O Claude Desktop recebe o .plugin do jeito que ele veio.

Confira o Python 3

Abra o Terminal (Mac) ou o Prompt de Comando (Windows), cole o comando e aperte Enter. Tem que aparecer Python 3. e um número.

Mac
python3 --version
Windows
py --version
Deu “comando não encontrado”? Instale pelo site oficial, python.org/downloads. No Windows, marque “Add Python to PATH” na primeira tela do instalador.
04

04 Instalar no Claude

Plugin instalado e pronto no Cowork

Siga o tour: o ponto colorido é onde você clica no seu Claude Desktop. Use Próximo ou as setas ← → com o mouse sobre a tela.

Prints reais do Claude Desktop em português (outubro de 2026). A barra lateral muda conforme a versão do app — o tour mostra as três que existem hoje.

05

05 App no Mercado Livre

Crie o seu app no DevCenter

O app é a “chave” que deixa o plugin conversar com a API do Mercado Livre em nome da sua conta. Você cria uma vez só e sai com dois códigos: App ID e Secret Key.

Link
https://developers.mercadolivre.com.br/devcenter

Prints reais do DevCenter do Mercado Livre (outubro de 2026). Se o site mudar, os nomes dos campos continuam valendo.

A Secret Key é uma senha. Não mande em grupo e não tire print com ela à mostra. Ela vai só para a conversa do seu projeto no Claude, na próxima etapa — com a tela sem compartilhar.
06

06 Conectar a conta

Ligue o plugin à sua conta

Leva poucos minutos e é uma vez só. Depois disso o plugin enxerga a sua conta do Mercado Livre e a conexão se renova sozinha.

App ID e Secret Key do seu app à mão (etapa 05) Navegador logado na conta vendedora que você vai conectar Compartilhamento de tela desligado antes de colar as chaves
  1. Peça ao Claude, no Cowork, dentro do projeto
    conecta minha conta do Mercado Livre

    Se preferir, digite /conectar-conta-ml. Se as chaves já estiverem guardadas, ele pula direto para o passo 3.

  2. Cole o App ID e a Secret Key quando ele pedir

    Copie os dois do seu app no DevCenter e cole na conversa, do jeito que vier. O plugin guarda as chaves num cofre no computador e não repete os valores na conversa.

    Cadastrou uma Redirect URI diferente de https://httpbin.org/get? Avise qual junto com as chaves.

    Prefere não colar no chat? Use um arquivo

    Na pasta do projeto, crie um arquivo chamado .env — com o ponto na frente — com as três linhas abaixo e avise o Claude que salvou. No Mac ele fica oculto no Finder (Cmd+Shift+. mostra); no Windows, confira que não virou .env.txt.

    .env
    CLIENT_ID=cole-aqui-o-app-id
    CLIENT_SECRET=cole-aqui-a-secret-key
    REDIRECT_URI=https://httpbin.org/get
  3. Abra o link e autorize

    O Claude devolve um link. Abra no navegador logado na conta vendedora e clique em Autorizar. Tem mais de uma conta no navegador? Confira o nome no canto da tela antes de autorizar.

  4. Copie a barra de endereço e cole no chat

    O navegador vai para uma página com um texto técnico — ou até um erro. É assim mesmo. O que importa é a barra de endereço, que agora tem ?code=: copie a URL inteira e cole na conversa.

    Esse código vale poucos minutos e uma vez só. Demorou? Peça um link novo e repita.

  5. Confira a conexão

    O Claude mostra o apelido da conta e se ela tem acesso a ads. Logo em seguida, ele apresenta tudo o que dá para pedir agora.

    Apareceu ads: não? Volte ao app no DevCenter, marque a permissão Publicidade e peça para conectar de novo: as chaves continuam guardadas, então o link sai direto.

Viu o apelido da sua conta? Conectou. A partir de agora o plugin lê os seus anúncios, vendas e campanhas — e você já pode ir para a etapa 07.
Onde fica a conexão: no cofre do plugin (a pasta .hn-anuncio-ml), com acesso só para o seu usuário. A Secret Key nunca aparece na conversa. Se um dia o Claude disser que não encontrou a sua conta, é só pedir “conecta minha conta do Mercado Livre” de novo.
07

07 Primeiros pedidos

Agora é pedir em português

Chegou a melhor parte: é só conversar. Escreva do jeito que você falaria com alguém da sua equipe, sem comando para decorar e sem jeito certo. Para começar, copie um destes pedidos, cole no projeto e troque o MLB por um anúncio seu.

Comece por aquifaz o raio-x do MLB1234567890Descobre por que o anúncio não vende · não altera nada
como estão meus ads? quero o relatórioRaio-x da publicidade da conta inteira · não altera nada
o que eu mexo hoje nos ads?Uma lista curta do que fazer hoje · não altera nada
monta o anúncio perfeito desse produto: MLB1234567890Cria o anúncio com você · só publica depois do seu “pode publicar”
Onde acho o MLB? No endereço do anúncio, logo depois de MLB-. Pode colar o link inteiro também: o Claude entende.
Ficou em dúvida no meio? Pergunte ali mesmo: “o que quer dizer ACOS?”, “e agora, o que eu faço?”. Os relatórios em HTML ficam salvos na pasta do projeto.

Travou? Sem problema

Os tropeços mais comuns têm solução rápida. E se não estiver aqui, chame no chat do evento.

O Claude Desktop recusou o arquivo do plugin

Confira se você enviou o arquivo .plugin original, sem descompactar, e se o seu Claude Desktop está atualizado. Baixe de novo na etapa 03 se o download tiver sido interrompido.

Digitei “/” e as skills hn-anuncio-ml não aparecem

Confirme em Personalizar › Plugins que o HN Anúncio ML aparece e está ativo. Depois abra uma conversa nova dentro do projeto.

O DevCenter diz que o endereço de redirect não é válido

O Mercado Livre exige um endereço HTTPS que responda. Use exatamente https://httpbin.org/get. Endereços com localhost não passam.

“O App ID tem que ser só números” ou “a Secret Key veio vazia ou com espaço”

A colagem pegou algo a mais (um espaço, o nome do campo, a frase inteira). Copie de novo no DevCenter só o valor de cada campo e cole outra vez. Se usa o arquivo .env, confira que ele se chama exatamente .env e está na pasta do projeto.

“invalid_grant” ao colar a URL

O código expirou ou já foi usado. Peça de novo “conecta minha conta do Mercado Livre” e cole a URL logo depois de autorizar.

Tenho mais de uma loja

Repita a etapa 06 logado na outra conta. A conexão nova é acrescentada, não substitui a anterior. Para rodar um relatório em todas, peça: “roda o diagnóstico de ads em todas as minhas contas”.

Bloqueado por enquanto: libera na parte da tarde.