自 2026 年 4 月 10 日起，Dataplex Universal Catalog 將更名為 Knowledge Catalog。API、用戶端程式庫、CLI 和 IAM 名稱維持不變。詳情請參閱「隆重推出 Google Cloud Knowledge Catalog」。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

搭配使用 MCP、Gemini 和其他代理的資料歷程

本頁說明如何將資料歷程與 Gemini CLI 等開發人員工具和其他 Model Context Protocol (MCP) 用戶端連結。將資料沿襲與這些工具連結後，您就能在開發環境中直接進行 AI 導向的沿襲追蹤和資料出處分析。

您可以使用本機 MCP Toolbox for Databases，連線至支援 MCP 的 IDE 和開發人員工具。然後，您可以在現有的 IDE 中使用 AI 代理，查詢資料沿襲圖、探索上游資料出處，以及分析資產的下游影響。

如要進一步瞭解 MCP，請參閱「Model Context Protocol 簡介」。

本指南將示範如何連結下列工具：

Gemini CLI
Gemini Code Assist
Claude Code
Claude 電腦版
Codex
Cline (VS Code 擴充功能)
Cursor
Visual Studio Code (Copilot)
Windsurf (舊稱 Codeium)

資料歷程提供哪些 MCP 工具？

資料沿襲整合功能可讓 AI 代理查詢及分析資料沿襲，呈現來源 (上游) 和目標 (下游) 資產之間的資料流。支援實體層級沿革 (追蹤資料在整個資產之間的流動，例如資料表和檔案)，以及資料欄層級沿革 (追蹤資料在資產內特定欄位或資料欄之間的流動)。

資料歷程提供 datalineage-search-lineage 工具，可擷取與所要求資產相關聯的歷程連結串流回應。

如要進一步瞭解資料歷程來源及其可用工具，請參閱資料歷程來源說明文件。

必要的角色

如要取得使用 MCP Toolbox 連線至資料歷程所需的權限，請要求管理員授予您專案的下列 IAM 角色：

如要啟用 API：服務使用情形管理員 (roles/serviceusage.serviceUsageAdmin)
如要使用資料歷程技能：資料歷程檢視者 (roles/datalineage.viewer)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備使用 MCP Toolbox 連線至資料歷程所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要使用 MCP Toolbox 連線至資料歷程，必須具備下列權限：

如要啟用 API，請按照下列步驟操作： serviceusage.services.enable
如要使用資料歷程技能，請按照下列步驟操作：
- datalineage.lineage.searchLinks
- datalineage.processes.get
- datalineage.runs.get

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

啟用必用的 API。

前往 Google Cloud 控制台的專案選擇器頁面。

前往專案選取器
選取或建立 Google Cloud 專案。
選取或建立專案所需的角色
- 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
- 建立專案：如要建立專案，您需要「專案建立者」角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。
注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。完成這些步驟後，您就可以刪除專案，並移除與該專案相關聯的所有資源。
確認專案已啟用計費功能 Google Cloud 。
啟用 Data Lineage API。
啟用 API 時所需的角色
如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。
啟用 API

如果您使用本機殼層，請為使用者帳戶建立本機驗證憑證：
```
gcloud auth application-default login
```
如果您使用 Cloud Shell，則不需要執行這項操作。

如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已使用聯合身分登入 gcloud CLI。

安裝 MCP Toolbox

如果您只打算使用 Gemini Code Assist，就不需要安裝 MCP Toolbox，因為這項工具已內建必要的伺服器功能。如要使用其他 IDE 和工具，請按照本節步驟安裝 MCP Toolbox。

以二進位檔形式下載最新版 MCP Toolbox。選取與 OS 和 CPU 架構對應的 MCP Toolbox 二進位檔發布。您必須使用 MCP Toolbox v0.31.0 以上版本。
Linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
將 VERSION 替換成 MCP Toolbox 版本，例如 v0.31.0。
macOS (Darwin)/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
將 VERSION 替換成 MCP Toolbox 版本，例如 v0.31.0。
macOS (Darwin)/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
將 VERSION 替換成 MCP Toolbox 版本，例如 v0.31.0。
Windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
將 VERSION 替換成 MCP Toolbox 版本，例如 v0.31.0。
將該二進位檔設為可執行：
```
chmod +x toolbox
```
驗證安裝項目：
```
./toolbox --version
```
安裝成功後，系統會傳回版本號碼，例如 0.15.0。

設定用戶端和連線，以取得資料歷程

本節說明如何將資料沿襲連結至工具。

如要將 MCP 相容的 IDE 和工具連結至資料歷程，請先安裝 MCP Toolbox，並為歷程來源和工具建立自訂設定檔。

在專案根目錄或設定目錄中，建立名為 lineage-config.yaml 的 YAML 檔案，並加入下列設定：

kind: source
name: lineage-source
type: datalineage
project: ${DATALINEAGE_PROJECT}
---
kind: tool
name: search_lineage
type: datalineage-search-lineage
source: lineage-source
description: Retrieves a streaming response of lineage links connected to requested assets.

設定 Google Cloud 專案的環境變數：
```
export DATALINEAGE_PROJECT=PROJECT_ID
```
將 PROJECT_ID 替換為 Google Cloud 專案 ID。
請使用 --config 旗標設定特定用戶端，而非預先建構的設定，如以下各節所示。

Gemini CLI

您可以使用 MCP Toolbox 和自訂 lineage-config.yaml 檔案，將資料歷程設定為本機 MCP 伺服器，在 Gemini CLI 中使用資料歷程。

在專案的工作目錄中，建立名為 .gemini 的資料夾 (或開啟全域 ~/.gemini 目錄)。
在該目錄中，建立或開啟 settings.json 檔案。

