Menggunakan Knowledge Catalog dengan MCP, CLI Antigravity, dan agen lainnya

Halaman ini menjelaskan cara menghubungkan instance Knowledge Catalog (sebelumnya bernama Dataplex Universal Catalog) ke alat developer seperti Antigravity CLI. Menghubungkan Knowledge Catalog ke alat ini memungkinkan penemuan data dan pengelolaan aset berbasis AI langsung di dalam alat Anda.

Untuk menghubungkan silsilah data ke alat developer menggunakan server MCP Toolbox lokal, lihat Menggunakan silsilah data dengan server MCP Toolbox lokal.

Untuk pengalaman command line yang terintegrasi, sebaiknya gunakan plugin Knowledge Catalog khusus untuk Antigravity CLI. Plugin ini menggabungkan kemampuan dasar langsung ke dalam plugin, sehingga menyederhanakan penyiapan dan konfigurasi.

Atau, Anda dapat menghubungkan IDE dan alat developer lain yang mendukung MCP menggunakan MCP Toolbox for Databases lokal. Kemudian, Anda dapat menggunakan agen AI di IDE yang ada untuk menemukan aset data di Knowledge Catalog. Untuk mengetahui informasi selengkapnya tentang MCP, lihat Pengantar Model Context Protocol.

Panduan ini menunjukkan proses koneksi untuk alat berikut:

Tentang Antigravity CLI dan plugin

Antigravity CLI adalah agen AI percakapan open source dari Google yang mempercepat alur kerja pengembangan dan membantu coding, proses debug, eksplorasi data, dan pembuatan konten. Layanan ini menawarkan pengalaman berbasis agen untuk berinteraksi dengan layanan Data Cloud, seperti Knowledge Catalog, dan database open source populer lainnya.

Untuk mengetahui informasi selengkapnya tentang Antigravity CLI, lihat dokumentasi Antigravity CLI.

Bagaimana cara kerja plugin Antigravity CLI?

Plugin memperluas kemampuan Antigravity CLI, sehingga dapat terhubung ke dan mengontrol layanan Google Cloud tertentu serta alat lainnya. Model ini memberikan pemahaman API dan konteks kepada Antigravity CLI, sehingga memungkinkan interaksi percakapan. Anda dapat memuat plugin Antigravity CLI dari URL GitHub, direktori lokal, atau registry. Plugin ini menawarkan kemampuan, perintah garis miring, dan perintah baru. Alat ini terpisah dari plugin IDE, seperti Antigravity Code Assist, yang terintegrasi menggunakan MCP Toolbox.

Alat MCP apa yang disediakan Knowledge Catalog?

Plugin Knowledge Catalog untuk Antigravity CLI mengintegrasikan AI ke dalam tugas tata kelola dan penemuan data Anda. Anda dapat berinteraksi dengan Knowledge Catalog menggunakan perintah bahasa alami di terminal.

Untuk mengetahui semua keterampilan yang tersedia, lihat keterampilan Knowledge Catalog di GitHub.

Untuk mengetahui informasi selengkapnya tentang plugin Knowledge Catalog, lihat Plugin Antigravity CLI - Knowledge Catalog.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk terhubung ke Knowledge Catalog menggunakan MCP Toolbox atau plugin Antigravity CLI, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:

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 Knowledge Catalog menggunakan MCP Toolbox atau plugin Antigravity CLI. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk terhubung ke Knowledge Catalog menggunakan MCP Toolbox atau plugin CLI Antigravity:

  • Untuk mengaktifkan API: serviceusage.services.enable
  • Untuk menggunakan keahlian Knowledge Catalog:
    • dataplex.projects.search
    • dataplex.entries.get
    • dataplex.aspectTypes.get
    • dataplex.aspectTypes.list

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

Mengaktifkan Dataplex API

  1. Di konsol Google Cloud , buka halaman pemilih project.

    Buka pemilih project

  2. Pilih atau buat project Google Cloud .

    Peran yang diperlukan untuk memilih atau membuat project

    • Memilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project apa pun yang perannya telah diberikan kepada Anda.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

  3. Pastikan penagihan diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan Dataplex 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 Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

    Mengaktifkan API

  5. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Anda tidak perlu melakukannya 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 Antigravity Code Assist atau plugin Antigravity CLI, karena keduanya menggabungkan kemampuan server yang diperlukan. Untuk IDE dan alat lainnya, ikuti langkah-langkah di bagian ini untuk menginstal MCP Toolbox.

  1. Download versi terbaru MCP Toolbox sebagai biner. Pilih rilis biner MCP Toolbox yang sesuai dengan (OS) dan arsitektur 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.

  2. Buat file biner yang dapat dieksekusi:

    chmod +x toolbox

  3. Verifikasi penginstalannya:

    ./toolbox --version

    Penginstalan yang berhasil akan menampilkan nomor versi, misalnya, 0.15.0.

Menyiapkan klien dan koneksi

Bagian ini menjelaskan cara menghubungkan Knowledge Catalog ke alat Anda.

