adPluga

MCP

Ligar um agente de IA

A adPluga tem um servidor MCP (Model Context Protocol). Um assistente ligado a ele pode registar e verificar o seu site, criar espaços de anúncio, pedir deals directos a anunciantes, entrar no Pool, enviar imagens e criar campanhas e anúncios, sempre com as permissões que lhe der.

1. Ligar com a sua conta

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

2. Ou com uma chave

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_•••"

O que o agente pode fazer

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, create_slot e get_slot_tag (âmbitos property:write, property:verify, slot:write e slot:read).
  • Deals directos: browse_marketplace encontra anúncios de anunciantes, request_handshake pede o deal e list_deals mostra os aprovados; os anunciantes respondem com approve_handshake ou reject_handshake (marketplace:read, handshake:read, handshake:write e deal:read).
  • 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, 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.

Limites

  • 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.