Segurança e controle

O que o seu agente pode fazer na sua conta, o que ele nunca vê e como você corta o acesso.

Estes controles reduzem o risco, não o eliminam: quem autoriza o agente a agir é você. Veja a Política de uso.

O que o agente nunca vê

O token do Mercado Livre fica em cofre criptografado, é renovado sozinho e nenhuma tool o devolve. connection_status mostra só a validade (token_expires_at) e se a conexão está ok ou pede reconnect_required.

O que é segredo do seu lado:

A URL do painel

É uma URL por pessoa, por espaço de trabalho. Ela alcança todas as contas conectadas desse espaço de trabalho. Trocar de espaço de trabalho no painel não muda o espaço a que o agente já está ligado. Estreitar a conexão para uma só conta, com /a/<apelido> no fim da URL, continua sendo a mesma credencial, não uma segunda.

Os dois interruptores de escrita

Em Conectores → a conta → Segurança de escrita. Valem na hora, sem botão de salvar:

• Somente leitura (bloqueia todas as escritas)
• Exigir confirmação explícita em toda escrita

O agente consegue ler o estado atual com connection_status (read_only, require_confirm).

Uma API key criada com Somente leitura também não escreve, mesmo com o conector liberado.

Como funciona a confirmação

Com a confirmação exigida, a primeira chamada de escrita não executa nada e devolve:

Esta ação exige confirmação explícita. Repita a chamada com confirm=true após confirmar com o usuário.

O agente pergunta a você e repete a mesma chamada com confirm=true.

Seja claro sobre o que isso é: confirm é um parâmetro, não um código enviado a você. A trava obriga o agente a parar e perguntar; ela não impede um agente mal instruído de mandar confirm=true direto. Para garantia de verdade use Somente leitura, e mantenha ligada a aprovação de ações do seu cliente (clientes como Claude e ChatGPT costumam pedir sua permissão antes de tools marcadas como destrutivas).

Sempre exigem confirmação, com o interruptor ligado ou não: delete_question, split_shipment e resolve_claim.

Marcadas como destrutivas para o cliente: update_item, update_stock, delete_question, split_shipment e resolve_claim.

O que o servidor recusa sozinho

Conector em somente leitura devolve:

Este conector está em modo somente-leitura. Desative o modo no painel para permitir escritas.

Auditoria

Em Auditoria no painel: toda tentativa de escrita, com Quando · Ação · Conta · Resultado · Quem · Detalhe, com filtros e exportação. Quem diz quem pediu: você (com o cliente de IA, quando conhecido), uma chave de API pelo nome ou, em organizações, o membro. Os registros ficam por 24 meses.

O resultado é um de quatro:

Uma escrita barrada também consome a cota do dia: a cota é verificada antes da permissão (veja Cota do plano Grátis).

Uma leitura recusada por cota não vira linha de auditoria — ela aparece só no Uso.

Os valores. Quando a escrita altera um anúncio, um estoque ou uma reclamação, a linha guarda cada campo alterado como o que era antes → o que foi enviado: o antes, lido do marketplace no momento da ação; o depois, o valor que o mcplace enviou. Os campos são preço, estado, quantidade disponível e condição do anúncio, quantidade por depósito e estado e etapa da reclamação; de outros campos do anúncio fica só quantos foram alterados. Uma escrita que não chegou a ser feita pode trazer só o antes, ou nenhum valor. Nunca guardamos token, número de documento, texto de mensagem, resposta ou nota, nem dados dos seus compradores. Dos demais parâmetros fica só uma impressão digital (hash).

Esses valores são o seu histórico, não cache. Se você revogar o mcplace no Mercado Livre ou excluir a sua conta, os valores são apagados e a linha fica, com a marca de que os valores foram removidos. Desconectar a conta pelo painel não apaga o histórico.

Mudar os interruptores, rotacionar a URL e desconectar também ficam registrados.

Se a URL vazar

Gire a URL em Seu agente. Girar a URL corta na hora toda conexão que usa a atual, inclusive as estreitadas com /a/ ou /c/. Tenha onde colar a nova antes de girar. A antiga para de funcionar na hora, e todo agente configurado com ela precisa receber a nova.

API key não tem rotação: revogar em API keys e criar outra. Quem usa a chave revogada para na hora.

Cortar o acesso

Pelo painel — Desconectar conta. Apaga o token do Mercado Livre do cofre e desconecta a conta. O cache restante expira em até 60 segundos.

A autorização dada ao mcplace continua listada dentro do Mercado Livre até você removê-la por lá. Para encerrar dos dois lados, remova também o mcplace nos aplicativos autorizados da sua conta do Mercado Livre.

Pelo Mercado Livre. Se você remover a autorização por lá, o mcplace detecta na verificação seguinte, que roda a cada 6 horas: destrói o token, invalida o cache, apaga os valores da auditoria daquele conector e suspende o conector. A detecção pode levar até esse prazo.

Para apagar a conta inteira ou exportar seus dados, veja LGPD.

Regras do Mercado Livre que o agente não contorna

• Sem mensagem automática ou padronizada no pós-venda. O Mercado Livre bloqueia e sua conta corre risco. O envio é limitado a 8 mensagens por minuto.
• Etiquetas saem como o Mercado Livre entrega, sem alteração.
• Ads é somente leitura.
• Só os seus dados. Nada de comparar ou cruzar com outras lojas.