SearchAds Manager incluye un servidor MCP local exclusivo de macOS que se ejecuta dentro de la aplicación y reutiliza las credenciales de Apple Search Ads ya configuradas en los ajustes de tu cuenta.

Qué hace

• Descubre las aplicaciones que te pertenecen y los países admitidos antes de crear campañas.
• Obtén informes de campañas, grupos de anuncios y palabras clave sin crear scripts personalizados para la API.
• Crea, actualiza y elimina campañas, grupos de anuncios y palabras clave desde Codex mediante un punto de conexión local con autenticación.
• Mantén la conexión local en tu Mac mientras la aplicación esté en ejecución.

Modelo de ejecución

1. El servidor solo escucha en 127.0.0.1.
2. El servidor solo está disponible mientras la aplicación de macOS está en ejecución.
3. El acceso está protegido con un token generado que se almacena en los ajustes de la aplicación.
4. El punto de conexión MCP es /mcp.
5. Hay un punto de conexión para comprobar el estado en /health.

Ajustes de SearchAds Manager

La pantalla de Ajustes en macOS incluye una tarjeta Servidor MCP de Codex con:

1. Un interruptor de activación
2. Un puerto TCP configurable
3. Un token de acceso generado
4. La URL completa de MCP con autenticación
5. Un comando de Codex listo para ejecutar
6. Información sobre el estado del servicio de escucha local

Herramientas MCP disponibles

Descubrimiento y metadatos

• list_apps
• list_supported_countries

Informes

• get_campaign_report
• get_adgroup_report
• get_keyword_report

Gestión de campañas

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

Gestión de grupos de anuncios

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

Gestión de palabras clave

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

Flujo de trabajo habitual

1. Llama a list_apps para encontrar el adam_id de la aplicación que quieres promocionar.
2. Llama a list_supported_countries para confirmar los códigos de país o región válidos.
3. Revisa el rendimiento actual con get_campaign_report, get_adgroup_report o get_keyword_report.
4. Revisa el estado actual con list_campaigns, list_adgroups y list_keywords.
5. Aplica lotes de escritura pequeños y explícitos para que sea más fácil comprender los errores y revertir los cambios si es necesario.

Siguiente paso

Para añadir el servidor a Codex y ejecutar una prueba de humo con datos desechables, abre Conectar SearchAds Manager a Codex.