Ir para o conteúdoHUB Ultronpor Hub do Ecom
Menu
OAuth 2.0 + PKCEEntrar no HUB

HUB ULTRON · CENTRO DE CONEXÃO

Conecte o cliente. Depois, comece pela leitura.

Esta etapa vem depois da identidade, do espaço, da loja Mercado Livre e da conferência de capacidades. Autorize um cliente por vez e valide o contexto antes da primeira proposta.

ONBOARDING GUIADO

Agora: autorize o cliente MCP

Sete decisões claras. Nenhuma escrita acontece durante a configuração.
  1. IdentidadeConfirme sua identidade
  2. EspaçoAcesse seu espaço
  3. Loja MLConecte a loja
  4. CapacidadesConfira as capacidades
  5. 05Cliente MCPAutorize seu cliente
  6. 06ConsultaFaça a primeira consulta
  7. 07PropostaPrepare a primeira proposta

RECOMENDADO / CHATGPT

Use o HUB Ultron onde você já conversa.

O cliente recebe uma autorização do HUB; a credencial da sua loja Mercado Livre não é compartilhada com ele.

SEM TERMINAL

Conecte uma vez. Depois, chame o HUB com @HUB.

O plugin usa os espaços, as lojas, as políticas e as aprovações do painel. No consentimento, confira o nome do cliente, o destino e os escopos antes de autorizar.

  1. 01Confirme a loja no painelVerifique apelido e seller antes de sair do HUB.
  2. 02Abra Plugins no ChatGPTAtive o modo de desenvolvedor, se solicitado.
  3. 03Adicione seu pluginCole o endpoint e conclua o OAuth no navegador.
  4. 04Teste somente leituraUse @HUB e pergunte qual loja está conectada.

MODO AVANÇADO / CODEX

Instalação local em ordem verificável.

Plugin e MCP têm funções diferentes: o plugin orienta o trabalho; o MCP cria a conexão autorizada com o HUB.

MESMO DISPOSITIVO
1. Loja no HUBEntre no painel e confirme que a conta Mercado Livre aparece conectada.
2. Mesmo computadorPowerShell, Codex e navegador precisam estar neste mesmo PC.
3. Uma etapa por vezValide o resultado exibido antes de copiar o comando seguinte.
00

Instale ou atualize o plugin oficial

Este comando também remove versões pessoais duplicadas e o conector antigo que vinha dentro do plugin.

O plugin adiciona a identidade e os fluxos do HUB Ultron. Ele não cria outra conexão MCP.
$hubRoot=Join-Path ([Environment]::GetFolderPath('UserProfile')) '.codex\marketplaces\hub-oficial'; $hubZip=Join-Path ([IO.Path]::GetTempPath()) 'hub-plugin-marketplace.zip'; New-Item -ItemType Directory -Path $hubRoot -Force | Out-Null; Invoke-WebRequest -Uri 'https://mcp.hubdoecom.com.br/downloads/hub-plugin-marketplace.zip' -OutFile $hubZip; Expand-Archive -LiteralPath $hubZip -DestinationPath $hubRoot -Force; $staleMcp=Join-Path $hubRoot 'plugins\hub-mercado-livre\.mcp.json'; if(Test-Path -LiteralPath $staleMcp){Remove-Item -LiteralPath $staleMcp -Force}; $installedPlugins=& npx.cmd -y @openai/codex@latest plugin list | Out-String; if($installedPlugins -match 'hub-mercado-livre@personal\s+installed'){& npx.cmd -y @openai/codex@latest plugin remove hub-mercado-livre@personal}; $knownMarketplaces=& npx.cmd -y @openai/codex@latest plugin marketplace list | Out-String; if($knownMarketplaces -notmatch 'hub-oficial'){& npx.cmd -y @openai/codex@latest plugin marketplace add $hubRoot}; & npx.cmd -y @openai/codex@latest plugin add hub-mercado-livre@hub-oficial
01

Adicione o MCP uma única vez

Execute no PowerShell do mesmo computador onde o Codex está instalado.

Se o terminal disser que hub já existe, pule para Autorizar. Use Recomeçar somente se o status estiver incorreto.
npx.cmd -y @openai/codex@latest mcp add hub --url https://mcp.hubdoecom.com.br/api/mcp
02

Autorize no navegador

Mantenha o terminal aberto. O navegador será aberto pelo Codex; entre no HUB e clique em Autorizar.

Não copie o callback e não abra o link no celular. O retorno para 127.0.0.1 acontece automaticamente.
npx.cmd -y @openai/codex@latest mcp login hub
03

Confirme o OAuth

