Conectar um assistente de IA

Conecte um assistente de IA ao Gloriads e faça perguntas sobre a sua conta com as suas próprias palavras.

O assistente vê exatamente o que a API do Gloriads vê, e não altera nada na sua conta.

O que o assistente pode ver

• Tudo o que a API vê, e nada mais.
• Nada que ele possa alterar: nenhuma configuração, nenhuma cobrança.
• Seus dados saem, sim, do Gloriads. Conecte apenas um assistente em que você confia: depois que ele leu a sua conta, desconectá-lo (Configurações → API → Aplicativos conectados) impede qualquer nova leitura, mas não desfaz o que ele já leu.

O que você pode perguntar

• “Como foram meus anúncios no mês passado e em qual marketplace eu gastei mais?”
• “Meu ACOS está melhor do que no mês anterior?”
• “Quais produtos tiveram o pior ACOS nos últimos 30 dias?”
• “Mostre meu gasto dia a dia neste mês.”
• “Liste minhas campanhas pausadas na Alemanha.”
• “Quais palavras-chave esta campanha segmenta?”
• “O que as minhas regras alteraram nesta semana, lance por lance?”

O assistente lê os mesmos números do seu painel: a lista do que ele pode ler está em O que a API lê.

O endereço, e o que cada assistente precisa

Um endereço, o mesmo para todos os assistentes:

https://gloriads.com/api/mcp

Qualquer outra ferramenta compatível com servidores MCP personalizados pode usar o mesmo endereço.

Está tudo em uma única página no aplicativo — Configurações → API: o endereço, os comandos prontos e as suas chaves. Cada bloco tem um botão Copiar.

claude.ai

1. No claude.ai, abra Personalizar no menu à esquerda.

2. Abra a aba Conectores.

3. Clique em Adicionar e depois em Adicionar conector personalizado.

4. Dê o nome Gloriads, cole https://gloriads.com/api/mcp e clique em Continuar.

5. Não altere nada na página seguinte: o claude.ai detectou que o Gloriads faz a sua entrada e publica a sua própria identidade. Clique em Adicionar.

6. Clique em Conectar.

7. Entre no Gloriads se for solicitado.

8. Confira o aplicativo que está pedindo acesso e clique em Permitir.

9. Você volta para o claude.ai. Na página do conector, em Permissões de ferramentas, escolha Sempre permitir: o Claude passa a ler os seus números sem perguntar toda vez, e este conector não pode fazer mais nada.

Em uma conversa, ative o conector se o aplicativo pedir e faça a sua pergunta.

Pergunte ao Haiku. Ele é o modelo do Claude mais rápido e mais barato, e ler os seus números não exige nada além disso. Escolha-o no menu de modelos da conversa.

Uma conta gratuita do Claude pode adicionar um conector personalizado.

Para desconectá-lo, abra Configurações → API → Aplicativos conectados no Gloriads e escolha Desconectar. Ele para de ler os seus números na hora.

Claude Desktop

O Claude Desktop usa os mesmos conectores que o claude.ai, então não há mais nada a instalar: adicione o conector em qualquer um dos dois, entre na sua conta e clique em Permitir. Ele passa a funcionar nos dois.

ChatGPT

O ChatGPT não se conecta como o Claude: os servidores personalizados dele ficam atrás do modo de desenvolvedor, oferecido apenas nos planos pagos do ChatGPT. Este é o caminho completo.

1. Nas configurações do ChatGPT, ative o modo de desenvolvedor.

2. Abra Plugins e depois Novo plugin.

3. Nome: digite Gloriads. O ícone e a descrição são opcionais.

4. Conexão: mantenha URL do servidor e cole https://gloriads.com/api/mcp.

5. Autenticação: escolha OAuth. Não há nada para preencher abaixo — o Gloriads publica as suas configurações nesse endereço, e o ChatGPT as lê.

6. Marque Eu entendo e quero continuar — o ChatGPT mostra esse aviso para todo servidor personalizado, inclusive o nosso — e clique em Criar.

7. O ChatGPT abre o Gloriads: entre na sua conta se for solicitado, confira se o aplicativo que pede acesso é o ChatGPT e clique em Permitir.

8. Em uma conversa, ative o plugin antes de fazer a primeira pergunta.

9. Escolha o quanto o ChatGPT pode fazer sozinho, em Configurações → Plugins → Gloriads → Permissões. Permitir ações de leitura é suficiente: este conector só pode ler. Permitir todas as ações é marcado como risco elevado e não traz nenhuma vantagem aqui.

Para desconectá-lo, abra Configurações → API → Aplicativos conectados no Gloriads e escolha Desconectar, exatamente como no claude.ai.

Claude Code

Crie uma chave em Configurações → API → Criar uma chave, dê a ela o nome “Claude Code” e copie-a. Ela é mostrada uma única vez.

Depois execute isto em um terminal, com a sua chave no lugar de YOUR_API_KEY:

claude mcp add --transport http gloriads https://gloriads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

• Confira com claude mcp list, ou /mcp dentro do Claude Code.
• O servidor é adicionado ao projeto atual. Acrescente --scope user para usá-lo em todos os projetos.
• Para removê-lo: claude mcp remove gloriads.

Cursor

Coloque a sua chave na variável de ambiente GLORIADS_API_KEY e cole isto em ~/.cursor/mcp.json (todos os seus projetos) ou em .cursor/mcp.json (um projeto):

{
  "mcpServers": {
    "gloriads": {
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GLORIADS_API_KEY}"
      }
    }
  }
}

O Cursor lê a chave nessa variável, então o arquivo nunca a contém. Defina a variável antes de abrir o Cursor.

VS Code

Abra MCP: Open User Configuration na Paleta de Comandos (todos os seus projetos), ou crie .vscode/mcp.json em um projeto, e adicione:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gloriads-api-key",
      "description": "Gloriads API key",
      "password": true
    }
  ],
  "servers": {
    "gloriads": {
      "type": "http",
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gloriads-api-key}"
      }
    }
  }
}

O VS Code pede a chave na primeira vez que o servidor inicia e a memoriza, então o arquivo nunca a contém.

As ferramentas que ele usa

O assistente escolhe a ferramenta certa para a sua pergunta. Cada ferramenta lê uma parte da API.

Bom saber

• Os mesmos números do aplicativo. Cada resposta informa o período e a moeda usados, e avisa quando um número está incompleto.
• Uma chave lê a sua conta inteira. Mantenha-a longe de arquivos compartilhados e revogue-a em Configurações → API no dia em que parar de usar o assistente.
• Limites compartilhados com a API: 60 requisições por minuto e 10.000 por dia para a sua conta. Uma pergunta pode custar várias requisições. Veja Limites e erros.
• Teste sem conta em uma ferramenta de desenvolvimento: a chave pública de demonstração da referência da API também funciona aqui e lê os números fictícios da conta de demonstração.