Untuk menghubungkan alat dan IDE yang kompatibel dengan MCP, Anda harus menginstal MCP Toolbox terlebih dahulu. Toolbox ini berfungsi sebagai server Model Context Protocol (MCP) open source yang berada di antara IDE dan Knowledge Catalog, sehingga menyediakan bidang kontrol yang aman dan efisien untuk alat AI Anda. Setelah penginstalan, lihat bagian untuk alat spesifik Anda guna mengetahui petunjuk konfigurasi.

Plugin Antigravity CLI

Metode ini menggunakan plugin knowledge-catalog untuk alat Antigravity CLI mandiri, dan tidak menggunakan MCP Toolbox.

  1. Instal Antigravity CLI.

  2. Instal plugin Knowledge Catalog untuk Antigravity CLI dari repositori GitHub:

    agy plugin install https://github.com/gemini-cli-extensions/knowledge-catalog

  3. Tetapkan variabel lingkungan untuk terhubung ke project Knowledge Catalog Anda:

    export DATAPLEX_PROJECT=PROJECT_ID

    Ganti PROJECT_ID dengan project ID Google Cloud.

  4. Mulai Antigravity CLI dalam mode interaktif:

    agy

    CLI akan otomatis memuat plugin Knowledge Catalog dan kemampuannya, yang dapat Anda gunakan untuk berinteraksi dengan database.

  5. Di Antigravity CLI, gunakan perintah /mcp untuk memverifikasi bahwa plugin telah diinstal.

Antigravity Code Assist

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

  1. Di VS Code, instal ekstensi Antigravity Code Assist.
  2. Aktifkan Agent Mode di chat Antigravity Code Assist.
  3. Di direktori kerja Anda, buat folder bernama .antigravity. Dalam folder tersebut, buat file settings.json.

  4. Tambahkan konfigurasi berikut:

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

    Ganti PROJECT_ID dengan project ID Google Cloud.

  5. Simpan konfigurasi.

Claude Code

  1. Instal Claude Code.

  2. Tetapkan variabel lingkungan untuk terhubung ke project Knowledge Catalog Anda:

    export DATAPLEX_PROJECT=PROJECT_ID

    Ganti PROJECT_ID dengan project ID Google Cloud.

  3. Mulai agen:

    claude

  4. Instal plugin:

    /plugin install knowledge-catalog@claude-plugins-official

Codex

  1. Instal marketplace Plugin Data Cloud:

    codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins

  2. Instal plugin Knowledge Catalog:

    codex plugin install dataplex@data-cloud-plugins

  3. Konfigurasikan variabel lingkungan untuk terhubung ke project Knowledge Catalog Anda:

    export DATAPLEX_PROJECT=PROJECT_ID

    Ganti PROJECT_ID dengan project ID Google Cloud.

  4. Opsional. Perbarui marketplace:

    codex plugin marketplace upgrade data-cloud-plugins

Claude desktop

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

  3. Tambahkan konfigurasi berikut:

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

    Ganti PROJECT_ID dengan project ID Google Cloud.

  4. Simpan konfigurasi.

  5. Mulai ulang Claude desktop. Layar chat baru akan menampilkan ikon MCP yang mewakili server MCP baru.

Cline

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

  3. Tambahkan konfigurasi berikut:

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

    Ganti PROJECT_ID dengan project ID Google Cloud.

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

Kursor

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

  3. Tambahkan konfigurasi berikut:

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

    Ganti PROJECT_ID dengan project ID Google Cloud.

  4. Simpan konfigurasi.

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

VS Code (Copilot)

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

  3. Tambahkan konfigurasi berikut:

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

    Ganti PROJECT_ID dengan project ID Google Cloud.

  4. Simpan konfigurasi.

Windsurf

  1. Buka Windsurf dan buka Settings Cascade.
  2. Untuk membuka file konfigurasi, klik ikon MCP, lalu klik Configure.

  3. Tambahkan konfigurasi berikut:

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

    Ganti PROJECT_ID dengan project ID Google Cloud.

  4. Simpan konfigurasi.

Menggunakan keahlian

Asisten AI Anda kini terhubung ke Knowledge Catalog. Coba minta asisten AI Anda untuk menemukan beberapa aset data seperti set data BigQuery, instance Cloud SQL, dan lainnya.

Untuk semua keterampilan yang tersedia, lihat keterampilan Knowledge Catalog di GitHub.

Opsional: Menambahkan petunjuk sistem

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

Misalnya, Anda dapat menambahkan petunjuk untuk memandu LLM tentang cara menggunakan kemampuan Knowledge Catalog:

  • Saat diminta untuk menemukan set data atau tabel, gunakan keterampilan search_entries.
  • Jika diminta untuk memberikan detail skema atau metadata tabel seperti aturan kualitas data atau kepemilikan, gunakan keahlian lookup_entry.
  • Saat ditanya tentang aturan atau klasifikasi tata kelola, mulailah dengan menggunakan search_aspect_types untuk menemukan jenis aspek yang relevan.
  • Jika menjawab pertanyaan memerlukan kumpulan metadata yang luas, gunakan kemampuan lookup_context untuk mengambilnya.

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

Langkah berikutnya