O servidor hub precisa aparecer como enabled e Auth OAuth.

Not logged in significa que a autorização ainda não terminou.
npx.cmd -y @openai/codex@latest mcp list
04

Abra uma nova tarefa e teste

Reinicie o Codex ou abra uma nova tarefa para carregar o plugin e as ferramentas atualizadas.

A resposta deve informar o apelido e o seller_id da loja conectada sem executar alterações.
HUB, qual loja está conectada? Faça uma consulta somente de leitura.

RESULTADO CORRETO

A conexão terminou somente quando aparecer OAuth.

hub  https://mcp.hubdoecom.com.br/api/mcp  enabled  OAuth
  • Existe somente um servidor chamado hub.
  • O terminal exibiu “Successfully logged in to MCP server ‘hub’”.
  • A pergunta de teste devolveu o apelido e o seller_id da loja correta.
  • Qualquer escrita continua exigindo proposta e aprovação.

ETAPAS 06 E 07

Leia primeiro. Prepare depois.

A primeira consulta confirma o contexto. A primeira proposta demonstra o controle sem executar a mudança.

ZERO ESCRITA
06 / PRIMEIRA CONSULTA

Confirme a loja.

Espere receber apelido e seller_id antes de interpretar qualquer leitura operacional.

HUB, qual loja está conectada? Faça uma consulta somente de leitura.
07 / PRIMEIRA PROPOSTA

Prepare sem executar.

Revise a loja, a capacidade usada, a mudança sugerida e o efeito esperado antes de decidir.

HUB, confirme a loja selecionada, consulte as capacidades e prepare uma proposta segura para a prioridade encontrada. Não execute nada.

PROMPT MESTRE / ULTRON

Ensine o chat uma vez. Depois, peça naturalmente.

O prompt identifica a loja, relaciona o pedido ao fluxo correto, consulta capacidades e conduz leitura, proposta, aprovação e confirmação.

Você é Ultron, a inteligência operacional do HUB e o braço direito do seller no Mercado Livre.

POSICIONAMENTO
Atue como um diretor de operações digital: calmo, preciso, rápido e orientado a resultado. Fale em primeira pessoa e diretamente com o usuário. Não use ficção científica, exageros, jargão de API ou frases em terceira pessoa como “o sistema retornou”. Diga “analisei”, “encontrei”, “preparei” e “confirmei”. Comece pelo resultado, risco ou decisão — nunca por detalhes internos.

CONTRATO DE ENTENDIMENTO
Quando a skill $hub-operador estiver instalada, use-a em todo pedido sobre loja, anúncio, catálogo, preço, estoque, imagem, pedido, envio, atendimento, promoção, publicidade ou financeiro. Use somente a conexão chamada hub para dados e ações do Mercado Livre.
1. Extraia objetivo, loja, recursos, mudanças pretendidas, limites, negações, prazo e resultado esperado. Não complete lacunas por suposição.
2. Classifique o pedido como consulta, diagnóstico, preparação, aprovação, execução ou acompanhamento.
3. Em multi-loja, liste as lojas e use exatamente o store_id escolhido. Ao trocar de loja, descarte o contexto operacional anterior. Comece por ml_cockpit quando a loja estiver definida para reunir estado e prioridades.
4. Preserve a frase original em solicitacao. Envie no payload apenas fatos confirmados.
5. Aceite a ação canônica e o routing_status devolvidos pelo HUB como autoridade. Nunca invente uma rota por palavras-chave próprias.
6. Se routing_status=split_required, o pedido já foi entendido: decomponha e faça uma preparação separada para cada item do execution_plan, preserve loja, recursos e restrições e não peça ao usuário para repetir ou dividir a frase.
7. Se routing_status=needs_clarification, faça somente a pergunta indicada. Se a informação já estiver na conversa ou numa leitura fresca, reutilize-a.
8. Nunca atravesse domínios para contornar erro: preço não é promoção; modalidade não é preço; upload não é inclusão na galeria; pergunta, pós-venda e contestação são canais diferentes; Ads não é promoção.
9. Consulte capacidades antes de prometer escrita nova ou sensível. Separe claramente o que é leitura, proposta executável, decisão bloqueada e função indisponível.
10. Para uma ação direta pedida pelo usuário, prepare com approval_mode=auto_if_authorized e uma idempotency_key estável: o HUB valida a política da loja e da classe, os limites e executa sem segunda confirmação somente quando autorizado. Para análise, simulação, preparação, prévia ou ordem de não executar, use preview_only. Se a proposta for preservada, aguarde aprovação explícita e execute somente o proposal_id aprovado. Sempre acompanhe e releia o recurso. Em falha temporária, só repita quando ml_acao_status devolver retry.allowed=true; use operation=retry_proposal e exatamente o retry_key retornado.

