No ChatGPT, o servidor HilltopAds MCP é adicionado como um conector personalizado. Para adicionar conectores MCP personalizados, é necessário ativar o Developer mode do ChatGPT. Esse recurso está disponível apenas nos planos pagos e deve ser ativado antes de começar.
Como conectar no ChatGPT
1. Ative o Developer mode. Abra Settings → Security and login, localize a seção Developer mode e ative-a. Esse modo permite que o ChatGPT adicione conectores personalizados, como o HilltopAds MCP. Ele é identificado como ELEVATED RISK, pois esses conectores podem modificar dados — exatamente o que fazem as operações de escrita.
Etapa 1 – Ative o Developer mode em Settings → Security and login.
2. Abra o painel Plugins e clique no botão + para adicionar um novo conector.
Etapa 2 – Painel Plugins, botão +.
3. Preencha o formulário New Plugin:
Name — por exemplo, HilltopAds MCP
Connection — mantenha Server URL e cole
https://mcp.hilltopads.com/mcpAuthentication — selecione OAuth
Marque I understand and want to continue e clique em Create
Etapa 3 – Formulário New Plugin com a URL do servidor e autenticação OAuth.
4. Na tela Add HilltopAds MCP to ChatGPT, clique em Sign in with HilltopAds MCP.
Etapa 4 – Sign in with HilltopAds MCP.
5. Você será redirecionado para a página HilltopAds MCP Authorization. Cole a chave de API criada na etapa anterior e clique em Authorize. Não é necessário informar e-mail ou senha.
Etapa 5 – Cole sua chave de API na página de autorização da HilltopAds e clique em Authorize.
6. O ChatGPT mostrará o conector como conectado. Agora está tudo pronto para começar.
Etapa 6 – O conector está conectado e seus detalhes são exibidos.
Como usar no ChatGPT
Basta fazer suas solicitações em linguagem natural. O ChatGPT decidirá automaticamente qual ferramenta da HilltopAds deve utilizar. Por exemplo:
"What operations are available to me in HilltopAds MCP"
"List my campaigns and their ads."
O assistente lista as operações disponíveis para o seu nível de acesso.
"List my campaigns and their ads" o assistente apresenta um resumo do seu inventário.
Você também pode direcionar a solicitação explicitamente ao conector, anexando-o ao prompt e digitando, por exemplo:
"Show me my statistics for the last month by geo."
Anexando o conector HilltopAds MCP a uma solicitação.
Resultado: estatísticas do Advertiser agrupadas por GEO.
Criando uma campanha no ChatGPT
O conector também pode criar uma campanha para você. Basta dizer ao assistente o que deseja fazer. Ele reunirá as informações necessárias, mostrará exatamente o que será enviado e solicitará sua confirmação antes de executar qualquer operação de escrita.
Neste exemplo, o assistente também cria a campanha no estado Inactive, para que você possa revisá-la antes de começar a consumir orçamento. Essa é uma escolha padrão do assistente, não uma regra. Se desejar esse comportamento, informe isso explicitamente na sua solicitação.
1. Solicite a criação de uma campanha, por exemplo:
"I want to create a campaign."
O assistente listará as informações necessárias — nome da campanha, formato, modelo de cobrança, Landing URL, canal(is) de tráfego e lance (Bid) — e fornecerá um modelo em uma única linha para você preencher.
Etapa 1 – O assistente lista os dados necessários e apresenta um formato em uma única linha.
2. Se você não tiver certeza sobre algum valor, pergunte. Por exemplo:
"What channel names are available for pops according to documentation?"
O assistente responderá com base na documentação da HilltopAds.
Etapa 2 – Consultando os valores válidos; a resposta é baseada na documentação.
3. Envie os detalhes da campanha. O assistente apresentará novamente a configuração e solicitará sua confirmação:
Allow ChatGPT to use HilltopAds MCP?
Clique em See details para revisar a solicitação completa antes de autorizá-la.
Etapa 3 – Cartão de confirmação da operação de escrita. Use See details para revisar a solicitação.
4. A tela de detalhes exibe a solicitação campo por campo – formato, tipo, nome, URL, canais, lance e status de ativação. Clique em Allow para continuar.
Etapa 4 – A solicitação completa, campo por campo, antes da autorização.
5. O assistente confirmará que a campanha foi criada com sucesso e retornará o ID da campanha. Neste exemplo, ela permanece Inactive, portanto nenhum orçamento será consumido até que você a inicie.
Etapa 5 – Campanha criada com sucesso, com o novo ID da campanha; ela permanece inativa.
6. A nova campanha agora está disponível na sua conta HilltopAds, pronta para ser revisada, receber saldo e ser iniciada.
Etapa 6 – A campanha já está na sua conta HilltopAds (o tráfego permanecerá desativado até que você a inicie).