このページは Cloud Translation API によって翻訳されました。

MCP、Gemini、その他のエージェントで Dataplex Universal Catalog を使用する

このページでは、Dataplex Universal Catalog インスタンスを Gemini CLI などのデベロッパーツールに接続する方法について説明します。Dataplex Universal Catalog をこれらのツールに接続すると、IDE 内で AI を活用したデータ検出とアセット管理を直接行うことができます。

統合されたコマンドラインエクスペリエンスを実現するには、Gemini CLI 専用の Dataplex Universal Catalog 拡張機能を使用することをおすすめします。この拡張機能は、基盤となる Model Context Protocol（MCP）サーバーをバンドルします。このサーバーは Gemini CLI と Dataplex Universal Catalog の仲介役として機能するため、個別のサーバー設定は不要です。

または、汎用のデータベース向け MCP ツールボックスを使用して、MCP をサポートする他の IDE やデベロッパーツールを接続することもできます。既存の IDE で AI エージェントを使用して、Dataplex Universal Catalog のデータアセットを検出できます。MCP の詳細については、Model Context Protocol の概要をご覧ください。

このガイドでは、次のツールの接続プロセスについて説明します。

Gemini CLI（拡張機能経由）
Gemini Code Assist
Claude Code
Claude Desktop
Cline（VS Code 拡張機能）
Cursor
Visual Studio Code（Copilot）
Windsurf（旧 Codeium）

Gemini CLI と拡張機能について

Gemini CLI は、開発ワークフローを加速し、コーディング、デバッグ、データ探索、コンテンツ作成を支援する、Google のオープンソースの会話型 AI エージェントです。エージェント駆動型の操作性を提供し、Dataplex Universal Catalog などの Data Cloud サービスや、他の一般的なオープンソースデータベースとやり取りできます。

Gemini CLI の詳細については、Gemini CLI のドキュメントをご覧ください。

拡張機能の仕組み

拡張機能を使用すると、Gemini CLI の機能が拡張され、特定の Google Cloud サービスや他のツールに接続して制御できるようになります。Gemini にコンテキストと API の理解を提供し、会話型のやり取りを可能にします。Gemini CLI 拡張機能は、GitHub URL、ローカルディレクトリ、またはレジストリから読み込むことができます。これらの拡張機能は、新しいツール、スラッシュコマンド、プロンプトを提供します。これらは、MCP ツールボックスを使用して統合する Gemini Code Assist などの IDE 拡張機能とは異なります。

Dataplex Universal Catalog 拡張機能について

データベース向け MCP ツールボックスはベータ版（v1.0 より前）であり、最初の安定版リリース（v1.0）まで互換性を破る変更が行われる可能性があります。

Gemini CLI 用の Dataplex Universal Catalog 拡張機能は、AI をデータガバナンスと検出タスクに統合します。ターミナルで自然言語プロンプトを使用して、Dataplex Universal Catalog を操作できます。次に例を示します。

カテゴリ	ツール	自然言語プロンプトの例
データの検出とガバナンス	`dataplex_search_entries`	ヨーロッパでの販売に関連するすべてのデータセットを検索します。顧客の PII を含むテーブルを表示して。 Dataplex Universal Catalog の「マーケティング」レイクにあるすべての BigQuery データセットを一覧表示します。
	`dataplex_lookup_entry`	orders テーブルのスキーマは何ですか？顧客データベースに適用されるデータ品質ルールについて説明します。 `customer_details` テーブルのビジネスオーナーとして登録されているのは誰ですか？
	`dataplex_search_aspect_types`	データ品質ルールに関連するアスペクトタイプを表示して。データガバナンスに使用されるすべてのアスペクトタイプを一覧表示します。 PII データをマークするアスペクトタイプはありますか？

Dataplex Universal Catalog 拡張機能の詳細については、Gemini CLI 拡張機能 - Dataplex Universal Catalog をご覧ください。

必要なロールと権限

MCP Toolbox または Gemini CLI 拡張機能を使用して Dataplex Universal Catalog に接続するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールの付与を管理者に依頼してください。

API を有効にするには: Service Usage 管理者 （roles/serviceusage.serviceUsageAdmin）
Dataplex Universal Catalog ツールを使用するには: Dataplex Catalog 閲覧者 （roles/dataplex.catalogViewer）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、MCP Toolbox または Gemini CLI 拡張機能を使用して Dataplex Universal Catalog に接続するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

MCP ツールボックスまたは Gemini CLI 拡張機能を使用して Dataplex Universal Catalog に接続するには、次の権限が必要です。

