Ga naar de inhoud
Remote Sunrise

De handleidingen van Remote Sunrise

Verbind SearchAds Manager met Codex

Schakel de lokale MCP-server in SearchAds Manager in, koppel deze aan Codex en controleer de werking met een Apple Search Ads-smoketest met tijdelijke testgegevens.

Terug MCP-overzicht

Gebruik deze pagina wanneer je Codex met Apple Search Ads wilt laten werken via de lokale SearchAds Manager-app in plaats van via een eigen API-script.

1. De macOS-app instellen

  1. Codex

    Verstuurt een verzoek naar de lokale MCP-server.

  2. SearchAds Manager

    Voert de server op je Mac uit en verwerkt het verzoek.

  3. Apple Ads

    Geeft accountgegevens terug of voert een geautoriseerde campagneactie uit.

Houd SearchAds Manager actief op je Mac. De app maakt verbinding met Apple Ads via de API-toegang die je in de app hebt ingesteld.
  1. Start SearchAds Manager op macOS.
  2. Open Instellingen.
  3. Stel de gebruikelijke Apple Search Ads-inloggegevens in als dat nog niet is gebeurd.
  4. Open Automatisering en zoek vervolgens het gedeelte Codex MCP-server.
  5. Schakel de server in.
  6. Controleer de poort en het token en wijzig ze indien nodig.
  7. Klik op Serverinstellingen toepassen.
Instellingen van SearchAds Manager met Automatisering geselecteerd en Lokale MCP-server inschakelen aangevinkt
Open op je Mac Instellingen → Automatisering en schakel de lokale MCP-server in. Pas de serverinstellingen toe en kopieer vervolgens de Codex-opdracht uit de app.

Als de inloggegevens nog niet zijn ingesteld, volg dan de OAuth-handleiding van Apple: OAuth implementeren voor de Apple Search Ads API.

2. De server toevoegen aan Codex

De instellingenkaart toont het exacte commando dat je moet uitvoeren. Het commando heeft deze vorm:

codex mcp add searchads --url "http://127.0.0.1:7717/mcp?token=YOUR_TOKEN"

Na het toevoegen:

  1. Laat de macOS-app draaien.
  2. Start een nieuwe Codex-sessie in de repository waarin je wilt werken, of maak opnieuw verbinding met MCP-servers als je client dit ondersteunt.
  3. Gebruik de searchads-server voor rapportage en schrijfbewerkingen in plaats van zelf API-scripts te schrijven.
  1. Roep eerst list_apps aan wanneer je een adam_id nodig hebt.
  2. Roep list_supported_countries aan voordat je een campagne maakt als je geldige landcodes nodig hebt.
  3. Gebruik get_campaign_report, get_adgroup_report en get_keyword_report om de prestaties te bekijken voordat je wijzigingen aanbrengt.
  4. Gebruik list_campaigns, list_adgroups en list_keywords om de huidige toestand te bekijken voordat je wijzigingen aanbrengt.
  5. Gebruik create_campaigns, add_adgroups en add_keywords voor het aanmaken van nieuwe gegevens.
  6. Gebruik update_campaigns, update_adgroups en update_keywords voor gecontroleerde wijzigingen.
  7. Gebruik delete_campaigns, delete_adgroups en delete_keywords alleen voor expliciete opschoonacties waarbij gegevens worden verwijderd.
  8. Gebruik bij voorkeur kleine, expliciete batches voor schrijfbewerkingen, zodat fouten makkelijker te beoordelen zijn.

4. Problemen oplossen

  1. Als Codex geen verbinding kan maken, controleer dan of de macOS-app open is en de serverstatus Actief aangeeft.
  2. Als toolaanroepen mislukken door configuratiefouten, controleer dan opnieuw de Apple Search Ads-inloggegevens in de appinstellingen.
  3. Als je het token opnieuw genereert of de poort wijzigt, voer dan codex mcp add ... opnieuw uit met de nieuwe URL.

5. Prompts voor een tijdelijke smoketest

Toon de optionele prompts voor een basistest

Voer de onderstaande prompts uit in dezelfde Codex-sessie, zodat Codex de aangemaakte test-ID’s kan onthouden.

Gebruik een tijdelijk naamvoorvoegsel zoals mcp-smoke-... en verwijder alles na afloop. Nieuwe testentiteiten hebben in rapporten meestal meetwaarden van nul; ook daarmee wordt het rapportagepad via MCP gevalideerd.

Prompt voor verkenning

Bereid uitsluitend met de MCP-server `searchads` een eenvoudige MCP-werkingstest voor.

