Configuration du serveur MCP distant BigQuery

Le serveur MCP distant BigQuery est l’option gérée par Google pour connecter des assistants IA à BigQuery. Il fonctionne sur l’infrastructure de Google — aucun serveur ni binaire à gérer. Activez-le, configurez un client MCP, et les requêtes s’exécutent en langage naturel.

Compromis : le Remote Server offre cinq outils et nécessite une gestion manuelle des tokens avec Claude Code. Pour tout ce qui va au-delà de l’exploration basique dans Claude Desktop, le Toolbox auto-hébergé est le choix pratique.

Ce qu’il fournit

Le Remote Server expose BigQuery via un seul point de terminaison : https://bigquery.googleapis.com/mcp. Cinq outils sont intégrés :

list_dataset_ids — découvrir les datasets de votre projet
get_dataset_info — métadonnées sur un dataset spécifique
list_table_ids — lister les tables dans un dataset
get_table_info — schéma et métadonnées d’une table spécifique
execute_sql — exécuter des requêtes SQL arbitraires

Ces outils couvrent les bases de l’exploration : l’assistant IA peut découvrir vos datasets, examiner les schémas de tables et exécuter du SQL. Il n’existe pas d’outils avancés pour les prévisions, la recherche dans le catalogue ou les requêtes paramétrées — ceux-ci sont disponibles avec le Toolbox.

Activation du service

Activez le service MCP pour votre projet Google Cloud :

gcloud beta services mcp enable bigquery.googleapis.com \
  --project=PROJECT_ID

Remplacez PROJECT_ID par l’identifiant réel de votre projet.

Rôles IAM requis

L’utilisateur ou le compte de service a besoin de deux rôles :

roles/bigquery.user — pour exécuter des requêtes et lister les datasets
roles/bigquery.dataViewer — pour lire les données des tables

En production avec un compte de service :

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SA_EMAIL" \
  --role="roles/bigquery.user"

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SA_EMAIL" \
  --role="roles/bigquery.dataViewer"

La note BigQuery IAM Patterns couvre le raisonnement approfondi derrière ces choix de rôles — notamment pourquoi bigquery.user (qui regroupe l’exécution de jobs avec le listage des datasets) est utilisé ici plutôt que le plus granulaire bigquery.jobUser.

Configuration de Claude Desktop

Ajoutez le Remote Server à la configuration Claude Desktop dans ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

{
  "mcpServers": {
    "bigquery-remote": {
      "url": "https://bigquery.googleapis.com/mcp",
      "env": {
        "GOOGLE_CLOUD_PROJECT": "your-project-id"
      }
    }
  }
}

Claude Desktop gère l’OAuth automatiquement avec cette configuration — aucune gestion de token ni gestion des expirations requise.

Configuration de Claude Code (avec mises en garde)

Claude Code nécessite une gestion manuelle des tokens pour le Remote Server. La configuration diffère de Claude Desktop. Ajoutez à votre .mcp.json :

{
  "mcpServers": {
    "bigquery": {
      "type": "http",
      "url": "https://bigquery.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>",
        "x-goog-user-project": "your-project-id"
      }
    }
  }
}

Obtenez votre token d’accès :

gcloud auth print-access-token

Le token expire en environ une heure. Lorsque c’est le cas, un nouveau token doit être récupéré, la configuration mise à jour, et Claude Code redémarré. Il n’y a pas de rafraîchissement automatique. Pour un usage régulier, c’est impraticable.

Le Toolbox résout ce problème en utilisant les Application Default Credentials, qui gèrent le rafraîchissement automatiquement.

Quand le Remote Server est pertinent

Le Remote Server est approprié quand toutes les conditions suivantes s’appliquent :

Utilisation de Claude Desktop (pas Claude Code)
Seule l’exploration BigQuery basique est nécessaire — lister les datasets, vérifier les schémas, exécuter des requêtes ad hoc
Les requêtes paramétrées personnalisées et le support multi-bases de données ne sont pas requis
Aucune infrastructure à gérer

Si l’une des conditions ne s’applique pas, utilisez le Toolbox. Consultez Choosing Between BigQuery MCP Options pour le cadre de décision complet.