Utilisez cette page lorsque vous souhaitez que Codex travaille avec Apple Search Ads via l’application locale SearchAds Manager plutôt qu’avec un script d’API personnalisé.

1. Configurer l’application macOS

1. 1 Codex

   Envoie une requête au serveur MCP local.

2. 2 SearchAds Manager

   Exécute le serveur sur votre Mac et traite la requête.

3. 3 Apple Ads

   Renvoie les données du compte ou exécute une action autorisée sur une campagne.

Laissez SearchAds Manager en cours d’exécution sur votre Mac. Il se connecte à Apple Ads via l’accès à l’API que vous avez configuré dans l’application.

1. Lancez SearchAds Manager sur macOS.
2. Ouvrez Réglages.
3. Configurez les identifiants d’accès habituels à Apple Search Ads s’ils ne sont pas déjà définis.
4. Ouvrez Automatisation, puis recherchez la section Serveur MCP Codex.
5. Activez le serveur.
6. Vérifiez ou modifiez le port et le jeton si nécessaire.
7. Cliquez sur Appliquer les réglages du serveur.

Sur Mac, ouvrez Réglages → Automatisation et activez le serveur MCP local. Appliquez les paramètres du serveur, puis copiez la commande Codex depuis l’application.

Si les identifiants d’accès ne sont pas encore configurés, suivez le guide OAuth d’Apple : Implémenter OAuth pour l’API Apple Search Ads.

2. Ajouter le serveur à Codex

La fiche des réglages affiche la commande exacte à exécuter. Le format de la commande est le suivant :

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

Après l’ajout :

1. Laissez l’application macOS en cours d’exécution.
2. Démarrez une nouvelle session Codex dans le dépôt où vous souhaitez travailler, ou reconnectez les serveurs MCP si votre client le permet.
3. Utilisez le serveur searchads pour les rapports et les opérations d’écriture plutôt que d’écrire manuellement des scripts d’API.

3. Procédure recommandée dans Codex

1. Appelez d’abord list_apps lorsque vous avez besoin d’un adam_id.
2. Appelez list_supported_countries avant de créer une campagne lorsque vous avez besoin de codes de pays valides.
3. Utilisez get_campaign_report, get_adgroup_report et get_keyword_report pour examiner les performances avant d’apporter des modifications.
4. Utilisez list_campaigns, list_adgroups et list_keywords pour examiner l’état actuel avant d’apporter des modifications.
5. Utilisez create_campaigns, add_adgroups et add_keywords pour les opérations de création.
6. Utilisez update_campaigns, update_adgroups et update_keywords pour effectuer des modifications maîtrisées.
7. Utilisez delete_campaigns, delete_adgroups et delete_keywords uniquement pour un nettoyage destructif explicitement demandé.
8. Privilégiez de petits lots d’écriture explicites afin de faciliter l’examen des échecs.

4. Dépannage

1. Si Codex ne parvient pas à se connecter, vérifiez que l’application macOS est ouverte et que l’état du serveur indique En cours d’exécution.
2. Si les appels d’outils échouent en raison d’erreurs de configuration, revérifiez les identifiants d’accès à Apple Search Ads dans les réglages de l’application.
3. Si vous régénérez le jeton ou changez de port, exécutez à nouveau codex mcp add ... avec la nouvelle URL.

5. Consignes pour un test de bon fonctionnement avec des données temporaires

Afficher les invites facultatives de vérification rapide

Exécutez les consignes ci-dessous dans la même session Codex afin qu’il puisse mémoriser les identifiants de test qu’il crée.

Utilisez un préfixe de nommage temporaire tel que mcp-smoke-... et supprimez tout à la fin. Les entités de test nouvellement créées affichent généralement des indicateurs à zéro dans les rapports ; cela valide tout de même le fonctionnement des rapports via MCP.

Consigne de découverte

En utilisant uniquement le serveur MCP `searchads`, prépare un environnement de test rapide MCP.

1. Trouve une application que je possède et que je peux utiliser sans risque pour une campagne de test temporaire. Privilégie une application correspondant à "Monitor and Manage Search Ads" ; sinon, liste les 5 premières applications que je possède et choisis-en une.
2. Appelle `list_supported_countries` et choisis `US` si ce pays est pris en charge. Sinon, choisis un pays pris en charge et indique-moi le code retenu.
3. Appelle `list_campaigns` pour les campagnes dont le nom commence par `mcp-smoke-`.
4. Indique-moi l’`adam_id` choisi, le code du pays et un préfixe de test unique au format `mcp-smoke-YYYYMMDD-HHMMSS`.
5. Ne crée encore rien.