API を有効にするには: serviceusage.services.enable
Dataplex Universal Catalog ツールを使用するには:
- dataplex.projects.search
- dataplex.entries.get
- dataplex.aspectTypes.get
- dataplex.aspectTypes.list

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

Dataplex Universal Catalog API を有効にする

このガイドのタスクを完了するために必要な権限を確認します。
In the Google Cloud console, go to the project selector page.

Go to project selector
Select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Verify that billing is enabled for your Google Cloud project.
Enable the Dataplex API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the API

If you're using a local shell, then create local authentication credentials for your user account:
```
gcloud auth application-default login
```
You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

MCP ツールボックスをインストールする

Gemini Code Assist または Gemini CLI 拡張機能のみを使用する場合は、必要なサーバー機能がバンドルされているため、MCP Toolbox をインストールする必要はありません。他の IDE とツールについては、このセクションの手順に沿って MCP ツールボックスをインストールします。

MCP ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。MCP ツールボックス v0.15.0 以降を使用する必要があります。
Linux / amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
VERSION は、MCP ツールボックスのバージョン（v0.15.0 など）に置き換えます。
macOS（Darwin）/ arm64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
VERSION は、MCP ツールボックスのバージョン（v0.15.0 など）に置き換えます。
macOS（Darwin）/ amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
VERSION は、MCP ツールボックスのバージョン（v0.15.0 など）に置き換えます。
Windows / amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
VERSION は、MCP ツールボックスのバージョン（v0.15.0 など）に置き換えます。
バイナリを実行可能にします。
```
chmod +x toolbox
```
インストールを確認します。
```
./toolbox --version
```
インストールが正常に完了すると、バージョン番号（0.15.0 など）が返されます。

クライアントと接続を設定する

このセクションでは、Dataplex Universal Catalog をツールに接続する方法について説明します。

Gemini Code Assist またはスタンドアロンの Gemini CLI を使用している場合は、これらのツールに必要なサーバー機能がバンドルされているため、MCP Toolbox をインストールまたは構成する必要はありません。設定手順については、[Gemini Code Assist] タブまたは [Gemini CLI 拡張機能] タブをご覧ください。

他の MCP 互換ツールと IDE の場合は、まず MCP ツールボックスをインストールする必要があります。このツールボックスは、IDE と Dataplex Universal Catalog の間に位置するオープンソースの Model Context Protocol（MCP）サーバーとして機能し、AI ツールに安全で効率的なコントロールプレーンを提供します。インストール後、特定のツールのタブを選択して構成手順を確認します。

Gemini CLI 拡張機能

このメソッドは、スタンドアロンの Gemini CLI ツール専用の dataplex 拡張機能を使用し、MCP ツールボックスは使用しません。

Gemini CLI をインストールします。
GitHub リポジトリから Gemini CLI 用 Dataplex Universal Catalog 拡張機能をインストールします。
```
gemini extensions install https://github.com/gemini-cli-extensions/dataplex
```
Dataplex Universal Catalog プロジェクトに接続するように環境変数を設定します。
```
export DATAPLEX_PROJECT="PROJECT_ID"
```
PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。
インタラクティブモードで Gemini CLI を起動します。
```
gemini
```
CLI は、Dataplex Universal Catalog 拡張機能とそのツールを自動的に読み込みます。これらのツールを使用して、データアセットを操作できます。

Gemini Code Assist

Gemini Code Assist には必要な MCP サーバー機能がバンドルされているため、MCP Toolbox を個別にインストールする必要はありません。

VS Code で、Gemini Code Assist 拡張機能をインストールします。
Gemini Code Assist のチャットでエージェントモードを有効にします。
作業ディレクトリに .gemini という名前のフォルダを作成します。その中に settings.json ファイルを作成します。

次の構成を追加し、環境変数を実際の値に置き換えて保存します。

  {
    "mcpServers": {
      "dataplex": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","dataplex","--stdio"],
        "env": {
          "DATAPLEX_PROJECT": "PROJECT_ID"
        }
      }
    }
  }

Claude Code

Claude Code をインストールします。
.mcp.json ファイルが存在しない場合は、プロジェクトのルートに作成します。

構成を追加し、環境変数を実際の値に置き換えて保存します。

  {
    "mcpServers": {
      "dataplex": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","dataplex","--stdio"],
        "env": {
          "DATAPLEX_PROJECT": "PROJECT_ID"
        }
      }
    }
  }

Claude Desktop

Claude Desktop を開き、[Settings] に移動します。
構成ファイルを開くには、[デベロッパー] タブで [構成を編集] をクリックします。