1. Zoek een app waarvan ik eigenaar ben en die ik veilig kan gebruiken voor een tijdelijke testcampagne. Geef de voorkeur aan een app die overeenkomt met "Monitor and Manage Search Ads"; toon anders de eerste 5 apps waarvan ik eigenaar ben en kies er één.
2. Roep `list_supported_countries` aan en kies `US` als dat land wordt ondersteund. Kies anders een ondersteund land en vertel me welke code je hebt gekozen.
3. Roep `list_campaigns` aan voor campagnes waarvan de naam begint met `mcp-smoke-`.
4. Geef me de gekozen `adam_id`, de landcode en een uniek testvoorvoegsel in de vorm `mcp-smoke-YYYYMMDD-HHMMSS`.
5. Maak nog niets aan.

Prompt voor het maken van een campagne

Maak uitsluitend met de MCP-server `searchads` één tijdelijke, gepauzeerde testcampagne aan met de naam `<PREFIX>-campaign` voor de eerder gekozen app en het gekozen land.

Gebruik:
- de gekozen `adam_id`
- één landcode
- `daily_budget_amount` met waarde 5
- `currency` met waarde `USD`

Roep na het aanmaken `list_campaigns` aan met het testvoorvoegsel en geef de nieuwe `campaign_id` terug.

Prompt voor rapportage en bijwerken van campagnes

Gebruik uitsluitend de MCP-server `searchads`:

1. Roep `get_campaign_report` aan voor `<CAMPAIGN_ID>` met `days: 0`.
2. Werk die campagne bij met `update_campaigns`, zodat het dagbudget 6 USD wordt en de status `ENABLED`.
3. Roep `list_campaigns` opnieuw aan voor het testvoorvoegsel.
4. Vat de toestand van de campagne vóór en na de wijziging samen.

Prompt voor het toevoegen van advertentiegroepen

Voeg uitsluitend met de MCP-server `searchads` twee gepauzeerde advertentiegroepen toe aan `<CAMPAIGN_ID>`:

1. `<PREFIX>-ag-1`
2. `<PREFIX>-ag-2`

Gebruik:
- `default_bid_amount` met waarde 1
- `currency` met waarde `USD`
- `automated_keywords_opt_in` met waarde false

Roep na het aanmaken `list_adgroups` aan voor de campagne en geef beide `ad_group_id`-waarden terug.

Prompt voor rapportage en bijwerken van advertentiegroepen

Gebruik uitsluitend de MCP-server `searchads`:

1. Roep `get_adgroup_report` aan voor `<CAMPAIGN_ID>` met `days: 0`.
2. Werk `<PREFIX>-ag-1` bij met `update_adgroups`, zodat de status `ENABLED` wordt, de `default_bid_amount` 1.2 USD en de `cpa_goal_amount` 4 USD.
3. Roep `list_adgroups` opnieuw aan voor `<CAMPAIGN_ID>`.
4. Vat de bijgewerkte advertentiegroep samen en geef de bijbehorende `ad_group_id` terug.

Prompt voor het toevoegen van zoekwoorden

Voeg uitsluitend met de MCP-server `searchads` zoekwoorden toe aan `<AD_GROUP_ID>` in `<CAMPAIGN_ID>` met één `keyword_set`.

Gebruik:
- `default_bid_amount` met waarde 0.8
- `default_currency` met waarde `USD`

Voeg deze zoekwoorden toe:
1. `<PREFIX> exact` met `match_type` `EXACT` en `status` `ACTIVE`
2. `<PREFIX> broad` met `match_type` `BROAD` en `status` `ACTIVE`

Roep na het aanmaken `list_keywords` aan voor `<CAMPAIGN_ID>` en `<AD_GROUP_ID>` en geef de aangemaakte `keyword_id`-waarden terug.

Prompt voor rapportage en bijwerken van zoekwoorden

Gebruik uitsluitend de MCP-server `searchads`:

1. Roep `get_keyword_report` aan voor `<CAMPAIGN_ID>` en `ad_group_ids: [<AD_GROUP_ID>]` met `days: 0`.
2. Werk het EXACT-zoekwoord bij met `update_keywords`, zodat het bod 0.9 USD wordt en de status `PAUSED`.
3. Roep `list_keywords` opnieuw aan voor `<CAMPAIGN_ID>` en `<AD_GROUP_ID>`.
4. Vat het bijgewerkte zoekwoord samen en geef beide huidige zoekwoordrijen terug.

Prompt voor opschonen

Ruim uitsluitend met de MCP-server `searchads` de gegevens van de MCP-werkingstest op.

1. Verwijder alle testzoekwoorden in `<AD_GROUP_ID>` met `delete_keywords`.
2. Roep `list_keywords` aan voor `<CAMPAIGN_ID>` en `<AD_GROUP_ID>` om te bevestigen dat de zoekwoorden zijn verwijderd.
3. Verwijder beide testadvertentiegroepen met `delete_adgroups`.
4. Roep `list_adgroups` aan voor `<CAMPAIGN_ID>` om te bevestigen dat de advertentiegroepen zijn verwijderd.
5. Verwijder de testcampagne met `delete_campaigns`.
6. Roep `list_campaigns` aan voor het testvoorvoegsel om te bevestigen dat de campagne is verwijderd.
7. Vat de resultaten van het opruimen samen.