SearchAds Manager comprend un serveur MCP local disponible uniquement sur macOS, qui s’exécute dans l’application et réutilise les identifiants d’accès à Apple Search Ads déjà configurés dans les réglages de votre compte.

Fonctionnalités

• Découvrez les applications que vous possédez et les pays pris en charge avant de créer des campagnes.
• Récupérez les rapports sur les campagnes, les groupes d’annonces et les mots-clés sans créer de scripts d’API personnalisés.
• Créez, mettez à jour et supprimez des campagnes, des groupes d’annonces et des mots-clés depuis Codex via un point d’accès local avec authentification.
• Conservez une connexion locale à votre Mac tant que l’application est en cours d’exécution.

Mode de fonctionnement

1. Le serveur écoute uniquement sur 127.0.0.1.
2. Le serveur est disponible uniquement lorsque l’application macOS est en cours d’exécution.
3. L’accès est protégé par un jeton généré et stocké dans les réglages de l’application.
4. Le point d’accès MCP est /mcp.
5. Un point d’accès de vérification de l’état est disponible à l’adresse /health.

Réglages dans SearchAds Manager

L’écran Réglages sur macOS comprend une fiche Serveur MCP Codex avec :

1. Un interrupteur d’activation
2. Un port TCP configurable
3. Un jeton d’accès généré
4. L’URL MCP complète avec authentification
5. Une commande Codex prête à être exécutée
6. Des informations sur l’état du service d’écoute local

Outils MCP disponibles

Découverte et métadonnées

• list_apps
• list_supported_countries

Rapports

• get_campaign_report
• get_adgroup_report
• get_keyword_report

Gestion des campagnes

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

Gestion des groupes d’annonces

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

Gestion des mots-clés

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

Procédure habituelle

1. Appelez list_apps pour trouver l’adam_id de l’application que vous souhaitez promouvoir.
2. Appelez list_supported_countries pour confirmer les codes de pays ou de région valides.
3. Examinez les performances actuelles avec get_campaign_report, get_adgroup_report ou get_keyword_report.
4. Examinez l’état actuel avec list_campaigns, list_adgroups et list_keywords.
5. Appliquez de petits lots d’écriture explicites afin que les erreurs soient plus faciles à comprendre et les modifications plus faciles à annuler si nécessaire.

Étape suivante

Pour ajouter le serveur à Codex et lancer un test de bon fonctionnement avec des données temporaires, ouvrez Connecter SearchAds Manager à Codex.