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 servidor MCP é um wrapper sobre a nossa API. Ele expõe estes tools:
| 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. - Header
X-API-Keycom uma API key no Claude Desktop, Claude Code e Cursor (requer o módulo de API). A chave já identifica o bot.
- 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 (
- 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.