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.- ✓IdentidadeConfirme sua identidade
- ✓EspaçoAcesse seu espaço
- ✓Loja MLConecte a loja
- ✓CapacidadesConfira as capacidades
- 05Cliente MCPAutorize seu cliente
- 06ConsultaFaça a primeira consulta
- 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.
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.
- 01Confirme a loja no painelVerifique apelido e seller antes de sair do HUB.
- 02Abra Plugins no ChatGPTAtive o modo de desenvolvedor, se solicitado.
- 03Adicione seu pluginCole o endpoint e conclua o OAuth no navegador.
- 04Teste somente leituraUse
@HUBe 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.
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-oficialAdicione 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/mcpAutorize 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 hubConfirme 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 listAbra 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.
Confirme a loja.
Espere receber apelido e seller_id antes de interpretar qualquer leitura operacional.
Prepare sem executar.
Revise a loja, a capacidade usada, a mudança sugerida e o efeito esperado antes de decidir.
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.
Conta e diagnóstico
Lojas conectadas, saúde, prioridades, reputação, visitas, conversão, briefing e relatórios comparativos.
Anúncios e catálogo
Buscar e detalhar anúncios, clonar, editar conteúdo, pausar, reativar, mudar modalidade e diagnosticar catálogo.
Preço, estoque e imagens
Preço efetivo, margem, estoque tradicional ou User Product e galeria com upload, adição, remoção e ordem.
Vendas e atendimento
Pedidos, envios, atrasos, perguntas, pós-venda, reclamações, devoluções e pendências de operação.
Growth e publicidade
Promoções, cupons, Buy Box, qualidade, campanhas Product Ads, métricas, gasto, ROAS e oportunidades.
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.
Execute novamente o passo 02 e conclua Autorizar no navegador.
Atualize o plugin no passo 00 e use o reinício completo abaixo.
Feche e abra o Codex ou inicie uma nova tarefa depois do OAuth.
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 listTrocar 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 hubOUTROS AMBIENTES
O mesmo HUB, uma autorização por cliente.
Cada computador ou aplicativo de IA conclui o próprio OAuth sem compartilhar tokens.
Codex
Use as etapas desta página. Plugin e MCP têm funções diferentes e trabalham juntos.
ChatGPT
Em Apps ou Conectores, adicione um MCP personalizado e autorize o espaço correto.
Claude Code
Use um conector remoto compatível com OAuth e conclua a autorização no mesmo computador.
CompatívelOutros clientes
Endpoint Streamable HTTP com OAuth 2.0, PKCE S256 e tokens revogáveis.
Endpoint únicoENDPOINT REMOTO
https://mcp.hubdoecom.com.br/api/mcp