Mulai 10 April 2026, Dataplex Universal Catalog kini disebut Knowledge Catalog. Nama API, library klien, CLI, dan IAM tidak berubah. Untuk mengetahui informasi selengkapnya, lihat Memperkenalkan Katalog Pengetahuan Google Cloud.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menggunakan asal-usul data dengan MCP, Gemini, dan agen lainnya

Halaman ini menjelaskan cara menghubungkan silsilah data ke alat developer seperti Gemini CLI dan klien Model Context Protocol (MCP) lainnya. Menghubungkan silsilah data ke alat ini memungkinkan pelacakan silsilah berbasis AI dan analisis asal data langsung dalam lingkungan pengembangan Anda.

Anda dapat menghubungkan IDE dan alat developer yang mendukung MCP menggunakan MCP Toolbox for Databases lokal. Kemudian, Anda dapat menggunakan agen AI di IDE yang ada untuk membuat kueri grafik silsilah data, menemukan asal data hulu, dan menganalisis dampak hilir di seluruh aset Anda.

Untuk mengetahui informasi selengkapnya tentang MCP, lihat Pengantar Model Context Protocol.

Panduan ini menunjukkan proses koneksi untuk alat berikut:

Gemini CLI
Gemini Code Assist
Claude Code
Claude desktop
Codex
Cline (ekstensi VS Code)
Cursor
Visual Studio Code (Copilot)
Windsurf (sebelumnya Codeium)

Alat MCP apa yang disediakan silsilah data?

Integrasi silsilah data memungkinkan agen AI membuat kueri dan menganalisis silsilah data, yang mewakili aliran data antara aset sumber (hulu) dan target (hilir). Integrasi ini mendukung silsilah tingkat entity (melacak aliran data antara seluruh aset seperti tabel dan file) dan silsilah tingkat kolom (melacak aliran data antara kolom atau kolom tertentu dalam aset).

Silsilah data menyediakan alat datalineage-search-lineage, yang mengambil respons streaming dari link silsilah yang terhubung ke aset yang diminta.

Untuk mengetahui informasi selengkapnya tentang sumber silsilah data dan alat yang tersedia, lihat dokumentasi Sumber Silsilah Data.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk terhubung ke silsilah data menggunakan MCP Toolbox, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengaktifkan API: Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin)
Untuk menggunakan kemampuan silsilah data: Pelihat Silsilah Data (roles/datalineage.viewer)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk terhubung ke silsilah data menggunakan MCP Toolbox. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk terhubung ke silsilah data menggunakan MCP Toolbox:

Untuk mengaktifkan API: serviceusage.services.enable
Untuk menggunakan kemampuan silsilah data:
- datalineage.lineage.searchLinks
- datalineage.processes.get
- datalineage.runs.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengaktifkan API yang diperlukan

Di Google Cloud konsol, buka halaman pemilih project.

Buka pemilih project
Pilih atau buat a Google Cloud project.
Peran yang diperlukan untuk memilih atau membuat project
- Memilih project: Memilih project tidak memerlukan peran IAM tertentu Anda dapat memilih project mana pun yang telah diberi peran.
- Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.
Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.
Pastikan penagihan diaktifkan untuk Google Cloud project Anda.
Aktifkan Data Lineage API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.
Mengaktifkan API

Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda:
```
gcloud auth application-default login
```
Anda tidak perlu melakukan hal ini jika menggunakan Cloud Shell.

Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Menginstal MCP Toolbox

Anda tidak perlu menginstal MCP Toolbox jika hanya berencana menggunakan Gemini Code Assist, karena MCP Toolbox menggabungkan kemampuan server yang diperlukan. Untuk IDE dan alat lainnya, ikuti langkah-langkah di bagian ini untuk menginstal MCP Toolbox.

