Chiavi API

A cosa servono le chiavi API

Le chiavi API servono per connessioni di lunga durata dei tuoi agenti e script quando l'accesso OAuth tramite browser non è pratico. L'accesso resta il modo normale per collegare un'app di IA come Claude o ChatGPT. Per configurarlo, vedi Configurazione via MCP.

Le chiavi usano lo stesso account e la stessa connessione Meta dell'applicazione web e richiedono l'accesso a MCP, CLI e API sul tuo account. Funzionano da reti diverse.

Crea una chiave

Apri Account > MCP, CLI & API e scegli Create API Key in API Keys.
Assegna un nome alla chiave per riconoscere cosa la usa.
Spunta la conferma che la chiave è destinata a una sola persona e non deve essere condivisa, poi creala.
Copia il segreto adk_ e conservalo in un luogo privato. Viene mostrato una sola volta.

Usa una chiave con l'MCP

Invia Authorization: Bearer adk_... a https://adsuploader.com/api/mcp. Per un client MCP che supporta header personalizzati, la configurazione può essere così:

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

Sostituisci adk_... con la tua chiave e mantieni privata la configurazione.

Usa una chiave con il CLI

Imposta ADS_API_KEY nelle impostazioni dei segreti del server o del sistema CI. Ha la precedenza sulle credenziali salvate in ~/.config/adsuploader/credentials.json. Per salvare invece una chiave in locale, esegui:

ads login --api-key

Incolla la chiave nel prompt con input nascosto oppure passala tramite stdin. Il CLI la verifica prima di salvarla. Evita di inserire il segreto nel comando, dove può comparire nella cronologia della shell.

Esegui ads whoami per verificare il metodo di autenticazione. Lo mostra anche ads config; della chiave viene visualizzato solo il prefisso.

Una chiave per persona

Ogni account può avere una chiave attiva per impostazione predefinita, per una persona. Contatta il supporto se ti servono più chiavi; gli amministratori possono aumentare il limite fino a 10. Aggiungi un posto nel team per qualcun altro. Non condividere mai una chiave: Ads Uploader può revocare una chiave usata da più persone.

Le chiavi non scadono

Le chiavi restano valide finché non vengono revocate. Le chiavi inutilizzate vengono revocate dopo 90 giorni e ti inviamo un'email quando succede. Il tempo in cui il piano è in pausa non conta per questi 90 giorni.

Revoca una chiave

Apri Account > MCP, CLI & API, trova la chiave in API Keys e scegli Revoke. Le richieste che usano quella chiave smetteranno di funzionare.

ads logout rimuove la chiave salvata solo da quel computer; non la revoca. Non può rimuovere ADS_API_KEY, quindi elimina anche quella variabile dall'ambiente o dalle impostazioni dei segreti.

Gli accessi tramite browser sono elencati separatamente in MCP and CLI-Connected AI Apps. Scegli Revoke in quella scheda per revocare una connessione del CLI o di un'app di IA.

Documentazione