構成を追加し、環境変数を実際の値に置き換えて保存します。

  {
    "mcpServers": {
      "dataplex": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","dataplex","--stdio"],
        "env": {
          "DATAPLEX_PROJECT": "PROJECT_ID"
        }
      }
    }
  }

Claude Desktop を再起動します。
新しいチャット画面に、新しい MCP サーバーの MCP アイコンが表示されます。

Cline

VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをクリックします。
構成ファイルを開くには、[Configure MCP Servers] をタップします。

次の構成を追加し、環境変数を実際の値に置き換えて保存します。

  {
    "mcpServers": {
      "dataplex": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","dataplex","--stdio"],
        "env": {
          "DATAPLEX_PROJECT": "PROJECT_ID"
        }
      }
    }
  }

サーバーが正常に接続されると、緑色のアクティブステータスが表示されます。

Cursor

プロジェクトのルートに .cursor ディレクトリが存在しない場合は作成します。
.cursor/mcp.json ファイルが存在しない場合は作成し、開きます。

次の構成を追加し、環境変数を実際の値に置き換えて保存します。

  {
    "mcpServers": {
      "dataplex": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","dataplex","--stdio"],
        "env": {
          "DATAPLEX_PROJECT": "PROJECT_ID"
        }
      }
    }
  }

Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーに接続すると、緑色のアクティブステータスが表示されます。

VS Code（Copilot）

VS Code を開き、プロジェクトのルートに .vscode ディレクトリがない場合は作成します。
.vscode/mcp.json ファイルが存在しない場合は作成してから、それを開きます。

次の構成を追加し、環境変数を実際の値に置き換えて保存します。

  {
    "servers": {
      "dataplex": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","dataplex","--stdio"],
        "env": {
          "DATAPLEX_PROJECT": "PROJECT_ID"
        }
      }
    }
  }

Windsurf

Windsurf を開き、Cascade アシスタントに移動します。
構成ファイルを開くには、MCP アイコンをクリックし、[Configure] をクリックします。

次の構成を追加し、環境変数を実際の値に置き換えて保存します。

  {
    "mcpServers": {
      "dataplex": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","dataplex","--stdio"],
        "env": {
          "DATAPLEX_PROJECT": "PROJECT_ID"
        }
      }
    }
  }

ツールを使用する

AI ツールが Dataplex Universal Catalog に接続されました。AI アシスタントに、BigQuery データセットや Cloud SQL インスタンスなどのデータアセットを検索するように指示してください。

次のツールで LLM を使用できます。

dataplex_search_entries: データアセットを検索する
dataplex_lookup_entry: データアセットのメタデータ（スキーマ、使用状況、ビジネスの概要、連絡先など）を取得する
dataplex_search_aspect_types: アスペクトタイプを検索する

省略可: システム指示を追加する

システム指示は、LLM に特定のガイドラインを提供し、コンテキストを理解してより正確に応答できるようにするための方法です。推奨されるシステムプロンプトに基づいてシステム指示を設定します。

たとえば、Dataplex Universal Catalog ツールを使用する方法について LLM をガイドする手順を追加できます。

データセットまたはテーブルの検索を求められた場合は、dataplex_search_entries ツールを使用します。
データ品質ルールや所有権などのテーブルスキーマやメタデータの詳細を求められた場合は、dataplex_lookup_entry ツールを使用します。
ガバナンスルールや分類について質問された場合は、まず dataplex_search_aspect_types を使用して関連するアスペクトタイプを見つけます。

手順の構成方法について詳しくは、手順を使用してコーディングスタイルに従った AI 編集を取得するをご覧ください。

次のステップ

Dataplex Universal Catalog のカタログ検索の詳細を確認する。
Dataplex Universal Catalog Catalog にカスタムソースを取り込む方法を確認する。
アスペクトタイプを使用してメタデータを管理する方法を確認する。

MCP、Gemini、その他のエージェントで Dataplex Universal Catalog を使用する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Gemini CLI と拡張機能について

拡張機能の仕組み

Dataplex Universal Catalog 拡張機能について

必要なロールと権限

必要な権限

Dataplex Universal Catalog API を有効にする

MCP ツールボックスをインストールする

Linux / amd64

macOS（Darwin）/ arm64

macOS（Darwin）/ amd64

Windows / amd64

クライアントと接続を設定する

Gemini CLI 拡張機能

Gemini Code Assist

Claude Code

Claude Desktop

Cline

Cursor

VS Code（Copilot）

Windsurf

ツールを使用する

省略可: システム指示を追加する

次のステップ

MCP、Gemini、その他のエージェントで Dataplex Universal Catalog を使用する