Ficanaz Link

O que é

O Ficanaz Link é um conector (um servidor MCP) que dá à sua IA acesso à sua própria conta do Mercado Livre por meio do Ficanaz: anúncios, preços, estoque, ritmo de vendas, promoções, vendas, perguntas e reclamações. É o mesmo Assistente que você tem dentro do Ficanaz, mas no chat que você já usa.

Você pode perguntar coisas como "quais anúncios ficam sem estoque esta semana?", "em quais promoções está a espreguiçadeira branca?" ou "quais perguntas tenho sem responder?". Se você pede uma mudança, a IA monta uma proposta e nada é aplicado até você confirmar.

Para usar, você precisa de uma conta Ficanaz com o Mercado Livre conectado.

Como conectar

O endereço do conector é:

https://ficanaz.com/api/mcp

No Claude

• Se o Ficanaz Link aparece no diretório de conectores do Claude, procure por "Ficanaz" e toque em Conectar.
• Se não, vá em Configurações → Conectores → Adicionar conector personalizado, dê o nome "Ficanaz Link", cole o endereço acima e toque em Adicionar. Depois toque em Conectar.

No ChatGPT

• Se o Ficanaz Link aparece no diretório de apps do ChatGPT, procure por "Ficanaz" e conecte por lá.
• Se não, ative o modo desenvolvedor em Configurações → Conectores (você precisa do Plus ou superior), crie um conector novo com o endereço acima e escolha autenticação OAuth.

Login e autorização

Ao conectar, sua IA manda você ao Ficanaz. Se a sessão não estiver aberta, você entra com a sua conta Ficanaz. Depois aparece uma tela de autorização que diz qual app pede acesso, com qual conta Ficanaz e o que ele vai poder fazer: ler seus anúncios, vendas, estoque, promoções, perguntas e reclamações, e propor mudanças que você confirma no chat. Toque em Autorizar e volte para a sua IA. Para testar, peça "quem sou eu?".

Sua senha e seu token do Mercado Livre nunca passam pelo Claude nem pelo ChatGPT: a conexão com o Mercado Livre é feita pelo Ficanaz, e a IA só vê o que as ferramentas devolvem.

O que ele pode fazer

As ferramentas se dividem em três grupos. O ciclo de uma mudança é sempre o mesmo:

• 1. A IA monta uma proposta com uma ferramenta de propostas. Isso ainda não mexe no Mercado Livre.
• 2. Você revisa no chat: quais anúncios, quais valores, o que muda.
• 3. Só quando você aprova, a IA chama confirm_run e a mudança é aplicada no Mercado Livre.
• 4. O Ficanaz lê de novo o anúncio para verificar como ficou e mostra para você. Uma proposta que você não confirma vence em 24 horas.

Leitura

Consultam sua conta. Não mudam nada.

• whoami · Quem você é no Ficanaz, se o Mercado Livre está conectado, quais permissões estão ativas e se o seu plano inclui o Link.
• list_my_listings · Seus anúncios, com filtros por status e por palavras do título.
• get_listing_live · O preço, o estoque e o status de um anúncio neste momento, lidos do Mercado Livre.
• get_listing_details · A ficha do anúncio: atributos, condições de venda, descrição e fotos.
• get_listing_360 · Tudo sobre um anúncio em uma só visão: vendas, visitas, promoções, perguntas, reclamações e publicidade.
• get_sales_summary · Seus totais de vendas por período: vendas, unidades, faturamento e comissões.
• get_sales_velocity · Em que ritmo cada anúncio vende (unidades dos últimos 7 e 30 dias).
• list_promotions · As campanhas e promoções do Mercado Livre disponíveis para a sua conta.
• get_item_promotions · Em quais promoções cada anúncio está, a que preço e por que um não entra.
• get_promotion_items · Os anúncios de uma campanha específica e o status de cada um.
• find_items_by_sku · Encontra anúncios pelo seu SKU.
• get_item_economics · Quanto sobra por unidade vendida: preço menos a comissão do Mercado Livre e o frete que você paga.
• get_catalog_status · O status no catálogo (quem ganha a buy box e o preço para ganhar informado pelo Mercado Livre).
• get_full_candidates · Quais anúncios estão no Full e quais vendem bem sem estar.
• get_decision_brief · Dados de várias fontes juntos para decidir o que colocar em oferta, o que repor ou o que revisar.
• get_shipping_overview · Envios pendentes, atrasados ou a despachar.
• get_saved_analyses · As análises que você já salvou no Ficanaz.
• get_account_health · Sua reputação de vendedor e as métricas dela.
• list_claims · Suas reclamações, com o motivo informado pelo Mercado Livre.
• get_claim · O detalhe de uma reclamação: mensagens, devoluções e ações disponíveis.
• list_unanswered_questions · As perguntas de compradores que você ainda não respondeu.
• list_ad_campaigns · Suas campanhas de Product Ads e as métricas delas, só leitura.
• get_order · O detalhe de uma venda.
• get_shipment · O detalhe e o status de um envio.
• get_buyer_messages · As mensagens com o comprador de uma venda.
• get_order_feedback · A qualificação de uma venda.
• get_listing_reviews · As opiniões de compradores sobre um anúncio.
• list_infractions · As infrações ou moderações que o Mercado Livre marcou nos seus anúncios.

