Aller au contenu

Configurer les accès Google

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.

  1. Créez ou sélectionnez un projet Google Cloud.
  2. Activez l’API Search Console.
  3. Créez un compte de service avec le minimum de droits nécessaire.
  4. Téléchargez le fichier JSON dans un emplacement privé hors du dépôt.
  5. Ajoutez l’adresse du compte de service comme utilisateur de chaque propriété Search Console cible.
  6. 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.

  • 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.

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.

Fenêtre de terminal
gsc-cli list

Comparez 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.

  • 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.

Lire la version anglaise canonique.