Módulo

MCP para afiliados: links e ofertas na conversa com a IA

O MCP para afiliados do Bot do Afiliado conecta seu bot ao ChatGPT, Claude e outros clientes compatíveis, para quem quer preparar links e ofertas por conversa. A IA usa as contas de afiliado e os formatos que você configurou no bot.

+ R$ 99/mêsSoma ao plano base (R$ 99/mês). Liga e desliga no painel, sem fidelidade.
Claude · conector Bot do Afiliado
Converta este link para a minha conta de afiliado: https://shopee.com.br/product/123456/789012
convert_links
ClaudeLink de afiliado gerado: https://s.shopee.com.br/EXEMPLO Este é o endereço para usar na divulgação.
Exemplo ilustrativo com produto e links fictícios. O retorno depende da configuração da loja no bot.

O que o módulo Conexão IA e API faz

Links com suas contas

Peça a conversão de um link ou de um lote com até 150 URLs. O bot usa os plugins e as rotas configurados para suas contas de afiliado.

Busca de produtos

Pesquise por termo, faixa de preço e ordenação nas lojas cobertas pela busca, desde que o conversor correspondente esteja ativo.

Oferta no seu formato

Monte o texto de uma oferta com links, cupom e chamada para ação usando o formato do bot. O resultado volta à conversa para revisão e publicação por você.

Cupons pela conversa

Com o módulo Cupons, consulte os registros e categorias. Cadastrar, remover e reativar cupons também exige permissão para gerenciar.

Consultas da operação

Consulte campanhas, métricas e histórico de atividade já registrados na sua organização. As ferramentas de campanhas são de leitura.

Acesso sob seu controle

Na conexão por login, escolha o bot e autorize as permissões. Consulte os apps conectados e desconecte cada um pelo painel.

Quais ferramentas a IA ganha com o MCP do Bot do Afiliado?

23 ferramentas no catálogo desta versão. A lista que o seu cliente recebe ao conectar depende da versão publicada, dos módulos do workspace e das permissões que você autorizar. Campanhas e Userbot estão sujeitos à liberação; confira a lista no seu cliente antes de usá-los.

Links e ofertas

Converter links

convert_links

Converte um link ou um lote usando as integrações do seu bot.

Consultar produto

get_product

Obtém título, preço, imagem e histórico quando a integração oferece esses dados.

Montar uma oferta

create_offer_post

Gera o texto da oferta com o template do bot; não é um disparo de broadcast.

Buscar produtos

search_products

Pesquisa produtos nos marketplaces habilitados para o bot.

Executar um comando

run_command

Executa os comandos permitidos de conversão, busca e geração de conteúdo.

Cupons

Listar cupons

list_coupons

Consulta cupons com filtros e paginação.

Consultar categorias

list_coupon_categories

Lista as categorias de cupons cadastradas.

Cadastrar cupom

add_coupon

Adiciona um cupom com condições e validade; exige permissão de escrita.

Remover cupom

remove_coupon

Remove um cupom do bot; exige permissão de escrita.

Ativar cupom

activate_coupon

Reativa um cupom; exige permissão de escrita.

Configuração

Ler templates

get_template

Consulta os modelos de texto usados nas mensagens do bot.

Editar template

set_template

Atualiza templates permitidos; exige permissão de escrita.

Conhecer o bot

get_bot_info

Consulta os recursos e integrações disponíveis para o bot conectado.

Userbot

Consultar Userbot

get_userbot_config

Lê as configurações do monitoramento de canais.

Configurar Userbot

set_userbot_config

Altera as configurações permitidas; exige permissão de escrita.

Consultar histórico do Userbot

get_userbot_history

Consulta as mensagens processadas e seus resultados.

Testar regras

preview_userbot_rules

Mostra como as regras tratariam um texto, sem publicá-lo.

Campanhas e grupos

Listar campanhas

list_campaigns

Consulta as campanhas do workspace autorizado.

Detalhar campanha

get_campaign

Consulta grupos, cliques, entradas, saídas e atribuição da campanha.

Comparar métricas

campaign_metrics

Consulta uma série por dia ou por hora no período permitido.

Consultar grupos

list_whatsapp_groups

Consulta vagas, saúde e incidentes; convites são mascarados sem escrita.

Consultar atividade

activity_history

Consulta eventos da operação no período selecionado.

Resumir atividade

activity_stats

Resume a atividade por tipo e ação dentro do workspace.

Como o MCP para afiliados participa da sua rotina?

O MCP é o protocolo que permite a um assistente de IA chamar ferramentas do seu bot. Na prática, você pode pedir a conversão de um produto durante a conversa e receber o resultado da integração com a loja. As contas de afiliado, as rotas e os formatos continuam sendo os que você configurou no Bot do Afiliado.

