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 dengan 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 oleh silsilah data?

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

Silsilah data menyediakan alat datalineage-search-lineage, yang mengambil respons streaming 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: Service Usage Admin (roles/serviceusage.serviceUsageAdmin)
Untuk menggunakan kemampuan silsilah data: Data Lineage Viewer (roles/datalineage.viewer)

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

Peran bawaan 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 konsol Google Cloud , buka halaman pemilih project.

Buka pemilih project
Pilih atau buat Google Cloud project.
Peran yang diperlukan untuk memilih atau membuat project
- Pilih 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 Anda 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.
Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.
Aktifkan Data Lineage API, jika belum diaktifkan.
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 langkah ini jika menggunakan Cloud Shell.

Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa 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 alat ini 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 program biner. Pilih rilis biner MCP Toolbox yang sesuai dengan arsitektur CPU dan OS 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.
Buat agar biner 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 ID project Google Cloud .
Konfigurasi klien spesifik Anda menggunakan tanda --config, bukan konfigurasi bawaan, seperti yang ditunjukkan di bagian berikut.

Gemini CLI

Anda dapat menggunakan asal 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).
Di 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 ID project Google Cloud .

Simpan konfigurasi.
Mulai Gemini CLI dalam mode interaktif:
```
gemini
```
Di Gemini CLI, gunakan perintah /mcp 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 percakapan 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 ID project Google Cloud .

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 menggunakan file konfigurasi kustom.

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

Mengonfigurasi Claude Code agar 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 ID project Google Cloud .

Dalam konfigurasi Codex MCP, 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 ID project Google Cloud .

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 ID project Google Cloud .

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 ID project Google Cloud .

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

Kursor

Buat direktori .cursor di root project Anda jika belum ada.
Buat file .cursor/mcp.json jika tidak ada dan buka file tersebut.

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 ID project Google Cloud .

Simpan konfigurasi.
Buka Kursor, lalu buka Setelan > Setelan Kursor > 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 tidak ada, dan buka file tersebut.

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 ID project Google Cloud .

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 ID project Google Cloud .

Simpan konfigurasi.

Menggunakan keahlian

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 yang bergantung pada aset data tertentu (silsilah hilir).
Periksa silsilah tingkat kolom antara kolom tertentu di seluruh aset.

Opsional: Menambahkan petunjuk sistem

Petunjuk sistem adalah cara untuk memberikan pedoman khusus kepada LLM, sehingga membantunya memahami konteks dan merespons dengan lebih akurat. Siapkan petunjuk sistem berdasarkan Perintah sistem yang direkomendasikan untuk Silsilah Data.

Misalnya, Anda dapat menambahkan petunjuk untuk memandu LLM tentang cara menggunakan keterampilan asal data:

Saat diminta untuk melacak aliran data hulu atau hilir antar-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 Silsilah Data.
Pelajari silsilah data lebih lanjut.
Menelusuri 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 oleh 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

Kursor

VS Code (Copilot)

Windsurf

Menggunakan keahlian

Opsional: Menambahkan petunjuk sistem

Langkah berikutnya

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