Chaves de API

Para que servem as chaves de API

As chaves de API servem para conexões de longa duração dos seus próprios agentes e scripts quando não é prático entrar com OAuth pelo navegador. Fazer login continua sendo a forma normal de conectar um app de IA como Claude ou ChatGPT. Veja Configuração do MCP para essa configuração.

As chaves usam a mesma conta e conexão com a Meta do app web e exigem acesso ao MCP, à CLI e à API na sua conta. Elas funcionam em redes diferentes.

Criar uma chave

Abra Account > MCP, CLI & API e escolha Create API Key em API Keys.
Dê um nome à chave para reconhecer o que a usa.
Marque a confirmação de que a chave é para uma pessoa e não deve ser compartilhada, depois crie a chave.
Copie o segredo adk_ e guarde em um lugar privado. Ele é exibido apenas uma vez.

Usar uma chave com o MCP

Envie Authorization: Bearer adk_... para https://adsuploader.com/api/mcp. Para um cliente MCP que aceita cabeçalhos personalizados, a configuração pode ser assim:

{
  "mcpServers": {
    "ads-uploader": {
      "url": "https://adsuploader.com/api/mcp",
      "headers": { "Authorization": "Bearer adk_..." }
    }
  }
}

Substitua adk_... pela sua chave e mantenha a configuração privada.

Usar uma chave com a CLI

Defina ADS_API_KEY nas configurações de segredos do servidor ou do sistema de CI. Ela tem prioridade sobre as credenciais salvas em ~/.config/adsuploader/credentials.json. Para salvar uma chave localmente, rode:

ads login --api-key

Cole a chave no prompt de entrada oculta ou passe pelo stdin. A CLI verifica a chave antes de salvar. Evite colocar o segredo no comando, onde ele pode aparecer no histórico do shell.

Rode ads whoami para conferir o método de autenticação. ads config também mostra o método; só o prefixo da chave é exibido.

Uma chave por pessoa

Cada conta pode ter uma chave ativa por padrão, para uma pessoa. Entre em contato com o suporte se precisar de mais chaves; os administradores podem aumentar o limite para até 10. Adicione uma vaga na equipe para outra pessoa. Nunca compartilhe uma chave: o Ads Uploader pode revogar uma chave usada por mais de uma pessoa.

As chaves não expiram

As chaves continuam válidas até serem revogadas. Chaves sem uso são revogadas após 90 dias, e enviamos um email quando isso acontece. O tempo em que seu plano está pausado não conta para esses 90 dias.

Revogar uma chave

Abra Account > MCP, CLI & API, encontre a chave em API Keys e escolha Revoke. As solicitações que usam essa chave vão parar de funcionar.

ads logout só remove a chave salva daquela máquina; ele não revoga a chave. Ele não consegue remover ADS_API_KEY, então remova essa variável do ambiente ou das configurações de segredos também.

Os logins pelo navegador aparecem separadamente em MCP and CLI-Connected AI Apps. Escolha Revoke ali para revogar uma conexão da CLI ou de um app de IA.

Documentação