Download versi terbaru MCP Toolbox sebagai biner. Pilih rilis biner MCP Toolbox yang sesuai dengan arsitektur (OS) dan CPU Anda. Anda harus menggunakan MCP Toolbox v0.31.0 atau yang lebih baru.
Linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
Ganti VERSION dengan versi MCP Toolbox—misalnya, v0.31.0.
macOS (Darwin)/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
Ganti VERSION dengan versi MCP Toolbox—misalnya, v0.31.0.
macOS (Darwin)/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
Ganti VERSION dengan versi MCP Toolbox—misalnya, v0.31.0.
Windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
Ganti VERSION dengan versi MCP Toolbox—misalnya, v0.31.0.
Jadikan biner sebagai file yang dapat dieksekusi:
```
chmod +x toolbox
```
Verifikasi penginstalannya:
```
./toolbox --version
```
Penginstalan yang berhasil akan menampilkan nomor versi, misalnya, 0.15.0.

Menyiapkan klien dan koneksi untuk silsilah data

Bagian ini menjelaskan cara menghubungkan silsilah data ke alat Anda.

Untuk menghubungkan IDE dan alat yang kompatibel dengan MCP ke silsilah data, Anda harus menginstal MCP Toolbox terlebih dahulu dan membuat file konfigurasi kustom untuk sumber dan alat silsilah Anda.

Di direktori root atau konfigurasi project Anda, buat file YAML bernama lineage-config.yaml dengan konfigurasi berikut:

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.

Tetapkan variabel lingkungan untuk Google Cloud project Anda:
```
export DATALINEAGE_PROJECT=PROJECT_ID
```
Ganti PROJECT_ID dengan the Google Cloud project ID.
Konfigurasi klien tertentu menggunakan tanda --config, bukan konfigurasi bawaan, seperti yang ditunjukkan di bagian berikut.

Gemini CLI

Anda dapat menggunakan silsilah data di Gemini CLI dengan mengonfigurasinya sebagai server MCP lokal menggunakan MCP Toolbox dan file lineage-config.yaml kustom Anda.

Di direktori kerja project Anda, buat folder bernama .gemini (atau buka direktori ~/.gemini global Anda).
Dalam direktori tersebut, buat atau buka file settings.json.

Tambahkan konfigurasi berikut:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Simpan konfigurasi.
Mulai Gemini CLI dalam mode interaktif:
```
gemini
```
Di Gemini CLI, gunakan /mcp perintah untuk memverifikasi bahwa server dataLineage terhubung.

Gemini Code Assist

Gemini Code Assist menggabungkan kemampuan server MCP yang diperlukan, sehingga Anda tidak perlu menginstal MCP Toolbox secara terpisah.

Di VS Code, instal ekstensi Gemini Code Assist.
Aktifkan Mode Agen di chat Gemini Code Assist.
Di direktori kerja Anda, buat folder bernama .gemini. Di dalamnya, buat file settings.json.

Tambahkan konfigurasi berikut:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Simpan konfigurasi.

Claude Code

Meskipun plugin resmi menyediakan alat untuk Knowledge Catalog, Anda dapat menggunakan silsilah data di Claude Code dengan mengonfigurasi server MCP Toolbox lokal dengan file konfigurasi kustom Anda.

Tetapkan variabel lingkungan untuk terhubung ke project silsilah data Anda:
```
export DATALINEAGE_PROJECT=PROJECT_ID
```
Ganti PROJECT_ID dengan the Google Cloud project ID.

Konfigurasi Claude Code untuk menggunakan server MCP Toolbox:

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

Mulai agen:
```
claude
```

Codex

Untuk menggunakan silsilah data di Codex, konfigurasi koneksi server MCP di konfigurasi Codex Anda untuk menjalankan MCP Toolbox dengan file lineage-config.yaml kustom Anda:

Tetapkan variabel lingkungan untuk terhubung ke project silsilah data Anda:
```
export DATALINEAGE_PROJECT="PROJECT_ID"
```
Ganti PROJECT_ID dengan the Google Cloud project ID.