Consigne pour créer une campagne

En utilisant uniquement le serveur MCP `searchads`, crée une campagne de test temporaire en pause nommée `<PREFIX>-campaign` pour l’application et le pays choisis précédemment.

Utilise :
- l’`adam_id` choisi
- un code de pays
- `daily_budget_amount` à 5
- `currency` à `USD`

Après la création, appelle `list_campaigns` avec le préfixe de test et renvoie le nouveau `campaign_id`.

Consigne pour consulter le rapport et mettre à jour une campagne

En utilisant uniquement le serveur MCP `searchads` :

1. Appelle `get_campaign_report` pour `<CAMPAIGN_ID>` avec `days: 0`.
2. Mets à jour cette campagne avec `update_campaigns` pour porter son budget quotidien à 6 USD et son statut à `ENABLED`.
3. Appelle à nouveau `list_campaigns` avec le préfixe de test.
4. Résume l’état de la campagne avant et après la mise à jour.

Consigne pour ajouter des groupes d’annonces

En utilisant uniquement le serveur MCP `searchads`, ajoute deux groupes d’annonces en pause à `<CAMPAIGN_ID>` :

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

Utilise :
- `default_bid_amount` à 1
- `currency` à `USD`
- `automated_keywords_opt_in` à false

Après la création, appelle `list_adgroups` pour la campagne et renvoie les deux valeurs `ad_group_id`.

Consigne pour consulter le rapport et mettre à jour un groupe d’annonces

En utilisant uniquement le serveur MCP `searchads` :

1. Appelle `get_adgroup_report` pour `<CAMPAIGN_ID>` avec `days: 0`.
2. Mets à jour `<PREFIX>-ag-1` avec `update_adgroups` pour passer son statut à `ENABLED`, son `default_bid_amount` à 1.2 USD et son `cpa_goal_amount` à 4 USD.
3. Appelle à nouveau `list_adgroups` pour `<CAMPAIGN_ID>`.
4. Résume l’état du groupe d’annonces mis à jour et renvoie son `ad_group_id`.

Consigne pour ajouter des mots-clés

En utilisant uniquement le serveur MCP `searchads`, ajoute des mots-clés à `<AD_GROUP_ID>` dans `<CAMPAIGN_ID>` à l’aide d’un seul `keyword_set`.

Utilise :
- `default_bid_amount` à 0.8
- `default_currency` à `USD`

Ajoute les mots-clés suivants :
1. `<PREFIX> exact` avec `match_type` à `EXACT` et `status` à `ACTIVE`
2. `<PREFIX> broad` avec `match_type` à `BROAD` et `status` à `ACTIVE`

Après la création, appelle `list_keywords` pour `<CAMPAIGN_ID>` et `<AD_GROUP_ID>`, puis renvoie les valeurs `keyword_id` créées.

Consigne pour consulter le rapport et mettre à jour des mots-clés

En utilisant uniquement le serveur MCP `searchads` :

1. Appelle `get_keyword_report` pour `<CAMPAIGN_ID>` et `ad_group_ids: [<AD_GROUP_ID>]` avec `days: 0`.
2. Mets à jour le mot-clé EXACT avec `update_keywords` pour porter son enchère à 0.9 USD et son statut à `PAUSED`.
3. Appelle à nouveau `list_keywords` pour `<CAMPAIGN_ID>` et `<AD_GROUP_ID>`.
4. Résume l’état du mot-clé mis à jour et renvoie les deux lignes de mots-clés dans leur état actuel.

Consigne de nettoyage

En utilisant uniquement le serveur MCP `searchads`, supprime les éléments du test rapide MCP.

1. Supprime tous les mots-clés de test de `<AD_GROUP_ID>` avec `delete_keywords`.
2. Appelle `list_keywords` pour `<CAMPAIGN_ID>` et `<AD_GROUP_ID>` afin de confirmer que les mots-clés ont été supprimés.
3. Supprime les deux groupes d’annonces de test avec `delete_adgroups`.
4. Appelle `list_adgroups` pour `<CAMPAIGN_ID>` afin de confirmer que les groupes d’annonces ont été supprimés.
5. Supprime la campagne de test avec `delete_campaigns`.
6. Appelle `list_campaigns` avec le préfixe de test afin de confirmer que la campagne a été supprimée.
7. Résume les résultats du nettoyage.