新增下列設定：

{
  "mcpServers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

儲存設定。
以互動模式啟動 Gemini CLI：
```
gemini
```
在 Gemini CLI 中，使用 /mcp 指令確認 dataLineage 伺服器已連線。

Gemini Code Assist

Gemini Code Assist 會一併提供必要的 MCP 伺服器功能，因此您不必另外安裝 MCP Toolbox。

在 VS Code 中安裝 Gemini Code Assist 擴充功能。
在 Gemini Code Assist 對話中啟用 Agent 模式。
在工作目錄中，建立名為 .gemini 的資料夾。在該檔案中，建立 settings.json 檔案。

新增下列設定：

{
  "mcpServers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

儲存設定。

Claude Code

雖然官方外掛程式提供 Knowledge Catalog 工具，但您可以透過自訂設定檔設定本機 MCP Toolbox 伺服器，在 Claude Code 中使用資料歷程。

設定環境變數，連線至資料沿革專案：
```
export DATALINEAGE_PROJECT=PROJECT_ID
```
將 PROJECT_ID 替換為 Google Cloud 專案 ID。

設定 Claude Code，使用 MCP Toolbox 伺服器：

claude mcp add datalineage -- /PATH/TO/toolbox --config=/PATH/TO/lineage-config.yaml --stdio

啟動代理程式：
```
claude
```

Codex

如要在 Codex 中使用資料沿襲功能，請在 Codex 設定中設定 MCP 伺服器連線，然後使用自訂 lineage-config.yaml 檔案執行 MCP Toolbox：

設定環境變數，連線至資料沿革專案：
```
export DATALINEAGE_PROJECT="PROJECT_ID"
```
將 PROJECT_ID 替換為 Google Cloud 專案 ID。

在 Codex MCP 設定中，使用 MCP Toolbox 新增伺服器：

{
  "mcpServers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

Claude 電腦版

開啟 Claude Desktop，然後前往「設定」。
如要開啟設定檔，請在「開發人員」分頁中，按一下「編輯設定」。

新增設定：

{
  "mcpServers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

儲存設定。
重新啟動 Claude 電腦版。新的即時通訊畫面會顯示代表新 MCP 伺服器的 MCP 圖示。

Cline

在 VS Code 中開啟 Cline 擴充功能，然後按一下「MCP Servers」圖示。
如要開啟設定檔，請輕觸「設定 MCP 伺服器」。

新增下列設定：

{
  "mcpServers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

儲存設定。伺服器連線成功後，狀態會顯示為綠色「已啟用」。

Cursor

在專案根目錄中建立 .cursor 目錄 (如果不存在)。
如果 .cursor/mcp.json 檔案不存在，請建立並開啟該檔案。

新增下列設定：

{
  "mcpServers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

儲存設定。
開啟「游標」，然後依序前往「設定」>「游標設定」>「MCP」。伺服器連線後，會顯示綠色的「Active」(已啟用) 狀態。

VS Code (Copilot)

開啟 VS Code，並在專案根目錄中建立 .vscode 目錄 (如果不存在)。
如果 .vscode/mcp.json 檔案不存在，請建立並開啟該檔案。

新增下列設定：

{
  "servers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

儲存設定。

滑浪風帆

開啟 Windsurf，然後前往 Cascade 助理。
如要開啟設定檔，請點選 MCP 圖示，然後按一下「設定」。

新增下列設定：

{
  "mcpServers": {
    "dataLineage": {
      "command": "./PATH/TO/toolbox",
      "args": ["--config","/PATH/TO/lineage-config.yaml","--stdio"],
      "env": {
        "DATALINEAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

將 PROJECT_ID 替換為 Google Cloud 專案 ID。

儲存設定。

使用技能

AI 助理現已連結至資料沿襲。試試看要求 AI 助理追蹤資產間的上游和下游資料沿襲。

例如，你可以要求 AI 助理：

追蹤 BigQuery 資料表資料的來源 (上游歷程)。
瞭解哪些下游資料表或報表會依附特定資料資產 (下游歷程)。
檢查資產中特定欄位之間的資料欄層級沿襲。

選用：新增系統指令

系統指令可為 LLM 提供特定指引，協助模型瞭解脈絡並生成更準確的回覆。根據資料歷程建議的系統提示詞設定系統指令。

舉例來說，您可以新增指令，引導 LLM 如何使用資料歷程技能：

如果需要追蹤資產或資料欄之間的上游或下游資料流程，請使用 search_lineage 技能或 datalineage-search-lineage 工具。

如要進一步瞭解如何設定指令，請參閱「使用指令取得符合您編碼風格的 AI 編輯內容」。

後續步驟

瞭解本機和遠端 MCP 伺服器的差異。
瞭解如何使用本機 MCP Toolbox 伺服器存取 Knowledge Catalog。
請參閱資料沿襲 MCP 工具參考資料。
進一步瞭解資料歷程。
在 Knowledge Catalog 中搜尋資源。

搭配使用 MCP、Gemini 和其他代理的資料歷程 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

資料歷程提供哪些 MCP 工具？

必要的角色

所需權限

啟用必用的 API。

安裝 MCP Toolbox

Linux/amd64

macOS (Darwin)/arm64

macOS (Darwin)/amd64

Windows/amd64

設定用戶端和連線，以取得資料歷程

Gemini CLI

Gemini Code Assist

Claude Code

Codex

Claude 電腦版

Cline

Cursor

VS Code (Copilot)

滑浪風帆

使用技能

選用：新增系統指令

後續步驟

搭配使用 MCP、Gemini 和其他代理的資料歷程