SearchAds Manager include un server MCP locale disponibile solo su macOS che viene eseguito all’interno dell’app e riutilizza le credenziali di Apple Search Ads già configurate nelle impostazioni dell’account.

Cosa fa

• Individua le app di cui sei titolare e i paesi supportati prima di creare campagne.
• Recupera report su campagne, gruppi di annunci e parole chiave senza creare script API personalizzati.
• Crea, aggiorna ed elimina campagne, gruppi di annunci e parole chiave da Codex tramite un endpoint locale autenticato.
• Mantieni la connessione limitata al tuo Mac mentre l’app è in esecuzione.

Modello di esecuzione

1. Il server resta in ascolto solo su 127.0.0.1.
2. Il server è disponibile solo mentre l’app per macOS è in esecuzione.
3. L’accesso è protetto da un token generato e memorizzato nelle impostazioni dell’app.
4. L’endpoint MCP è /mcp.
5. Un endpoint per il controllo dello stato è disponibile all’indirizzo /health.

Impostazioni in SearchAds Manager

La schermata Impostazioni su macOS include una scheda Server MCP di Codex con:

1. Un interruttore per l’abilitazione
2. Una porta TCP configurabile
3. Un token di accesso generato
4. L’URL MCP autenticato completo
5. Un comando Codex pronto da eseguire
6. Informazioni sullo stato del servizio locale in ascolto

Strumenti MCP disponibili

Esplorazione e metadati

• list_apps
• list_supported_countries

Report

• get_campaign_report
• get_adgroup_report
• get_keyword_report

Gestione delle campagne

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

Gestione dei gruppi di annunci

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

Gestione delle parole chiave

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

Procedura tipica

1. Chiama list_apps per trovare l’adam_id dell’app che vuoi promuovere.
2. Chiama list_supported_countries per verificare quali codici paese o regione sono validi.
3. Esamina le prestazioni attuali con get_campaign_report, get_adgroup_report o get_keyword_report.
4. Verifica lo stato attuale con list_campaigns, list_adgroups e list_keywords.
5. Applica piccoli gruppi espliciti di operazioni di scrittura, così gli errori sono più facili da comprendere e le modifiche più facili da annullare, se necessario.

Passaggio successivo

Per aggiungere il server a Codex ed eseguire un test di verifica con dati da eliminare al termine, apri Collega SearchAds Manager a Codex.