Collega un assistente IA

Collega un assistente IA a Gloriads e fagli domande sul tuo account con parole semplici.

L'assistente vede esattamente ciò che vede l'API di Gloriads e non cambia nulla nel tuo account.

Cosa può vedere l'assistente

• Tutto ciò che vede l'API, e nient'altro.
• Nulla che possa modificare: nessuna impostazione, nessuna fatturazione.
• I tuoi dati escono davvero da Gloriads. Collega solo un assistente di cui ti fidi: dopo che ha letto il tuo account, scollegarlo (Impostazioni → API → App collegate) impedisce ogni lettura successiva, ma non può far dimenticare ciò che ha già letto.

Cosa puoi chiedere

• «Come sono andati i miei annunci il mese scorso, e in quale marketplace ho speso di più?»
• «Il mio ACOS è migliore rispetto al mese prima?»
• «Quali prodotti hanno avuto l'ACOS peggiore negli ultimi 30 giorni?»
• «Mostrami la mia spesa giorno per giorno questo mese.»
• «Elenca le mie campagne in pausa in Germania.»
• «Quali parole chiave ha come target questa campagna?»
• «Cosa hanno cambiato le mie regole questa settimana, offerta per offerta?»

L'assistente legge gli stessi dati della tua dashboard: l'elenco di ciò che può leggere è in Cosa legge l'API.

L'indirizzo e cosa serve a ogni assistente

Un solo indirizzo, uguale per tutti gli assistenti:

https://gloriads.com/api/mcp

Qualsiasi altro strumento che supporta server MCP personalizzati può usare lo stesso indirizzo. Gli strumenti che cercano nel registro MCP ufficiale trovano lì Gloriads come com.gloriads/amazon-ads.

Solo il proprietario e gli amministratori dell'account possono collegare un assistente o creare una chiave.

Tutto è in un'unica pagina dell'app — Impostazioni → API: l'indirizzo, i comandi già pronti e le tue chiavi. Ogni blocco ha un pulsante Copia.

claude.ai

1. In claude.ai, apri Customize nel menu a sinistra.

2. Apri la scheda Connectors.

3. Fai clic su Add, poi su Add custom connector.

4. Chiamalo Gloriads, incolla https://gloriads.com/api/mcp, poi fai clic su Continue.

5. Non cambiare nulla nella pagina successiva: claude.ai ha rilevato che Gloriads ti fa accedere e pubblica la propria identità. Fai clic su Add.

6. Fai clic su Connect.

7. Accedi a Gloriads se ti viene chiesto.

8. Controlla l'app che sta chiedendo l'accesso, poi fai clic su Consenti.

9. Torni a claude.ai. Nella pagina del connettore, sotto Tool permissions, scegli Always allow: Claude legge allora i tuoi dati senza chiedere ogni volta, e questo connettore non può fare nient'altro.

In una conversazione, attiva il connettore se l'app te lo chiede, poi fai la tua domanda.

Chiedi a Haiku. È il modello Claude più veloce e meno costoso, e leggere i tuoi dati non gli chiede di più. Sceglilo nel menu dei modelli della tua conversazione.

Un account Claude gratuito può aggiungere un connettore personalizzato.

Per scollegarlo, apri Impostazioni → API → App collegate in Gloriads e scegli Scollega. Smette subito di leggere i tuoi dati.

Claude Desktop

Claude Desktop usa gli stessi connettori di claude.ai, quindi non c'è nient'altro da installare: aggiungi il connettore dall'uno o dall'altro, accedi e fai clic su Consenti. Funziona poi in entrambi.

ChatGPT

ChatGPT non si collega come Claude: i suoi server personalizzati stanno dietro la modalità sviluppatore, offerta solo con i piani a pagamento di ChatGPT. Ecco tutto il percorso.

1. Nelle impostazioni di ChatGPT, attiva la modalità sviluppatore.

2. Apri Plugins, poi New plugin.

3. Name: scrivi Gloriads. L'icona e la descrizione sono facoltative.

4. Connection: tieni Server URL e incolla https://gloriads.com/api/mcp.

5. Authentication: scegli OAuth. Sotto non c'è nulla da compilare — Gloriads pubblica le sue impostazioni a quell'indirizzo e ChatGPT le legge.

6. Spunta Ho capito e voglio continuare (I understand and want to continue se ChatGPT è in inglese) — ChatGPT mostra quell'avviso per ogni server personalizzato, anche per il nostro — poi fai clic su Create.

7. ChatGPT apre Gloriads: accedi se ti viene chiesto, controlla che l'app che chiede l'accesso sia ChatGPT, poi fai clic su Consenti.

8. In una conversazione, attiva il plugin prima di fare la tua prima domanda.

9. Scegli quanto ChatGPT può fare da solo in Settings → Plugins → Gloriads → Permissions. Allow read actions basta: questo connettore può solo leggere. Allow all actions è segnato come rischio elevato e qui non ti dà nulla in più.

Per scollegarlo, apri Impostazioni → API → App collegate in Gloriads e scegli Scollega, esattamente come per claude.ai.

Claude Code

Crea una chiave in Impostazioni → API → Crea una chiave, chiamala «Claude Code» e copiala. Viene mostrata una sola volta.

Poi esegui questo in un terminale, con la tua chiave al posto di YOUR_API_KEY:

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

• Controlla con claude mcp list, oppure con /mcp dentro Claude Code.
• Il server viene aggiunto al progetto corrente. Aggiungi --scope user per usarlo ovunque.
• Per rimuoverlo: claude mcp remove gloriads.

Cursor

Metti la tua chiave nella variabile d'ambiente GLORIADS_API_KEY, poi incolla questo in ~/.cursor/mcp.json (tutti i tuoi progetti) o in .cursor/mcp.json (un solo progetto):

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

Cursor legge la chiave da quella variabile, quindi il file non la contiene mai. Imposta la variabile prima di aprire Cursor.

VS Code

Apri MCP: Open User Configuration dalla Command Palette (tutti i tuoi progetti), oppure crea .vscode/mcp.json in un progetto, e aggiungi:

{
  "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}"
      }
    }
  }
}

VS Code chiede la chiave la prima volta che il server si avvia e la ricorda, quindi il file non la contiene mai.

Gli strumenti che usa

L'assistente sceglie lo strumento giusto per la tua domanda. Ogni strumento legge una parte dell'API.

Da sapere

• Gli stessi dati dell'app. Ogni risposta dice quale periodo e quale valuta ha usato, e segnala quando un dato è incompleto.
• Una chiave legge tutto il tuo account. Tienila fuori dai file condivisi e revocala in Impostazioni → API il giorno in cui smetti di usare l'assistente.
• Limiti condivisi con l'API: 60 richieste al minuto e 10.000 al giorno per il tuo account. Una domanda può costare più richieste. Vedi Limiti ed errori.
• Provalo senza un account in uno strumento per sviluppatori: la chiave demo pubblica del riferimento dell'API funziona anche qui e legge i dati sintetici dell'account demo.