Isso ajuda quando a pesquisa, a escolha do produto e a preparação do texto já acontecem no ChatGPT ou no Claude. A conexão leva as tarefas do bot para essa conversa. O guia sobre MCP explica o funcionamento do conector, e o catálogo desta página mostra as ferramentas que o servidor oferece.

Que tipo de pedido a IA consegue atender?

Um pedido como “busque garrafas térmicas na Shopee e ordene pelo menor preço” pode usar search_products. A busca aceita filtros e depende de um conversor ativo para a loja. Shopee, AliExpress e Amazon são as opções da busca geral; Kabum e Magalu podem ser solicitadas especificamente. O Mercado Livre participa da conversão de links e da consulta de produto por URL, mas não dessa busca.

Se você já tem os produtos, pode pedir “converta estes links com a minha conta” e usar convert_links, com até 150 URLs por chamada. A consulta por get_product traz os dados disponíveis para aquele produto. Preço, imagem e demais campos dependem do que a loja fornece; um dado ausente precisa continuar ausente, sem ser completado por suposição.

O que acontece depois de montar uma oferta?

A ferramenta create_offer_post prepara o texto usando o formato do bot. Você pode informar os links, um código de cupom e a chamada para ação desejada. O retorno serve para revisar título, condições e endereço antes da divulgação. Os exemplos de pedidos à IA mostram como dar esse contexto.

Essa ferramenta não envia a mensagem a um canal. Quando a rotina pede prévia visual e publicação em destinos autorizados, o módulo Ofertas oferece o Postador do painel. Informar um código no texto da oferta também é diferente de cadastrar um cupom para o menu do bot: o cadastro usa as ferramentas próprias de Cupons.

Qual é a diferença entre conectar por login e por chave?

No fluxo por login, o cliente abre a autorização, você entra pela Central do Afiliado e escolhe qual bot conectar. A tela informa o acesso solicitado. As permissões concedidas e o seu papel na organização definem o que o assistente pode consultar ou alterar. Senha e token do Telegram não precisam ser colados na conversa.

Uma API key é a alternativa para clientes que aceitam a credencial no cabeçalho da conexão. A mesma chave pode ser usada na API REST e no MCP; seu nível limita as operações permitidas. Essa escolha é útil para uma configuração local ou integração mantida por você. Para encerrar um acesso, desconecte o app autorizado por login ou revogue a chave utilizada naquele cliente.

Todas as ferramentas ficam disponíveis para qualquer operação?

O catálogo reúne 23 ferramentas, mas ter a conexão não substitui módulos, permissões ou dados cadastrados. As cinco ferramentas de cupons dependem do módulo Cupons; criar, remover ou reativar registros pede acesso de gerenciamento. A combinação está descrita no Combo IA e Cupons.

As ferramentas do Userbot dependem desse módulo, que está em piloto controlado e fora do checkout público. Já as consultas de campanhas e atividade leem o que existe na sua organização. Elas ajudam a responder perguntas sobre a operação registrada, sem criar campanhas nem transformar uma consulta em envio de mensagens.

Quando usar a API em vez da conversa com a IA?

A conversa atende pedidos que mudam conforme o contexto: selecionar produtos, preparar uma oferta ou consultar cupons. Um sistema próprio pode preferir enviar requisições com estrutura fixa e tratar cada resposta por código. É o caso de um site ou de uma automação que recebe listas de URLs.

A API de links de afiliado apresenta esse segundo caminho, com autenticação, lotes, script para sites e webhooks. Ela e a Conexão IA e MCP são duas formas de usar o mesmo módulo Conexão IA e API. Usar as duas interfaces não cria uma segunda cobrança pelo módulo.

Como conectar Claude, ChatGPT, Cursor ou VS Code ao seu bot?

  1. No painel do Bot, abra Configuração › API e IA (MCP) e copie a URL do bot desejado.
  2. Adicione essa URL ao seu cliente. A URL geral também aceita conexão: https://app.botdoafiliado.com/mcp.
  3. Faça login na Central do Afiliado, confira o bot e as permissões na tela de autorização e conclua a conexão.
  4. Peça a lista de ferramentas disponíveis e teste a conversão de um link.

Use a URL específica mostrada no painel para cada bot. Não envie sua senha, token do Telegram ou API key numa conversa com a IA.

Claude · web e Desktop

Abra Personalizar (Customize) → Conectores, adicione um conector personalizado com a URL do bot e conecte sua conta. Em organizações, o responsável pode precisar habilitar o conector.

Passo a passo do Claude · Documentação oficial

ChatGPT

