Pular para o conteúdo
Remote Sunrise

Os guias da Remote Sunrise

Conecte o SearchAds Manager ao Codex

Ative o servidor MCP local no SearchAds Manager, conecte-o ao Codex e verifique-o com um teste básico do Apple Search Ads usando dados temporários.

Voltar Visão geral do MCP

Use esta página quando quiser que o Codex trabalhe com o Apple Search Ads pelo app local SearchAds Manager, em vez de usar um script personalizado de API.

1. Configure o app do macOS

  1. Codex

    Envia uma solicitação ao servidor MCP local.

  2. SearchAds Manager

    Executa o servidor no seu Mac e processa a solicitação.

  3. Apple Ads

    Retorna dados da conta ou executa uma ação autorizada na campanha.

Mantenha o SearchAds Manager em execução no seu Mac. Ele se conecta ao Apple Ads usando o acesso à API que você configurou no app.
  1. Abra o SearchAds Manager no macOS.
  2. Abra Ajustes.
  3. Configure as credenciais habituais do Apple Search Ads se ainda não estiverem definidas.
  4. Abra Automação e, em seguida, encontre a seção Servidor MCP do Codex.
  5. Ative o servidor.
  6. Revise ou altere a porta e o token, se necessário.
  7. Clique em Apply Server Settings (Aplicar Ajustes do Servidor).
Ajustes do SearchAds Manager com Automação selecionada e a opção Ativar Servidor MCP Local marcada
No Mac, abra Ajustes → Automação e ative o servidor MCP local. Aplique os ajustes do servidor e, em seguida, copie o comando do Codex no app.

Se as credenciais ainda não estiverem configuradas, siga o guia de OAuth da Apple: Implementação de OAuth para a API do Apple Search Ads.

2. Adicione o servidor ao Codex

O cartão de ajustes mostra o comando exato a executar. O formato do comando é:

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

Depois de adicioná-lo:

  1. Mantenha o app do macOS em execução.
  2. Inicie uma nova sessão do Codex no repositório em que deseja trabalhar ou reconecte os servidores MCP se o cliente oferecer essa opção.
  3. Use o servidor searchads para relatórios e operações de gravação, em vez de criar scripts manuais para a API.
  1. Chame list_apps primeiro quando precisar de um adam_id.
  2. Chame list_supported_countries antes de criar uma campanha quando precisar de códigos de país válidos.
  3. Use get_campaign_report, get_adgroup_reporte get_keyword_report para analisar o desempenho antes de fazer alterações.
  4. Use list_campaigns, list_adgroupse list_keywords para inspecionar o estado atual antes de fazer alterações.
  5. Use create_campaigns, add_adgroupse add_keywords para os fluxos de criação.
  6. Use update_campaigns, update_adgroupse update_keywords para edições controladas.
  7. Use delete_campaigns, delete_adgroupse delete_keywords apenas para uma exclusão destrutiva explicitamente solicitada.
  8. Prefira lotes pequenos e explícitos para operações de gravação, para facilitar a análise de falhas.

4. Solução de problemas

  1. Se o Codex não conseguir se conectar, confirme se o app do macOS está aberto e se o status do servidor mostra Running (Em execução).
  2. Se as chamadas de ferramentas falharem com erros de configuração, confira as credenciais do Apple Search Ads nos ajustes do app.
  3. Se você gerar um novo token ou alterar a porta, execute novamente codex mcp add ... com a nova URL.

5. Prompts de teste básico com dados temporários

Mostrar os prompts opcionais de teste básico

Execute os prompts abaixo na mesma sessão do Codex para que ele possa lembrar os IDs de teste que criar.

Use um prefixo de nome para itens temporários, como mcp-smoke-... e apague tudo ao terminar. Entidades de teste recém-criadas geralmente têm métricas zeradas nos relatórios; isso ainda valida o fluxo de relatórios pelo MCP.

Prompt de descoberta

Usando apenas o servidor MCP `searchads`, prepare um ambiente para um teste básico de funcionamento do MCP.

1. Encontre um app de minha propriedade que eu possa usar com segurança em uma campanha de teste temporária. Dê preferência a um app que corresponda a "Monitor and Manage Search Ads"; caso contrário, liste os primeiros 5 apps de minha propriedade e escolha um.
2. Chame `list_supported_countries` e escolha `US` se houver suporte a esse país. Caso contrário, escolha um país compatível e informe o código escolhido.
3. Chame `list_campaigns` para as campanhas cujos nomes comecem com `mcp-smoke-`.
4. Informe o `adam_id` escolhido, o código do país e um prefixo de teste exclusivo no formato `mcp-smoke-YYYYMMDD-HHMMSS`.
5. Não crie nada ainda.

