O que é MCP (Model Context Protocol) e para que serve no Bot do Afiliado?

MCP (Model Context Protocol) é um padrão aberto que permite que uma IA use ferramentas externas. O Bot do Afiliado expõe um servidor MCP, então a IA pode converter links e buscar produtos por você.

Preciso saber programar para usar o MCP do Bot do Afiliado no Claude ou ChatGPT?

Não. Nos clientes com suporte a OAuth remoto você adiciona a URL e faz login. Claude web, Desktop, Claude Code, Cursor e VS Code podem usar esse fluxo. Depois é só pedir em linguagem natural.

Qual módulo do Bot do Afiliado preciso para usar o MCP com IA?

O módulo Conexão IA e API, além dos módulos e permissões exigidos por cada ferramenta. A conexão pode usar OAuth ou API key.

O que a IA consegue fazer com o MCP do Bot do Afiliado?

Converter links, consultar produtos, preparar ofertas e gerenciar cupons e templates. O catálogo também documenta ferramentas de Userbot e campanhas, sujeitas à liberação.

O que é o MCP do Bot do Afiliado (ChatGPT e Claude)

Use o Bot do Afiliado dentro de IAs como Claude e ChatGPT via MCP (Model Context Protocol) — converta links e busque dados de produto em linguagem natural.

O MCP (Model Context Protocol) é um padrão aberto que deixa uma IA usar ferramentas externas. O Bot do Afiliado disponibiliza um servidor MCP remoto, então você pode converter links e buscar produtos direto de dentro do Claude, do ChatGPT e de outras IAs compatíveis — em linguagem natural.

Como funciona

O catálogo desta versão contém 23 ferramentas. Consulte os cards de ferramentas e configuração dos clientes. A lista efetiva da conexão depende da versão publicada, dos módulos e das permissões. As ferramentas de Userbot e campanhas estão sujeitas à liberação.

O núcleo de conversão, cupons e templates inclui:

Tool	O que faz	Equivale a
`convert_links`	Converte 1 ou vários links em links de afiliado	`POST /api/v1/convert-links`
`get_product`	Retorna título, preço, imagem, link e histórico	`POST /api/v1/product`
`create_offer_post`	Monta o post de oferta pronto (título, preço, cupom, link)	`POST /api/v1/execute` (`oferta`/`cupom`)
`search_products`	Busca produtos por palavra-chave, com filtro de preço e ordenação (Shopee, AliExpress, Amazon; Kabum/Magalu via `site`)	`POST /api/v1/search-products`
`run_command`	Roda um comando do bot (o mesmo executor do Telegram): `converter` (`/c`), `coringa`, `addcarrinho`, `encurtar`, `historico`, `promo`… aplicando o template do bot	`POST /api/v1/execute`
`get_bot_info`	Mostra o que o seu bot suporta: marketplaces com busca ativa, redes/domínios conversíveis e módulos (ex.: cupons)	`GET /api/v1/bot`
`list_coupons` / `add_coupon` / `remove_coupon` / `activate_coupon` / `list_coupon_categories`	Gerenciam os cupons do bot — listar (com paginação e filtro por categoria/status), cadastrar (com `convert_url` para já converter o link em afiliado, validade e início de vigência), remover e reativar	`…/api/v1/coupons*`
`get_template`	Lê os templates do bot — formato (oferta, cupom, rodapé) e mensagens de resposta (boas-vindas, status, sucesso, erro…); `keys_only` lista só as chaves	`GET /api/v1/templates`
`set_template`	Cria/atualiza um template — formato (`format.`) e mensagens de resposta seguras (`command.`, `status.`, `success.`, `message.link.`, `inline.`, `aliexpress.*`); erros/permissão e comandos admin ficam só no painel	`POST /api/v1/templates`

Conexão

Endpoint: https://app.botdoafiliado.com/mcp — ou, melhor, a URL do seu bot: https://app.botdoafiliado.com/mcp/SEU_BOT (o painel mostra a URL exata de cada bot). Com a URL por bot, o conector sempre fala com o bot certo, mesmo que você tenha vários na conta.
Autenticação:
- Login (OAuth) no Claude.ai e no ChatGPT (web/app) — você entra com a sua conta, sem API key. Use a URL do seu bot (/mcp/SEU_BOT) para escolher qual bot.
- OAuth remoto também pode ser usado no Claude Desktop, Claude Code, Cursor e VS Code. Veja as configurações atuais.
- Header X-API-Key com uma API key é alternativa em clientes que aceitam cabeçalhos. A chave já identifica o bot.
Transporte: Streamable HTTP (funciona com conectores remotos, sem instalar nada).

O que você pode pedir

Fale naturalmente — não precisa dizer “use o MCP” nem citar a ferramenta; a IA reconhece o pedido e age sozinha:

“Converta este link em afiliado: …”
“Pegue o preço e o título deste produto: …”
“Converta esta lista de links e me devolve os links finais.”
“Monte um post de oferta deste produto (com o cupom X): …”
“Me mostra produtos de cozinha na Shopee até R$100, do mais barato.”
“Busca fone bluetooth entre R$50 e R$150 no AliExpress.”

Na busca dá pra combinar marketplace + faixa de preço + ordenação, e a IA exibe a imagem de cada produto junto do preço e do link.

Campanhas, grupos e histórico

Quando as ferramentas de campanhas estiverem publicadas e disponíveis na sua conexão, o assistente poderá consultar as campanhas do workspace autorizado.

Listar campanhas: quantos grupos cada campanha tem, quantos estão abertos (com vaga e saudáveis), quantos membros e o link público. “Como estão minhas campanhas hoje?”
Detalhe da campanha: por id ou pelo slug do link personalizado, com o resumo dos últimos 7 e 30 dias: cliques, entradas, saídas, retenção, vendas e comissão. “Como está a campanha promo-tg?”
Métricas da campanha: série por dia (até 93 dias) ou por hora (até 7 dias) de cliques, entradas, saídas, permanência e churn. “Quantas pessoas entraram ontem?”
Grupos WhatsApp: membros, teto, lotação, saúde, incidentes abertos e as campanhas de cada grupo. “Quais grupos estão lotados ou com problema?”
Histórico de atividade: entradas e saídas por grupo, números que caíram ou voltaram, campanhas criadas ou arquivadas e incidentes. “O que aconteceu esta semana?”
Estatísticas de atividade: totais por tipo e por ação. “Quantos números caíram este mês?”

Tudo é leitura: essas ferramentas pedem só a permissão Ler. O link de convite completo de um grupo só aparece para quem também tem permissão de Gerenciar; para os demais ele vem mascarado. Entradas e saídas chegam agregadas por hora e por grupo, nunca por pessoa.

Próximos passos

Userbot

O catálogo inclui get_userbot_config, set_userbot_config, get_userbot_history e preview_userbot_rules. Eles consultam configuração e histórico, ajustam regras permitidas e fazem prévias sem publicação. Exigem os módulos e permissões correspondentes e dependem da versão publicada.