No ChatGPT web → Configurações → Apps, confira a disponibilidade de apps personalizados e do modo desenvolvedor. Em um workspace, o administrador pode precisar habilitar o acesso. Crie o app MCP remoto com a URL do bot, escolha OAuth e autorize na Central do Afiliado. As ações de leitura e escrita disponíveis dependem do plano e das permissões da organização.

Passo a passo do ChatGPT · Documentação oficial

Claude Code
claude mcp add --transport http bot-do-afiliado https://app.botdoafiliado.com/mcp

Depois, use /mcp no Claude Code para autenticar. Documentação oficial.

Cursor

Em .cursor/mcp.json, use a configuração abaixo. Você pode trocar a URL geral pela URL exata do bot, copiada do painel.

{
  "mcpServers": {
    "bot-do-afiliado": {
      "url": "https://app.botdoafiliado.com/mcp"
    }
  }
}

Ative o servidor no cliente e conclua o login OAuth que ele pedir. No mcp-remote, o navegador abre para a autorização.

Documentação do Cursor
VS Code

Em .vscode/mcp.json, use a configuração abaixo. Você pode trocar a URL geral pela URL exata do bot, copiada do painel.

{
  "servers": {
    "bot-do-afiliado": {
      "type": "http",
      "url": "https://app.botdoafiliado.com/mcp"
    }
  }
}

Ative o servidor no cliente e conclua o login OAuth que ele pedir. No mcp-remote, o navegador abre para a autorização.

Documentação do VS Code
Cliente local via mcp-remote

Em Configuração MCP do cliente (requer Node.js), use a configuração abaixo. Você pode trocar a URL geral pela URL exata do bot, copiada do painel.

{
  "mcpServers": {
    "bot-do-afiliado": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.botdoafiliado.com/mcp"
      ]
    }
  }
}

Ative o servidor no cliente e conclua o login OAuth que ele pedir. No mcp-remote, o navegador abre para a autorização.

Documentação do Cliente local via mcp-remote

Como ativar o módulo Conexão IA e API

  1. Ative o módulo

    Entre pela Central do Afiliado e abra Conta › Assinaturas. O dono da organização seleciona Conexão IA e API junto do plano base.

  2. Confira as contas do bot

    Em Configuração › Plugins, conecte e valide as lojas que você pretende usar. A IA utiliza essas mesmas configurações para converter links.

  3. Escolha o cliente de IA

    Em Configuração › API e IA (MCP), abra IA (MCP) e copie a URL do servidor. Use o guia do cliente escolhido para adicionar o conector; apps locais também podem usar chave de API.

  4. Autorize e faça um pedido

    No fluxo por login, escolha o bot e confira as permissões na autorização. Envie um link de produto à IA e revise o resultado devolvido pela ferramenta.

Para quem é o módulo Conexão IA e API

Combina com

Perguntas frequentes sobre o módulo Conexão IA e API

Preciso saber programar para conectar a IA?

Não para usar um cliente com conector MCP por login. Você adiciona a URL do bot, autoriza o acesso e faz pedidos em linguagem natural.

Preciso colar uma API key no ChatGPT ou no Claude?

A conexão por login dispensa API key. A chave é uma alternativa para clientes que aceitam cabeçalhos, como as configurações de apps locais mostradas no painel.

Funciona em qualquer conta do ChatGPT?

A disponibilidade de conectores MCP depende da conta, do plano e das regras da organização no ChatGPT. Pode ser necessário habilitar o modo desenvolvedor; confira o guia de conexão antes de começar.

A IA publica a oferta ou dispara broadcast sozinha?

Não. As ferramentas preparam links e o texto da oferta, mas não publicam no canal nem disparam broadcast. A publicação é uma ação separada da sua operação.

Como a IA escolhe entre meus bots?

Na autorização por login, você escolhe o bot. O painel também mostra a URL específica dele; com essa URL, o acesso precisa corresponder ao bot autorizado.

Gerenciar cupons está incluído na conexão?

As ferramentas existem no servidor MCP, mas exigem o módulo Cupons. Alterar os registros também depende das permissões concedidas e do papel da pessoa ou nível da chave.

Como retiro o acesso de uma IA?

Em Configuração › API e IA (MCP), use Desconectar na seção Conexões de IA ativas para conexões por login. Se o cliente usa API key, revogue a chave correspondente.

MCP e API de links são cobrados separadamente?

Não. São duas formas de usar o mesmo módulo Conexão IA e API. Você escolhe a conversa com a IA, chamadas por código ou ambas, com o mesmo módulo.

Para se aprofundar

Pronto pra ativar o módulo Conexão IA e API?

No painel, abra Conta › Assinaturas, marque Conexão IA e API e conclua o pagamento. O módulo pode ser desligado quando você quiser.