Configurer les accès Google
Choisir le mode d’authentification
Section intitulée « Choisir le mode d’authentification »Utilisez un compte de service pour une intégration serveur stable ou OAuth pour un accès utilisateur interactif. Dans les deux cas, l’identité doit être ajoutée aux propriétés Search Console concernées.
Compte de service
Section intitulée « Compte de service »- Créez ou sélectionnez un projet Google Cloud.
- Activez l’API Search Console.
- Créez un compte de service avec le minimum de droits nécessaire.
- Téléchargez le fichier JSON dans un emplacement privé hors du dépôt.
- Ajoutez l’adresse du compte de service comme utilisateur de chaque propriété Search Console cible.
- Configurez le chemin du fichier dans l’environnement du serveur MCP.
Le fichier JSON est global pour l’identité. Les propriétés accessibles dépendent des permissions accordées dans Search Console.
OAuth convient quand un utilisateur doit autoriser directement l’accès. Conservez le secret client et les jetons hors du dépôt. Révoquez les jetons inutilisés depuis le compte Google.
Fournisseurs optionnels
Section intitulée « Fournisseurs optionnels »- GA4 nécessite une propriété Analytics et les droits associés.
- CrUX peut utiliser une clé API selon le workflow.
- PageSpeed Insights suit sa propre configuration et ses quotas.
- L’Indexing API n’est pas un mécanisme général d’indexation pour toutes les pages.
N’activez pas toutes les API par défaut. Configurez uniquement les familles de données nécessaires.
Identifier la propriété GA4 dans les rapports
Section intitulée « Identifier la propriété GA4 dans les rapports »Configurez GA4_PROPERTY_ID avec l’identifiant de propriété, pas l’identifiant de compte. Le préfixe properties/ est ajouté automatiquement. Vous pouvez remplacer cette valeur par défaut avec l’argument property_id de chaque appel.
Les réponses GA4 réussies exposent la propriété effectivement envoyée à l’API dans _meta.sources.ga4.property. _meta.params.property_id conserve l’argument demandé, y compris null quand la configuration fournit la valeur par défaut.
Pour plusieurs sites, choisissez explicitement la correspondance entre propriété GA4 et site GSC. Utilisez hostname, lorsqu’il est disponible, pour filtrer une propriété GA4 partagée :
traffic_health_check(site="sc-domain:example.com", property_id="123456789", hostname="example.com")traffic_health_check(site="https://other.example/", property_id="987654321", hostname="other.example")Ces identifiants sont fictifs. La provenance ne prouve pas que la propriété GA4 appartient au site GSC, ne valide pas un identifiant numérique comme propriété plutôt que compte et n’ajoute aucun filtre de domaine automatiquement.
Vérifier l’accès
Section intitulée « Vérifier l’accès »gsc-cli listComparez la liste retournée aux propriétés attendues. Une absence peut venir de l’identité utilisée, du type de propriété ou d’un droit manquant. Ne remplacez pas cette vérification par une simple réussite d’authentification.
Bonnes pratiques
Section intitulée « Bonnes pratiques »- Gardez les secrets dans la configuration locale du client MCP.
- Accordez le niveau de permission minimal.
- Utilisez des propriétés de test pour les outils d’écriture.
- Révoquez les clés et jetons qui ne servent plus.