Prompt para criar campanha

Usando apenas o servidor MCP `searchads`, crie uma campanha de teste temporária pausada chamada `<PREFIX>-campaign` para o app e o país escolhidos anteriormente.

Use:
- o `adam_id` escolhido
- um código de país
- `daily_budget_amount` com valor 5
- `currency` com valor `USD`

Após a criação, chame `list_campaigns` com o prefixo de teste e retorne o novo `campaign_id`.

Prompt de relatório e atualização de campanha

Usando apenas o servidor MCP `searchads`:

1. Chame `get_campaign_report` para `<CAMPAIGN_ID>` com `days: 0`.
2. Atualize essa campanha com `update_campaigns` para que o orçamento diário passe a ser 6 USD e o status passe a ser `ENABLED`.
3. Chame `list_campaigns` novamente com o prefixo de teste.
4. Resuma o estado da campanha antes e depois da atualização.

Prompt para adicionar grupos de anúncios

Usando apenas o servidor MCP `searchads`, adicione dois grupos de anúncios pausados a `<CAMPAIGN_ID>`:

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

Use:
- `default_bid_amount` com valor 1
- `currency` com valor `USD`
- `automated_keywords_opt_in` com valor false

Após a criação, chame `list_adgroups` para a campanha e retorne os dois valores de `ad_group_id`.

Prompt de relatório e atualização de grupo de anúncios

Usando apenas o servidor MCP `searchads`:

1. Chame `get_adgroup_report` para `<CAMPAIGN_ID>` com `days: 0`.
2. Atualize `<PREFIX>-ag-1` com `update_adgroups` para que o status passe a ser `ENABLED`, o `default_bid_amount` passe a ser 1.2 USD e o `cpa_goal_amount` passe a ser 4 USD.
3. Chame `list_adgroups` novamente para `<CAMPAIGN_ID>`.
4. Resuma o grupo de anúncios atualizado e retorne seu `ad_group_id`.

Prompt para adicionar palavras-chave

Usando apenas o servidor MCP `searchads`, adicione palavras-chave a `<AD_GROUP_ID>` em `<CAMPAIGN_ID>` usando um único `keyword_set`.

Use:
- `default_bid_amount` com valor 0.8
- `default_currency` com valor `USD`

Adicione estas palavras-chave:
1. `<PREFIX> exact` com `match_type` `EXACT` e `status` `ACTIVE`
2. `<PREFIX> broad` com `match_type` `BROAD` e `status` `ACTIVE`

Após a criação, chame `list_keywords` para `<CAMPAIGN_ID>` e `<AD_GROUP_ID>` e retorne os valores de `keyword_id` criados.

Prompt de relatório e atualização de palavras-chave

Usando apenas o servidor MCP `searchads`:

1. Chame `get_keyword_report` para `<CAMPAIGN_ID>` e `ad_group_ids: [<AD_GROUP_ID>]` com `days: 0`.
2. Atualize a palavra-chave EXACT com `update_keywords` para que seu lance passe a ser 0.9 USD e seu status passe a ser `PAUSED`.
3. Chame `list_keywords` novamente para `<CAMPAIGN_ID>` e `<AD_GROUP_ID>`.
4. Resuma a palavra-chave atualizada e retorne as duas linhas atuais de palavras-chave.

Prompt de limpeza

Usando apenas o servidor MCP `searchads`, remova os itens do teste básico de funcionamento do MCP.

1. Exclua todas as palavras-chave de teste de `<AD_GROUP_ID>` com `delete_keywords`.
2. Chame `list_keywords` para `<CAMPAIGN_ID>` e `<AD_GROUP_ID>` para confirmar que as palavras-chave foram excluídas.
3. Exclua os dois grupos de anúncios de teste com `delete_adgroups`.
4. Chame `list_adgroups` para `<CAMPAIGN_ID>` para confirmar que os grupos de anúncios foram excluídos.
5. Exclua a campanha de teste com `delete_campaigns`.
6. Chame `list_campaigns` com o prefixo de teste para confirmar que a campanha foi excluída.
7. Resuma os resultados da limpeza.