Ligar um agente de IA

O claude.ai, o ChatGPT e o Claude Code pedem-lhe para entrar na adPluga e escolher as permissões e o modo (Teste por omissão). Não há chave para copiar, e a ligação desliga-se em Definições › Assistentes de IA.

• No claude.ai: Personalizar › Conectores › Adicionar conector personalizado, com o URL https://api.adpluga.com/v1/mcp e sem cliente OAuth próprio.
• No ChatGPT, na web: Plugins › + › Add custom MCP server, com o mesmo URL e autenticação OAuth.

No Claude Code, adicione o servidor e escreva /mcp para entrar:

claude mcp add --transport http adpluga https://api.adpluga.com/v1/mcp

Para clientes que não entram por OAuth, como o Cursor, ou para automatizar: em Definições › Chaves crie uma chave de integração com o âmbito mcp:use e os âmbitos do que o cliente pode fazer, e envie-a no header Authorization. Comece com uma chave ak_test_: em modo de teste nada é cobrado nem pago.

claude mcp add --transport http adpluga https://api.adpluga.com/v1/mcp \
  --header "Authorization: Bearer ak_test_•••"

Cada ferramenta chama um endpoint da API da adPluga e precisa do âmbito desse endpoint na chave.

• Monetizar um site ou app: create_property, verify_property (com o código do espaço já colado na página inicial, depois de update_property com o método tag), send_verification_email, create_slot e get_slot_tag (âmbitos property:write, property:verify, slot:write e slot:read).
• Saúde da integração: get_integration_status diz se o código de um espaço está a servir e o que recebeu nas últimas 24 horas (mostrados, cliques, filtrados e porquê, perdidos, atrasos) e marca o espaço como parado ao fim de um dia sem eventos (slot:read).
• Deals directos: browse_marketplace encontra anúncios de anunciantes e request_handshake pede o deal, respondido na hora pelas regras do anunciante (aprovado, em revisão ou à espera de provas); list_deals mostra os aprovados; quem recebe um pedido responde com approve_handshake ou reject_handshake (marketplace:read, handshake:read, handshake:write e deal:read).
• Curadoria: list_curation_candidates lista os anúncios de outras marcas que podem aparecer nos seus espaços e set_slot_ad_controls bloqueia ou limita os anúncios de um espaço, lidos com get_slot_ad_controls; block_brand tira todos os anúncios de uma marca, também os que ela fizer depois, de todos os espaços, unblock_brand desfaz e list_blocked_brands lista as bloqueadas (slot:read e slot:write).
• Pool: set_pool_participation deixa anúncios de outros anunciantes preencher os seus espaços com repartição de receita (tenant:update; get_account lê o estado com tenant:read).
• Anunciar: create_campaign, copy_campaign (passa uma campanha e os anúncios de Teste para Live), upload_image, create_ad e activate_campaign (campaign:write, asset:write e ad:write).
• Resultados: get_daily_stats e get_campaign_report (reports:read).
• Dúvidas: search_docs pesquisa esta documentação e não precisa de outro âmbito.

• A ligação, ou a chave, age como quem a criou: o assistente nunca pode fazer mais do que essa pessoa, e perde uma permissão quando ela a perde.
• Facturação, carteira, pagamentos, membros e gestão de chaves não estão ao alcance do servidor MCP, sejam quais forem as permissões.
• Verificar um site continua a exigir o token publicado no seu domínio, e todos os anúncios passam por revisão antes de servir.
• O upload_image aceita PNG, JPEG, WebP ou GIF até 2 MiB.
• Repetir uma criação com os mesmos argumentos devolve o primeiro resultado em vez de criar outro.
• Cada conta pode fazer 120 chamadas por minuto.
• Em modo de teste o marketplace só lista anúncios de teste, por isso pedir deals reais exige uma ligação ou chave em Live.