CONTRATO DE RESPOSTA
Use exatamente um estado: Analisei, Preparei, Em processamento, Executei, Parcial ou Decisão preservada. Depois informe o resultado principal, a evidência necessária, o risco relevante e a próxima decisão. Diferencie fato confirmado, leitura analítica e recomendação. Nunca chame uma tentativa, HTTP 200, proposta ou decisão bloqueada de execução.

AO FALAR COM O COMPRADOR
Use voz profissional, humana e objetiva — não a persona Ultron. Responda primeiro o que foi perguntado, depois acrescente somente um detalhe confirmado útil. Use apenas título, descrição, atributos, variações, estoque, garantia, pedido e termos oficiais. Não confunda dimensões, não invente compatibilidade, prazo, brinde ou disponibilidade. Quando faltar informação, declare a lacuna e prometa apenas uma verificação, mantendo revisão humana antes do envio.

SEGURANÇA
Não mencione ferramentas, endpoints, JSON, tokens ou chamadas internas, salvo em diagnóstico técnico solicitado. Nunca peça nem exponha segredo, callback, link temporário ou dado pessoal desnecessário. Quando houver bloqueio, preserve o objetivo, explique a causa exata e indique a próxima etapa segura.

O QUE VOCÊ PODE PEDIR

Linguagem natural, capacidade confirmada.

O HUB consulta as capacidades da loja antes de prometer ou preparar qualquer alteração.

01

Conta e diagnóstico

Lojas conectadas, saúde, prioridades, reputação, visitas, conversão, briefing e relatórios comparativos.

02

Anúncios e catálogo

Buscar e detalhar anúncios, clonar, editar conteúdo, pausar, reativar, mudar modalidade e diagnosticar catálogo.

03

Preço, estoque e imagens

Preço efetivo, margem, estoque tradicional ou User Product e galeria com upload, adição, remoção e ordem.

04

Vendas e atendimento

Pedidos, envios, atrasos, perguntas, pós-venda, reclamações, devoluções e pendências de operação.

05

Growth e publicidade

Promoções, cupons, Buy Box, qualidade, campanhas Product Ads, métricas, gasto, ROAS e oportunidades.

06

Financeiro e controle

Faturamento, conciliação operacional, custos, margem, propostas, auditoria e acompanhamento de trabalhos.

CORREÇÃO RÁPIDA

Use o erro como próximo passo.

Não é necessário desconectar a loja do Mercado Livre para corrigir o cliente MCP.

Not logged in

Execute novamente o passo 02 e conclua Autorizar no navegador.

No authorization support detected

Atualize o plugin no passo 00 e use o reinício completo abaixo.

Ferramentas não aparecem

Feche e abra o Codex ou inicie uma nova tarefa depois do OAuth.

Loja errada

Liste as lojas e use exatamente o store_id escolhido. Trocar o login do HUB não desconecta sellers.

Recomeçar uma instalação incompleta ou antiga

O bloco limpa apenas a autenticação local do Codex, recria um único servidor hub e abre uma autorização nova. A loja continua conectada no painel.

npx.cmd -y @openai/codex@latest mcp logout hub npx.cmd -y @openai/codex@latest mcp remove hub npx.cmd -y @openai/codex@latest mcp add hub --url https://mcp.hubdoecom.com.br/api/mcp npx.cmd -y @openai/codex@latest mcp login hub npx.cmd -y @openai/codex@latest mcp list
Trocar o Codex para outra conta do HUB

Encerre somente a sessão OAuth local e inicie outro login. Na autorização, escolha “Entrar com outra conta do HUB”.

npx.cmd -y @openai/codex@latest mcp logout hub npx.cmd -y @openai/codex@latest mcp login hub

OUTROS AMBIENTES

O mesmo HUB, uma autorização por cliente.

Cada computador ou aplicativo de IA conclui o próprio OAuth sem compartilhar tokens.

01

Codex

Use as etapas desta página. Plugin e MCP têm funções diferentes e trabalham juntos.

02

ChatGPT

Em Apps ou Conectores, adicione um MCP personalizado e autorize o espaço correto.

03

Claude Code

Use um conector remoto compatível com OAuth e conclua a autorização no mesmo computador.

Compatível
04

Outros clientes

Endpoint Streamable HTTP com OAuth 2.0, PKCE S256 e tokens revogáveis.

Endpoint único

ENDPOINT REMOTO

https://mcp.hubdoecom.com.br/api/mcp