Hoppa till innehållet
Remote Sunrise

Remote Sunrises guider

Anslut SearchAds Manager till Codex

Aktivera den lokala MCP-servern i SearchAds Manager, anslut den till Codex och verifiera den med ett grundläggande funktionstest i Apple Search Ads med tillfälliga testdata.

Tillbaka MCP-översikt

Använd den här sidan när du vill att Codex ska arbeta med Apple Search Ads via den lokala appen SearchAds Manager i stället för ett eget API-skript.

1. Konfigurera macOS-appen

  1. Codex

    Skickar en begäran till den lokala MCP-servern.

  2. SearchAds Manager

    Kör servern på din Mac och hanterar begäran.

  3. Apple Ads

    Returnerar kontodata eller utför en godkänd kampanjåtgärd.

Låt SearchAds Manager vara igång på din Mac. Appen ansluter till Apple Ads med den API-åtkomst du har konfigurerat i appen.
  1. Starta SearchAds Manager på macOS.
  2. Öppna Inställningar.
  3. Konfigurera de vanliga autentiseringsuppgifterna för Apple Search Ads om de inte redan är angivna.
  4. Öppna Automatisering och leta sedan upp avsnittet Codex MCP-server.
  5. Aktivera servern.
  6. Granska port och token och ändra dem vid behov.
  7. Klicka på Tillämpa serverinställningar.
Inställningar i SearchAds Manager med Automatisering valt och Aktivera lokal MCP-server ikryssat
På Mac öppnar du Inställningar → Automatisering och aktiverar den lokala MCP-servern. Tillämpa serverinställningarna och kopiera sedan Codex-kommandot från appen.

Om autentiseringsuppgifterna inte är konfigurerade ännu följer du Apples OAuth-guide: Implementera OAuth för Apple Search Ads API.

2. Lägg till servern i Codex

Inställningskortet visar det exakta kommandot som ska köras. Kommandoformatet är:

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

När du har lagt till den:

  1. Låt macOS-appen fortsätta köras.
  2. Starta en ny Codex-session i det kodarkiv där du vill arbeta, eller återanslut MCP-servrarna om din klient stöder det.
  3. Använd servern searchads för rapportering och skrivåtgärder i stället för att skriva egna API-skript.
  1. Anropa list_apps först när du behöver ett adam_id.
  2. Anropa list_supported_countries innan du skapar en kampanj när du behöver giltiga landskoder.
  3. Använd get_campaign_report, get_adgroup_report och get_keyword_report för att granska resultaten innan du gör ändringar.
  4. Använd list_campaigns, list_adgroups och list_keywords för att granska det aktuella läget innan du gör ändringar.
  5. Använd create_campaigns, add_adgroups och add_keywords för att skapa nya objekt.
  6. Använd update_campaigns, update_adgroups och update_keywords för kontrollerade ändringar.
  7. Använd delete_campaigns, delete_adgroups och delete_keywords bara när du uttryckligen vill rensa genom att radera.
  8. Gör helst skrivåtgärder i små, tydligt specificerade omgångar så att fel blir lättare att granska.

4. Felsökning

  1. Om Codex inte kan ansluta kontrollerar du att macOS-appen är öppen och att serverstatusen visar Körs.
  2. Om verktygsanrop misslyckas på grund av konfigurationsfel kontrollerar du autentiseringsuppgifterna för Apple Search Ads i appinställningarna igen.
  3. Om du genererar en ny token eller ändrar porten kör du codex mcp add ... igen med den nya URL:en.

5. Prompter för grundläggande funktionstest med tillfälliga testdata

Visa de valfria instruktionerna för grundläggande funktionstest

Kör prompterna nedan i samma Codex-session så att den kan komma ihåg de test-ID:n den skapar.

Använd ett namnprefix för tillfälliga tester, till exempel mcp-smoke-..., och radera allt när du är klar. Nya testobjekt har vanligtvis nollvärden i rapporterna; det verifierar ändå rapporteringsflödet via MCP.

Prompt för att hitta resurser

Använd endast MCP-servern `searchads` för att förbereda ett grundläggande MCP-funktionstest.

1. Hitta en app som jag äger och som jag säkert kan använda för en tillfällig testkampanj. Välj helst en app som matchar "Monitor and Manage Search Ads". Lista annars de första 5 apparna som jag äger och välj en av dem.
2. Anropa `list_supported_countries` och välj `US` om landet stöds. Välj annars ett land som stöds och berätta vilken landskod du valde.
3. Anropa `list_campaigns` för kampanjer vars namn börjar med `mcp-smoke-`.
4. Ange valt `adam_id`, landskoden och ett unikt testprefix i formatet `mcp-smoke-YYYYMMDD-HHMMSS`.
5. Skapa inget ännu.