Propostas e ajustes

Montam uma proposta para você revisar; não mexem no Mercado Livre até você confirmar. As regras que você salva ficam no Ficanaz e valem para as próximas propostas.

• propose_promotion_actions · Propõe incluir, ajustar ou tirar anúncios de promoções.
• plan_promotion_batch · Propõe um lote de mudanças de promoções para muitos anúncios de uma vez, segundo um critério.
• plan_price_update · Propõe mudar o preço de lista de um ou vários anúncios.
• propose_item_update · Propõe mudanças em um anúncio (por exemplo, estoque ou dados da ficha).
• update_listing_status · Propõe pausar ou reativar um anúncio.
• release_price_automation · Propõe desativar a automação de preços de um anúncio.
• send_buyer_message · Propõe uma mensagem ao comprador de uma venda.
• reply_claim · Propõe uma resposta em uma reclamação.
• reply_feedback · Propõe uma resposta à qualificação de uma venda.
• leave_promotion · Propõe tirar um anúncio de uma promoção.
• save_seller_rule · Salva uma regra sua (por exemplo, "nunca mais de 30% de desconto") que é respeitada nas próximas propostas.
• forget_seller_rule · Desativa uma regra que você salvou.

Execução

Aplicam no Mercado Livre o que você aprovou, ou mostram como ficou.

• answer_question · Publica a resposta a uma pergunta de um comprador, depois que você a revisou no chat.
• confirm_run · Aplica no Mercado Livre uma proposta que você aprovou e lê de novo para verificar o resultado.
• get_run · Mostra uma proposta: o que vai mudar ou, se já foi aplicada, o que o Mercado Livre respondeu.
• get_my_proposals · Lista suas propostas e o status de cada uma.

Permissões

Ler está sempre disponível. Para a IA poder mudar algo, você precisa ativar cada permissão em Ficanaz → Assistente → ⚙️ Permissões: Promoções, Preços, Estoque, Anúncios, Perguntas, Mensagens e qualificações, Reclamações e Envios. São as mesmas permissões do Assistente dentro do Ficanaz e valem igual para os dois. Se uma permissão está desligada, a ferramenta responde que ela está desativada e não faz nada.

Abrir as Permissões do Assistente (pede login).

Dados e privacidade

• Os dados pessoais dos compradores (nomes, telefones, e-mails, endereços) chegam cortados à IA.
• Cada consulta e cada mudança ficam registradas. Você as vê no Ficanaz Link, no menu do Ficanaz, junto com os apps que você autorizou.
• Ali você tira o acesso de cada app com Revogar. A revogação corta a autorização, mas uma sessão que já estava aberta pode continuar funcionando por cerca de 1 hora.
• O detalhe de quais dados tratamos e com quem está na Política de Privacidade.

Limitações

• Não exclui anúncios. Essa ação está bloqueada.
• Não muda nada no Product Ads: as campanhas podem ser lidas, e as mudanças você faz no Mercado Livre.
• Trabalha só com os dados que o Mercado Livre devolve. Se o Mercado Livre não dá um dado, a IA diz que não o tem em vez de inventar.
• O Mercado Livre aplica as próprias regras a cada mudança: o resultado final é o que se lê de novo depois de aplicar.

Se algo não funciona

• O Mercado Livre não está conectado: conecte em um clique em Integrações.
• Permissão desativada: ative em Assistente → ⚙️ Permissões.
• Seu plano não inclui o Link: veja a seção Planos, aqui embaixo.
• Para qualquer outra coisa, escreva para support@ficanaz.com.

Planos

O Ficanaz Link está incluído no plano Pro do Ficanaz. O que cada plano traz está em ficanaz.com. O Ficanaz não cobra por uso dentro do Link: a IA é a do seu Claude ou ChatGPT.