BigQuery MCP einrichten: Projekt, IAM und Lesetest
Beginnen Sie mit einem bekannten Dataset und einer kleinen Abfrage. Halten Sie Datenzugriff und Berechtigung zum Ausführen eines Jobs getrennt fest.
Ein Tabellenname allein reicht für einen nachvollziehbaren BigQuery-Test nicht aus. Notieren Sie vor der Einrichtung, in welchem Projekt Ihre Daten liegen und über welches Projekt die Abfrage läuft. Wählen Sie einen kleinen, bekannten Testbestand mit unveränderlichen Beispieldaten. So erkennen Sie später, ob eine abweichende Antwort aus der Verbindung, der Projektauswahl oder einer veränderten Datenbasis stammt. Der erste Versuch soll eine konkrete Frage beantworten: Kommt genau der vorbereitete Ausschnitt zurück?
Den dokumentierten Remote-Zugang wählen
Google dokumentiert einen verwalteten HTTP-Zugang. Die BigQuery-API muss für das verwendete Projekt aktiviert sein. Der Endpunkt lautet:
https://bigquery.googleapis.com/mcpDie Anmeldung erfolgt über OAuth und die Berechtigung über IAM. Folgen Sie der Herstelleranleitung für Ihren Client; ein URL-Eintrag allein richtet die Anmeldung noch nicht ein. Klären Sie vorab, welche Identität den Abruf ausführt. Die Anmeldegrundlagen helfen bei der Unterscheidung der Zugangsarten.
Drei Rechtefragen getrennt beantworten
| Grenze | Vor dem Test festhalten | Am Ergebnis prüfen |
|---|---|---|
| MCP-Aufruf | MCP Tool User beziehungsweise passende Einzelrechte | Der Werkzeugaufruf ist erlaubt |
| Abfragejob | Jobberechtigung im Abfrageprojekt | Der Job läuft im vorgesehenen Projekt |
| Tabellendaten | Leserecht auf den vorgesehenen Daten | Die Testtabelle ist sichtbar |
Einen kleinen Lesetest vorbereiten
Öffnen Sie die Testtabelle in der BigQuery-Konsole. Notieren Sie den vollständigen Namen mit Projekt und Dataset, zwei benötigte Spalten und die erwarteten Werte von höchstens fünf Zeilen.
Prüfen Sie die Werkzeugliste des gewählten Clients. Für Leseaufgaben dokumentiert Google execute_sql_readonly. Wählen Sie den passenden Leseweg und kontrollieren Sie trotzdem die Rechte der verwendeten Identität.
Verwenden Sie eine ausdrückliche Spaltenauswahl, einen begrenzenden Filter und eine stabile Sortierung. Begrenzen Sie die Ausgabe zusätzlich. Halten Sie den Abfragetext vor der Ausführung fest, damit beide Tests dieselbe Frage stellen.
Vergleichen Sie die Ausgabe mit der Konsole. Notieren Sie Jobkennung, Datenmenge und Abfragezeitpunkt neben den erwarteten Werten. Wenige Ergebniszeilen sagen allein nichts darüber, wie groß der untersuchte Datenbestand war.
Fehlende Rechte und leere Ergebnisse unterscheiden
Bei einem Zugriffsfehler prüfen Sie nacheinander Identität, MCP-Aufrufrecht, Jobberechtigung und Datenleserecht. Bei einer erfolgreichen, aber leeren Abfrage beginnen Sie dagegen mit dem vollständigen Tabellennamen und dem Filter. Ändern Sie nur eine Einstellung pro Versuch und bewahren Sie die ursprüngliche Abfrage auf. Vergleichen Sie Datumswerte ausdrücklich mit ihrer Zeitzone. Eine neue Anmeldung kann einen falschen Dataset-Namen nicht korrigieren.
Im Datenbankplaner wählen Sie zwischen Strukturprüfung, Lesezugriff und der Vorbereitung späterer Änderungen. Die BigQuery-Registersuche zeigt separat die im Register geführten Einträge. Nutzen Sie den Leitfaden zum Lesezugriff, um eine Servereinstellung und tatsächliche Rechte auseinanderzuhalten.
- Ist die Adresse eine Verbindung zu genau meinem Dataset?
- Nein. Die Adresse bezeichnet den Dienst. Projekt, Dataset und Tabellen werden beim Zugriff ausgewählt und anhand Ihrer Rechte begrenzt.
- Warum reichen Tabellenleserechte nicht immer aus?
- Für eine Abfrage braucht die Identität auch die passenden Jobrechte im Abfrageprojekt und das Recht zum MCP-Aufruf. Prüfen Sie die drei Ebenen getrennt.
- Ist eine Ausgabe von fünf Zeilen automatisch eine kleine Abfrage?
- Nein. Halten Sie den untersuchten Datenbereich mit Filtern klein und prüfen Sie die verarbeitete Datenmenge. Ein Ausgabelimit ist kein Nachweis eines kleinen Scans.
- Was halte ich für einen späteren Vergleich fest?
- Vollständigen Tabellennamen, Abfragetext, Identität, Zeitpunkt und erwarteten Ausschnitt. Mit denselben Angaben lässt sich eine Abweichung nach einer Änderung gezielt nachstellen.
Dokumentation gelesen am 4. Oktober 2026. Die Prüfschritte sind ein Vorschlag für Ihre Umgebung und kein Bericht über eine hier getestete Verbindung.
- Google Cloud: BigQuery MCP setup
Abrufbefehl anzeigen
curl -s https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp - Google Cloud: BigQuery IAM roles
Abrufbefehl anzeigen
curl -s https://docs.cloud.google.com/bigquery/docs/access-control - Google Cloud: read-only SQL tool
Abrufbefehl anzeigen
curl -s https://docs.cloud.google.com/bigquery/docs/reference/mcp/tools_list/execute_sql_readonly