Prompt för att skapa en kampanj

Använd endast MCP-servern `searchads` för att skapa en tillfällig, pausad testkampanj med namnet `<PREFIX>-campaign` för appen och landet som valdes tidigare.

Använd:
- valt `adam_id`
- en landskod
- `daily_budget_amount` med värdet 5
- `currency` med värdet `USD`

Anropa `list_campaigns` med testprefixet efter att kampanjen har skapats och returnera det nya `campaign_id`.

Prompt för rapport och uppdatering av kampanj

Använd endast MCP-servern `searchads`:

1. Anropa `get_campaign_report` för `<CAMPAIGN_ID>` med `days: 0`.
2. Uppdatera kampanjen med `update_campaigns` så att dagsbudgeten blir 6 USD och statusen blir `ENABLED`.
3. Anropa `list_campaigns` igen med testprefixet.
4. Sammanfatta kampanjens tillstånd före och efter uppdateringen.

Prompt för att lägga till annonsgrupper

Använd endast MCP-servern `searchads` för att lägga till två pausade annonsgrupper i `<CAMPAIGN_ID>`:

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

Använd:
- `default_bid_amount` med värdet 1
- `currency` med värdet `USD`
- `automated_keywords_opt_in` med värdet false

Anropa `list_adgroups` för kampanjen efter att grupperna har skapats och returnera båda `ad_group_id`-värdena.

Prompt för rapport och uppdatering av annonsgrupp

Använd endast MCP-servern `searchads`:

1. Anropa `get_adgroup_report` för `<CAMPAIGN_ID>` med `days: 0`.
2. Uppdatera `<PREFIX>-ag-1` med `update_adgroups` så att statusen blir `ENABLED`, `default_bid_amount` blir 1.2 USD och `cpa_goal_amount` blir 4 USD.
3. Anropa `list_adgroups` igen för `<CAMPAIGN_ID>`.
4. Sammanfatta den uppdaterade annonsgruppen och returnera dess `ad_group_id`.

Prompt för att lägga till sökord

Använd endast MCP-servern `searchads` för att lägga till sökord i `<AD_GROUP_ID>` i `<CAMPAIGN_ID>` med ett enda `keyword_set`.

Använd:
- `default_bid_amount` med värdet 0.8
- `default_currency` med värdet `USD`

Lägg till dessa sökord:
1. `<PREFIX> exact` med `match_type` `EXACT` och `status` `ACTIVE`
2. `<PREFIX> broad` med `match_type` `BROAD` och `status` `ACTIVE`

Anropa `list_keywords` för `<CAMPAIGN_ID>` och `<AD_GROUP_ID>` efter att sökorden har skapats och returnera de skapade `keyword_id`-värdena.

Prompt för rapport och uppdatering av sökord

Använd endast MCP-servern `searchads`:

1. Anropa `get_keyword_report` för `<CAMPAIGN_ID>` och `ad_group_ids: [<AD_GROUP_ID>]` med `days: 0`.
2. Uppdatera EXACT-sökordet med `update_keywords` så att budet blir 0.9 USD och statusen blir `PAUSED`.
3. Anropa `list_keywords` igen för `<CAMPAIGN_ID>` och `<AD_GROUP_ID>`.
4. Sammanfatta det uppdaterade sökordet och returnera båda aktuella sökordsraderna.

Prompt för rensning

Använd endast MCP-servern `searchads` för att ta bort uppgifterna från MCP-funktionstestet.

1. Ta bort alla testsökord i `<AD_GROUP_ID>` med `delete_keywords`.
2. Anropa `list_keywords` för `<CAMPAIGN_ID>` och `<AD_GROUP_ID>` för att bekräfta att sökorden har tagits bort.
3. Ta bort båda testannonsgrupperna med `delete_adgroups`.
4. Anropa `list_adgroups` för `<CAMPAIGN_ID>` för att bekräfta att annonsgrupperna har tagits bort.
5. Ta bort testkampanjen med `delete_campaigns`.
6. Anropa `list_campaigns` med testprefixet för att bekräfta att kampanjen har tagits bort.
7. Sammanfatta resultatet av rensningen.