O SearchAds Manager inclui um servidor MCP local exclusivo do macOS que é executado dentro do app e reutiliza as credenciais do Apple Search Ads já configuradas nos ajustes da conta.

O que ele faz

• Descubra seus apps e os países compatíveis antes de criar campanhas.
• Obtenha relatórios de campanhas, grupos de anúncios e palavras-chave sem criar scripts personalizados de API.
• Crie, atualize e apague campanhas, grupos de anúncios e palavras-chave pelo Codex por meio de um endpoint local autenticado.
• Mantenha a conexão local ao Mac enquanto o app estiver em execução.

Modelo de execução

1. O servidor escuta apenas em 127.0.0.1.
2. O servidor só fica disponível enquanto o app do macOS está em execução.
3. O acesso é protegido por um token gerado e armazenado nos ajustes do app.
4. O endpoint MCP é /mcp.
5. Um endpoint de integridade está disponível em /health.

Ajustes no SearchAds Manager

A tela Ajustes do macOS inclui um cartão Codex MCP Server (Servidor MCP do Codex) com:

1. Uma opção para ativar
2. Uma porta TCP configurável
3. Um token de acesso gerado
4. A URL completa e autenticada do MCP
5. Um comando do Codex pronto para executar
6. Indicação de status do servidor local

Ferramentas MCP disponíveis

Descoberta e metadados

• list_apps
• list_supported_countries

Relatórios

• get_campaign_report
• get_adgroup_report
• get_keyword_report

Gerenciamento de campanhas

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

Gerenciamento de grupos de anúncios

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

Gerenciamento de palavras-chave

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

Fluxo de trabalho típico

1. Chame list_apps para encontrar o adam_id do app que deseja promover.
2. Chame list_supported_countries para confirmar os códigos válidos de países ou regiões.
3. Analise o desempenho atual com get_campaign_report, get_adgroup_reportou get_keyword_report.
4. Revise o estado atual com list_campaigns, list_adgroupse list_keywords.
5. Aplique lotes pequenos e explícitos de operações de gravação, para facilitar a compreensão de erros e a reversão, se necessário.

Próxima etapa

Para adicionar o servidor ao Codex e executar um teste básico com dados temporários, abra Conecte o SearchAds Manager ao Codex.