Di konfigurasi Codex MCP Anda, tambahkan server menggunakan MCP Toolbox:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Claude desktop

Buka Claude Desktop, lalu buka Settings.
Untuk membuka file konfigurasi, di tab Developer , klik Edit config.

Tambahkan konfigurasi:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Simpan konfigurasi.
Mulai ulang Claude desktop. Layar chat baru menampilkan ikon MCP yang mewakili server MCP baru.

Cline

Di VS Code, buka ekstensi Cline , lalu klik ikon MCP Servers.
Untuk membuka file konfigurasi, ketuk Configure MCP Servers.

Tambahkan konfigurasi berikut:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Simpan konfigurasi. Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.

Cursor

Buat direktori .cursor di root project Anda jika belum ada.
Buat file .cursor/mcp.json jika belum ada, lalu buka.

Tambahkan konfigurasi berikut:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Simpan konfigurasi.
Buka Cursor, lalu buka Settings > Cursor Settings > MCP. Status aktif berwarna hijau akan muncul saat server terhubung.

VS Code (Copilot)

Buka VS Code dan buat direktori .vscode di root project Anda jika belum ada.
Buat file .vscode/mcp.json jika belum ada, lalu buka.

Tambahkan konfigurasi berikut:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Simpan konfigurasi.

Windsurf

Buka Windsurf, lalu buka asisten Cascade.
Untuk membuka file konfigurasi, klik ikon MCP, lalu klik Configure.

Tambahkan konfigurasi berikut:

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

Ganti PROJECT_ID dengan the Google Cloud project ID.

Simpan konfigurasi.

Menggunakan kemampuan

Asisten AI Anda kini terhubung ke silsilah data. Coba minta asisten AI Anda untuk melacak silsilah data hulu dan hilir di antara aset Anda.

Misalnya, Anda dapat meminta asisten AI Anda untuk:

Melacak asal data tabel BigQuery (silsilah hulu).
Menemukan tabel atau laporan hilir mana yang bergantung pada aset data tertentu (silsilah hilir).
Memeriksa silsilah tingkat kolom antara kolom tertentu di seluruh aset.

Opsional: Menambahkan petunjuk sistem

Petunjuk sistem adalah cara untuk memberikan panduan khusus kepada LLM, yang membantu LLM memahami konteks dan merespons dengan lebih akurat. Siapkan petunjuk sistem berdasarkan perintah sistem yang direkomendasikan Data Lineage.

Misalnya, Anda dapat menambahkan petunjuk untuk memandu LLM tentang cara menggunakan kemampuan silsilah data:

Saat diminta untuk melacak aliran data hulu atau hilir antara aset atau kolom, gunakan kemampuan search_lineage atau alat datalineage-search-lineage.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi petunjuk, lihat Menggunakan petunjuk untuk mendapatkan hasil edit AI yang mengikuti gaya coding Anda.

Langkah berikutnya

Tinjau perbedaan antara server MCP lokal dan jarak jauh.
Pelajari cara menggunakan server MCP Toolbox lokal untuk Knowledge Catalog.
Baca referensi alat MCP Data Lineage .
Pelajari lebih lanjut tentang silsilah data.
Telusuri resource di Knowledge Catalog.

Menggunakan asal-usul data dengan MCP, Gemini, dan agen lainnya Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Alat MCP apa yang disediakan silsilah data?

Peran yang diperlukan

Izin yang diperlukan

Mengaktifkan API yang diperlukan

Menginstal MCP Toolbox

Linux/amd64

macOS (Darwin)/arm64

macOS (Darwin)/amd64

Windows/amd64

Menyiapkan klien dan koneksi untuk silsilah data

Gemini CLI

Gemini Code Assist

Claude Code

Codex

Claude desktop

Cline

Cursor

VS Code (Copilot)

Windsurf

Menggunakan kemampuan

Opsional: Menambahkan petunjuk sistem

Langkah berikutnya

Menggunakan asal-usul data dengan MCP, Gemini, dan agen lainnya