Looker を MCP、Gemini CLI、その他のエージェントで使用する
このページでは、Looker インスタンスをさまざまなデベロッパー ツールに接続する方法について説明します。
最も強力で統合されたエクスペリエンスを実現するには、Gemini CLI 用の専用の Looker 拡張機能を使用することをおすすめします。Looker のセマンティック レイヤを使用して、Gemini CLI に信頼できるデータへの安全で管理されたオンデマンド アクセスを提供し、自然言語プロンプトからレポート、可視化、ダッシュボードの作成を自動化してワークフローを加速します。 Google Cloudの次世代コマンドライン インターフェースである Gemini CLI は、コマンドラインから Looker インスタンスを操作する場合におすすめのツールです。
汎用の データベース向け MCP ツールボックスを使用して、Model Context Protocol(MCP)をサポートする他の統合開発環境(IDE)やデベロッパー ツールを接続することもできます。MCP ツールボックスは、認証や接続プーリングなどの複雑な処理を処理することで、AI エージェントをデータに簡単に接続できるオープンソースの MCP サーバーです。これにより、IDE から自然言語を使用してデータを直接操作できます。これらのツールでは、この方法がデータベース操作のコア機能となります。
Gemini CLI と拡張機能について
Gemini CLI は、コーディング、デバッグ、データ探索、コンテンツ作成を支援することで、開発ワークフローを加速するように設計されたオープンソースの AI エージェントです。データクラウド サービスや一般的なオープンソース データベースを操作できるエレガントなエージェント エクスペリエンスを提供することを目的としています。
拡張機能の仕組み
Gemini CLI は拡張性が高く、拡張機能を通じて新しいツールや機能を追加できます。これらの拡張機能は簡単にインストールできます。これらは、GitHub URL、ローカル ディレクトリ、構成可能なレジストリから読み込むことができます。これらの拡張機能は、ワークフローを効率化するための新しいツール、スラッシュ コマンド、プロンプトなど、豊富な機能を提供します。
Looker 認証を準備する
標準の API 認証情報または OAuth アプリケーション登録を使用して、MCP クライアントを Looker で認証できます。
オプション 1: API 認証情報
- Looker クライアント ID とクライアント シークレットを取得します。Looker API の認証のドキュメント ページに記載されている手順に沿って操作します。
- Looker インスタンスのベース URL を用意します。
https://looker.example.comのような形式になります。API が別のポートでリッスンしている場合は、https://looker.example.com:19999を使用する必要があります。
オプション 2: OAuth アプリケーションの登録
Looker API Explorer を開きます。
API Explorer がインストールされている
Looker インスタンスに API Explorer がすでにインストールされている場合は、次の URL 形式でアクセスできます。
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/API Explorer がインストールされていない
Looker インスタンスに API Explorer がない場合は、Looker Marketplace からインストールできます。API Explorer のインストール方法については、API Explorer の使用ページをご覧ください。
PSA プライベート インスタンス
プライベート サービス アクセスを使用する Looker(Google Cloud コア)プライベート接続インスタンスを使用している場合、Looker Marketplace と API Explorer はサポートされていません。AI エージェントを登録するには、
oauth_client_appsAPI エンドポイントを直接呼び出す必要があります。この方法を使用する場合は、この API Explorer 手順の残りのステップをスキップできます。次の例は、
oauth_client_appsエンドポイントで使用してエージェントを登録できるcurlコマンドです。curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \ -H "Authorization: token ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "redirect_uri": "REDIRECT_URI", "display_name": "CLIENT_NAME", "description": "OAuth client to access MCP server using CLIENT_NAME", "enabled": true }'[認証] メソッドで、[OAuth アプリを登録] API エンドポイントを見つけます。検索フィールドで「oauth app」を検索することもできます。
[実行] を選択します。
client_guidにカスタム文字列(gemini_cli、claude-desktopなど)を入力します。リクエストの本文に、次の JSON 構成を入力します。
{ "redirect_uri": "AI_AGENT_REDIRECT_URI", "display_name": "APPLICATION_NAME", "description": "APPLICATION_DESCRIPTION", "enabled": true }次のように置き換えます。
AI_AGENT_REDIRECT_URI: AI エージェント拡張機能または共有サービス アプリケーションのリダイレクト URI。- クラウドホスト型アプリケーションの場合、安全な HTTPS URL(
https://AI_AGENT_URL/oauth2callback)のように見えることがあります。 ローカルで実行されているアプリケーションの場合は、静的ポートを含む localhost URL にする必要があります。
http://localhost:7777/oauth/callbackIDE の場合は、次のようになります。
vscode://google.vscode-looker-official/oauth_callback
- クラウドホスト型アプリケーションの場合、安全な HTTPS URL(
APPLICATION_NAME: OAuth アプリケーションの表示名(例:Claude Desktop)。APPLICATION_DESCRIPTION: OAuth アプリケーションの簡単な説明。
[この API エンドポイントがデータを変更することを理解しています] の横にある確認ボックスをオンにして、[実行] を選択します。
MCP ツールボックスをインストールする
MCP ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティング システムと CPU アーキテクチャに対応するバイナリを選択します。MCP ツールボックス バージョン V1.0.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/windows/amd64/toolbox.exe
バイナリを実行可能にします。
chmod +x toolboxインストールを確認します。
./toolbox --version
MCP ツールボックスを共有サービスとして実行する
HTTPS 経由で OAuth 認証を必要とする MCP クライアントの場合、MCP Toolbox を HTTPS リバース プロキシ(Cloud Run など)の背後にデプロイする必要があります。リバース プロキシは SSL を終端し、リクエストを MCP ツールボックス コンテナに転送します。
サーバー環境を構成する
デプロイに次の環境変数を設定します。
LOOKER_BASE_URL=YOUR_LOOKER_BASE_URLLOOKER_USE_CLIENT_OAUTH=true
次の引数を指定して MCP ツールボックスを実行します。
--prebuilt=looker,looker-dev--mcp-prm-file=prm.json[--address=0.0.0.0][--port=8080]
MCP ツールボックスは通常、
127.0.0.1ポート5000をリッスンします。リバース プロキシが別のホストにある場合は、--address=0.0.0.0を使用してすべての IP アドレスにバインドします。5000以外のリスニング ポートを使用する必要がある場合は、--port=設定を使用します。たとえば、Cloud Run は、ポート443(HTTPS ポート)からの外部トラフィックを8080に自動的に転送します。次の構造で Protected Resource Metadata(PRM)構成ファイル(
prm.json)を作成します。{ "resource": "https://PROXY_URL/mcp", "authorization_servers": ["LOOKER_URL"], "scopes_supported": ["cors_api"] }次のように置き換えます。
PROXY_URL: リバース プロキシ サーバーのドメインとベースパス。LOOKER_URL: Looker インスタンスのベース URL。
MCP ツールボックスを共有サービスとして実行している場合にクライアントを構成する方法の例については、Claude デスクトップ構成の例をご覧ください。
MCP クライアントを構成する
このセクションでは、データベース向け MCP ツールボックスを使用して Looker インスタンスに接続するようにさまざまなデベロッパー ツールを構成する方法について説明します。このツールボックスは、IDE とデータベースの間に配置されるオープンソースの Model Context Protocol(MCP)サーバーとして機能し、AI ツール用の安全で効率的なコントロール プレーンを提供します。特定のツールのタブを選択して、構成手順を確認します。
- Gemini CLI
- Gemini Code Assist
- Claude Code
- Claude Desktop
- Cline(VS Code 拡張機能)
- Cursor
- Visual Studio Code(Copilot)
- Windsurf(Codium)
Gemini CLI
認証方法に基づいて接続方法を選択します。
オプション 1: 拡張機能付きの API 認証情報
- Gemini CLI をインストールします。
- 次のコマンドを使用して、GitHub リポジトリから Gemini CLI 用の Looker 拡張機能をインストールします。
gemini extensions install https://github.com/gemini-cli-extensions/looker
- Looker インスタンスに接続する環境変数を設定します。次の環境変数を実際の値に置き換えます。
LOOKER_URL: Looker インスタンスの URL。CLIENT_IDとCLIENT_SECRET: Looker API へのアクセスに使用される API キー。VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、trueまたはfalse。
export LOOKER_BASE_URL="LOOKER_URL" export LOOKER_CLIENT_ID="CLIENT_ID" export LOOKER_CLIENT_SECRET="CLIENT_SECRET" export LOOKER_VERIFY_SSL="VERIFY_SSL"
- インタラクティブ モードで Gemini CLI を起動します。
CLI は、Gemini CLI 拡張機能用の Looker 拡張機能とそのツールを自動的に読み込みます。これらのツールを使用して、Looker インスタンスを操作できます。gemini
オプション 2: OAuth を使用したリモート共有サービス
OAuth を使用してリモート共有サービスに接続する場合は、Looker 拡張機能をインストールしないでください。代わりに、リモート MCP サーバーに直接接続するように Gemini CLI を構成します。
- Gemini CLI をインストールします。
- 次のコマンドを使用して、リモート MCP サーバーを追加します。
PROXY_URLは、リバース プロキシ サーバーのドメインに置き換えます。gemini mcp add --transport http looker https://PROXY_URL/mcp
または、
settings.jsonファイル(~/.gemini/settings.jsonまたはプロジェクト ディレクトリにあります)に次の構成を追加して、手動で構成することもできます。{ "mcpServers": { "looker": { "httpUrl": "https://PROXY_URL/mcp" } } } - インタラクティブ モードで Gemini CLI を起動します。
接続を求めるプロンプトが表示されたら、CLI は OAuth 認証フローを開始して、Looker インスタンスで安全に認証します。gemini
Gemini Code Assist
Gemini CLI を使用するように Gemini Code Assist を構成することをおすすめします。このアプローチでは、MCP サーバーを手動で構成する必要がなくなります。
- Gemini CLI と、
looker拡張機能(API 認証情報の場合)またはリモート MCP サーバー構成(OAuth を使用する共有サービスの場合)がインストールされ、構成されていることを確認します。 - Gemini CLI を使用するように Gemini Code Assist を構成します。
- Gemini Code Assist チャット内で自然言語を使用して Looker インスタンスとのやり取りを開始します。
Claude Code
認証方法に基づいて接続方法を選択します。
オプション 1: API 認証情報
- Claude Code をインストールします。
- プロジェクトのルートに
.mcp.jsonファイルが存在しない場合は作成します。 - 次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
LOOKER_URL: Looker インスタンスの URL。CLIENT_IDとCLIENT_SECRET: Looker API へのアクセスに使用される API キー。VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、trueまたはfalse。
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
オプション 2: OAuth を使用したリモート共有サービス
- Claude Code をインストールします。
- プロジェクトのルートに
.mcp.jsonファイルが存在しない場合は作成します。 - 次の構成を追加し、
PROXY_URLをリバース プロキシ サーバーのドメインに置き換えて保存します。
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
Claude Desktop
認証方法に基づいて接続方法を選択します。
オプション 1: API 認証情報
- Claude デスクトップを開き、[設定] に移動します。
- [Developer] タブで [Edit Config] をクリックして、構成ファイルを開きます。
- 次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
LOOKER_URL: Looker インスタンスの URL。CLIENT_IDとCLIENT_SECRET: Looker API へのアクセスに使用される API キー。VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、trueまたはfalse。
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
オプション 2: OAuth を使用したリモート共有サービス
- Claude デスクトップで、[設定] に移動し、[コネクタ] を選択します。
- [カスタム コネクタを追加] を選択し、名前(Looker など)を入力します。
- URL には、
/mcpパスが付加されたリバース プロキシ サーバーのエンドポイントを入力します(例:https://looker-mcp-toolbox.example.com/mcp)。 - [詳細設定] で、OAuth アプリの登録時に
client_guidに使用した文字列を正確に入力します。OAuth クライアント シークレットは空白のままにします。 - [追加] を選択してコネクタを保存します。接続を求めるプロンプトが表示されると、Claude デスクトップはブラウザを介して PKCE 認証フローを安全に開始します。
- Claude Desktop を再起動します。
Cline
認証方法に基づいて接続方法を選択します。
オプション 1: API 認証情報
- VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをクリックします。
- [Configure MCP Servers] をクリックして構成ファイルを開きます。
- 次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
LOOKER_URL: Looker インスタンスの URL。CLIENT_IDとCLIENT_SECRET: Looker API へのアクセスに使用される API キー。VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、trueまたはfalse。
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
オプション 2: OAuth を使用したリモート共有サービス
- VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをクリックします。
- [Configure MCP Servers] をクリックして構成ファイルを開きます。
- 次の構成を追加し、
PROXY_URLをリバース プロキシ サーバーのドメインに置き換えて保存します。
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
Cursor
認証方法に基づいて接続方法を選択します。
オプション 1: API 認証情報
- プロジェクトのルートに
.cursorディレクトリが存在しない場合は作成します。 .cursor/mcp.jsonファイルが存在しない場合は作成したうえで、それを開きます。- 次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
LOOKER_URL: Looker インスタンスの URL。CLIENT_IDとCLIENT_SECRET: Looker API へのアクセスに使用される API キー。VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、trueまたはfalse。
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
- Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーが接続されると、緑色のアクティブ ステータスが表示されます。
オプション 2: OAuth を使用したリモート共有サービス
- プロジェクトのルートに
.cursorディレクトリが存在しない場合は作成します。 .cursor/mcp.jsonファイルが存在しない場合は作成したうえで、それを開きます。- 次の構成を追加し、
PROXY_URLをリバース プロキシ サーバーのドメインに置き換えて保存します。
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
- Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーが接続されると、緑色のアクティブ ステータスが表示されます。
Visual Studio Code(Copilot)
認証方法に基づいて接続方法を選択します。
オプション 1: API 認証情報
- VS Code を開き、プロジェクトのルートに
.vscodeディレクトリが存在しない場合は作成します。 .vscode/mcp.jsonファイルが存在しない場合は作成したうえで、それを開きます。- 次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
LOOKER_URL: Looker インスタンスの URL。CLIENT_IDとCLIENT_SECRET: Looker API へのアクセスに使用される API キー。VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、trueまたはfalse。
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
オプション 2: OAuth を使用したリモート共有サービス
- VS Code を開き、プロジェクトのルートに
.vscodeディレクトリが存在しない場合は作成します。 .vscode/mcp.jsonファイルが存在しない場合は作成したうえで、それを開きます。- 次の構成を追加し、
PROXY_URLをリバース プロキシ サーバーのドメインに置き換えて保存します。
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
Windsurf
認証方法に基づいて接続方法を選択します。
オプション 1: API 認証情報
- Windsurf を開き、Cascade アシスタントに移動します。
- MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
- 次の構成を追加し、次の環境変数を実際の値に置き換えて保存します。
LOOKER_URL: Looker インスタンスの URL。CLIENT_IDとCLIENT_SECRET: Looker API へのアクセスに使用される API キー。VERIFY_SSL: データベースを Looker インスタンスに接続するために SSL 暗号化を使用するかどうかに応じて、trueまたはfalse。
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
オプション 2: OAuth を使用したリモート共有サービス
- Windsurf を開き、Cascade アシスタントに移動します。
- MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
- 次の構成を追加し、
PROXY_URLをリバース プロキシ サーバーのドメインに置き換えて保存します。
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
AI ツールを使用する
AI ツールが MCP を使用して Looker に接続されました。AI アシスタントにモデル、Explore、ディメンション、メジャーのリスト表示を依頼してみてください。クエリの SQL を取得するか、保存した Look を実行して、クエリを実行することもできます。
次のツールで LLM を使用できます。
Looker のモデルツールとクエリツール
これらのツールは、Looker モデルに関する情報を取得し、そのモデルに対してクエリを実行するために使用されます。
get_models: Looker インスタンスのすべての LookML モデルを一覧表示します。get_explores: 指定されたモデルの探索を一覧表示します。get_dimensions: 指定された Explore のディメンションを一覧表示します。get_measures: 指定された Explore の指標を一覧表示します。get_filters: 指定された Explore のフィルタを一覧表示します。get_parameters: 指定された Explore のパラメータを一覧表示します。query: クエリを実行してデータを返します。query_sql: クエリ用に Looker によって生成された SQL を返します。query_url: 詳細な分析を行うために、Looker のクエリへのリンクを返します。
Looker コンテンツ ツール
これらのツールは、Looker インスタンスから保存されたコンテンツ(Look とダッシュボード)を取得し、新しい保存済みコンテンツを作成します。
get_looks: タイトルまたは説明に一致する保存済みのルックを返します。run_look: 保存した Look を実行してデータを返します。make_look: Looker で保存済みの Look を作成し、URL を返します。get_dashboards: タイトルまたは説明に一致する保存済みダッシュボードを返します。make_dashboard: Looker で保存済みダッシュボードを作成し、URL を返します。add_dashboard_element: ダッシュボードにタイルを追加します。
Looker インスタンスのヘルスツール
これらのツールは、一般的な CLI Henry が提供するのと同じヘルスチェック アルゴリズムを提供します。
health_pulse: Looker インスタンスの健全性を確認します。health_analyze: Looker オブジェクトの使用状況を分析します。health_vacuum: 使用されていない可能性のある LookML 要素を検索します。
LookML 作成ツール
これらのツールを使用すると、呼び出し元は LookML ファイルの作成と変更を行うとともに、LookML を効果的に記述するために必要なデータベース スキーマを取得できます。
dev_mode: セッションの開発モードをオンまたはオフにします。LookML の作成は開発モードで行う必要があります。開発モードで実行されるクエリは、変更された LookML を使用するため、変更の影響をテストできます。get_projects: 利用可能な LookML プロジェクトのリストを取得します。get_project_files: プロジェクト内の LookML ファイルのリストを取得します。get_project_file: LookML ファイルのコンテンツを取得します。create_project_file: 新しい LookML ファイルを作成します。update_project_file: 既存の LookML ファイルを変更します。delete_project_file: LookML ファイルを削除します。get_connections: 接続のリストを取得します。get_connection_schemas: 接続のスキーマのリストを取得します。get_connection_databases: 接続のデータベースのリストを取得します。get_connection_tables: 接続のテーブルのリストを取得します。get_connection_table_columns: 接続内のテーブルの列のリストを取得します。