Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan Looker dengan MCP, Gemini CLI, dan Agen lainnya

Halaman ini menunjukkan cara menghubungkan instance Looker Anda ke berbagai alat developer.

Untuk pengalaman yang paling efektif dan terintegrasi, sebaiknya gunakan ekstensi Looker khusus untuk Gemini CLI. Gunakan lapisan semantik Looker untuk memberi CLI Gemini akses yang aman, teratur, dan on-demand ke data tepercaya, serta mempercepat alur kerja dengan mengotomatiskan pembuatan laporan, visualisasi, dan dasbor dari perintah bahasa alami. Sebagai antarmuka command line generasi berikutnya Google Cloud, Gemini CLI adalah alat yang direkomendasikan untuk berinteraksi dengan instance Looker Anda dari command line.

Anda juga dapat menghubungkan lingkungan pengembangan terintegrasi (IDE) dan alat developer lain yang mendukung Model Context Protocol (MCP) dengan menggunakan MCP Toolbox untuk Database serbaguna. MCP Toolbox adalah server MCP open source yang menyederhanakan koneksi agen AI ke data Anda dengan menangani kompleksitas seperti autentikasi dan penggabungan koneksi, yang memungkinkan Anda berinteraksi dengan data menggunakan bahasa alami langsung dari IDE. Untuk alat ini, metode ini menyediakan kemampuan interaksi database inti.

Tentang Gemini CLI dan ekstensi

Gemini CLI adalah agen AI open source yang dirancang untuk mempercepat alur kerja pengembangan dengan membantu coding, proses debug, eksplorasi data, dan pembuatan konten. Misinya adalah memberikan pengalaman agentik yang elegan untuk berinteraksi dengan layanan cloud data dan database open source populer.

Cara kerja ekstensi

Gemini CLI sangat mudah diperluas, sehingga memungkinkan penambahan alat dan kemampuan baru melalui ekstensi. Ekstensi ini mudah diinstal. Anda dapat memuatnya dari URL GitHub, direktori lokal, atau registry yang dapat dikonfigurasi. Ekstensi ini menyediakan serangkaian kemampuan yang kaya, termasuk alat baru, perintah garis miring, dan perintah untuk menyederhanakan alur kerja Anda.

Menyiapkan Looker

Dapatkan ID Klien dan Rahasia Klien Looker. Ikuti petunjuk di halaman dokumentasi Autentikasi Looker API.
Siapkan URL dasar instance Looker Anda. Kemungkinan besar seperti https://looker.example.com. Dalam beberapa kasus, API mendengarkan di port yang berbeda, dan Anda harus menggunakan https://looker.example.com:19999.

Menginstal MCP Toolbox

Download MCP Toolbox versi terbaru sebagai program biner. Pilih biner yang sesuai dengan arsitektur OS dan CPU Anda. Anda harus menggunakan MCP Toolbox versi V0.14.0 atau yang lebih baru.

linux/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/windows/amd64/toolbox.exe

Jadikan biner sebagai file yang dapat dieksekusi.
```
chmod +x toolbox
```
Verifikasi penginstalannya.
```
./toolbox --version
```

Mengonfigurasi klien MCP

Bagian ini menjelaskan cara mengonfigurasi berbagai alat developer untuk terhubung ke instance Looker Anda menggunakan MCP Toolbox for Databases. Toolbox ini berfungsi sebagai server Model Context Protocol (MCP) open source yang berada di antara IDE dan database Anda, sehingga menyediakan bidang kontrol yang aman dan efisien untuk alat AI Anda. Pilih tab untuk alat spesifik Anda guna melihat petunjuk konfigurasi.

Gemini CLI
Gemini Code Assist
Kode Claude
Claude desktop
Cline (ekstensi VS Code)
Cursor
Visual Studio Code (Copilot)
Windsurf (Codium)

Gemini CLI

Instal Gemini CLI.
Instal ekstensi Looker untuk Gemini CLI dari repositori GitHub menggunakan perintah berikut:
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
Tetapkan variabel lingkungan untuk terhubung ke instance Looker Anda, dengan mengganti variabel lingkungan berikut dengan nilai Anda:
- LOOKER_URL: URL instance Looker Anda.
- CLIENT_ID dan CLIENT_SECRET: Kunci API yang digunakan untuk mengakses Looker API.
- VERIFY_SSL: true atau false, bergantung pada apakah Anda menggunakan enkripsi SSL untuk menghubungkan database ke instance Looker.
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
Mulai Gemini CLI dalam mode interaktif:
```
gemini
```
CLI akan otomatis memuat ekstensi Looker untuk ekstensi Gemini CLI dan alatnya, yang dapat Anda gunakan untuk berinteraksi dengan instance Looker Anda.

Gemini Code Assist

Sebaiknya konfigurasi Gemini Code Assist agar menggunakan Gemini CLI. Pendekatan ini menghilangkan kebutuhan untuk mengonfigurasi server MCP secara manual.

Pastikan Anda telah menginstal dan mengonfigurasi Gemini CLI dan ekstensi looker.
Konfigurasi Gemini Code Assist untuk menggunakan Gemini CLI.
Mulai berinteraksi dengan instance Looker Anda menggunakan bahasa alami langsung dalam chat Gemini Code Assist.

Kode Claude

Instal Claude Code.
Buat file .mcp.json di root project Anda, jika tidak ada.
Tambahkan konfigurasi berikut, ganti variabel lingkungan berikut dengan nilai Anda, lalu simpan.
- LOOKER_URL: URL instance Looker Anda.
- CLIENT_ID dan CLIENT_SECRET: Kunci API yang digunakan untuk mengakses Looker API.
- VERIFY_SSL: true atau false, bergantung pada apakah Anda menggunakan enkripsi SSL untuk menghubungkan database ke instance Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Claude desktop

Buka Claude Desktop, lalu buka Settings.
Di tab Developer, klik Edit Config untuk membuka file konfigurasi.
Tambahkan konfigurasi berikut, ganti variabel lingkungan berikut dengan nilai Anda, lalu simpan.
- LOOKER_URL: URL instance Looker Anda.
- CLIENT_ID dan CLIENT_SECRET: Kunci API yang digunakan untuk mengakses Looker API.
- VERIFY_SSL: true atau false, bergantung pada apakah Anda menggunakan enkripsi SSL untuk menghubungkan database ke instance Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Mulai ulang Claude Desktop.
Layar chat baru menampilkan ikon palu (MCP) dengan server MCP baru.

Cline

Buka ekstensi Cline di VS Code, lalu klik ikon MCP Servers.
Klik Configure MCP Servers untuk membuka file konfigurasi.
Tambahkan konfigurasi berikut, ganti variabel lingkungan berikut dengan nilai Anda, lalu simpan.
- LOOKER_URL: URL instance Looker Anda.
- CLIENT_ID dan CLIENT_SECRET: Kunci API yang digunakan untuk mengakses Looker API.
- VERIFY_SSL: true atau false, bergantung pada apakah Anda menggunakan enkripsi SSL untuk menghubungkan database ke instance Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

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, lalu buka.
Tambahkan konfigurasi berikut, ganti variabel lingkungan berikut dengan nilai Anda, lalu simpan.
- LOOKER_URL: URL instance Looker Anda.
- CLIENT_ID dan CLIENT_SECRET: Kunci API yang digunakan untuk mengakses Looker API.
- VERIFY_SSL: true atau false, bergantung pada apakah Anda menggunakan enkripsi SSL untuk menghubungkan database ke instance Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Buka Kursor, lalu buka Setelan > Setelan Kursor > MCP. Status aktif berwarna hijau akan muncul saat server terhubung.

Visual Studio Code (Copilot)

Buka VS Code dan buat direktori .vscode di root project Anda jika belum ada.
Buat file .vscode/mcp.json jika tidak ada, lalu buka.
Tambahkan konfigurasi berikut, ganti variabel lingkungan berikut dengan nilai Anda, lalu simpan.
- LOOKER_URL: URL instance Looker Anda.
- CLIENT_ID dan CLIENT_SECRET: Kunci API yang digunakan untuk mengakses Looker API.
- VERIFY_SSL: true atau false, bergantung pada apakah Anda menggunakan enkripsi SSL untuk menghubungkan database ke instance Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Windsurf

Buka Windsurf dan buka asisten Cascade.
Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.
Tambahkan konfigurasi berikut, ganti variabel lingkungan berikut dengan nilai Anda, lalu simpan.
- LOOKER_URL: URL instance Looker Anda.
- CLIENT_ID dan CLIENT_SECRET: Kunci API yang digunakan untuk mengakses Looker API.
- VERIFY_SSL: true atau false, bergantung pada apakah Anda menggunakan enkripsi SSL untuk menghubungkan database ke instance Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

Menggunakan alat AI

Alat AI Anda kini terhubung ke Looker menggunakan MCP. Coba minta asisten AI Anda untuk mencantumkan model, Eksplorasi, dimensi, dan ukuran. Anda juga dapat menjalankan kueri dengan mengambil SQL untuk kueri atau menjalankan Look tersimpan.

Alat berikut tersedia untuk LLM:

Alat Kueri dan Model Looker

Alat ini digunakan untuk mendapatkan informasi tentang model Looker dan menjalankan kueri terhadap model tersebut.

get_models: Mencantumkan semua model LookML di instance Looker Anda.
get_explores: Mencantumkan eksplorasi dalam model tertentu.
get_dimensions: Mencantumkan dimensi dalam Eksplorasi tertentu.
get_measures: Mencantumkan ukuran dalam Eksplorasi tertentu.
get_filters: Mencantumkan filter dalam Eksplorasi tertentu.
get_parameters: Mencantumkan parameter dalam Eksplorasi tertentu.
query: Menjalankan kueri dan menampilkan data.
query_sql: Menampilkan SQL yang dihasilkan oleh Looker untuk kueri.
query_url: Menampilkan link ke kueri di Looker untuk eksplorasi lebih lanjut.

Alat Konten Looker

Alat ini mendapatkan konten tersimpan (Tampilan dan Dasbor) dari instance Looker dan membuat konten tersimpan baru.

get_looks: Menampilkan Tampilan tersimpan yang cocok dengan judul atau deskripsi.
run_look: Menjalankan Look tersimpan dan menampilkan data.
make_look: Buat Look tersimpan di Looker dan tampilkan URL.
get_dashboards: Menampilkan dasbor tersimpan yang cocok dengan judul atau deskripsi.
make_dashboard: Buat dasbor tersimpan di Looker dan tampilkan URL-nya.
add_dashboard_element: Menambahkan kartu ke dasbor.

Alat Pemeriksaan Kondisi Instance Looker

Alat ini menawarkan algoritma health check yang sama dengan yang ditawarkan oleh CLI populer Henry.

health_pulse: Periksa kondisi instance Looker.
health_analyze: Menganalisis penggunaan objek Looker.
health_vacuum: Temukan elemen LookML yang mungkin tidak digunakan.

Alat Penulisan LookML

Alat ini memungkinkan pemanggil menulis dan mengubah file LookML serta mendapatkan skema database yang diperlukan untuk menulis LookML secara efektif.

dev_mode: Aktifkan dan nonaktifkan Mode Pengembangan untuk sesi. Penulisan LookML harus dilakukan dalam Mode Pengembangan. Kueri yang dijalankan dalam Mode Pengembangan menggunakan LookML yang dimodifikasi sehingga Anda dapat menguji dampak perubahan.
get_projects: Mendapatkan daftar project LookML yang tersedia.
get_project_files: Mendapatkan daftar file LookML dalam project.
get_project_file: Mendapatkan konten file LookML.
create_project_file: Buat file LookML baru.
update_project_file: Ubah file LookML yang ada.
delete_project_file: Menghapus file LookML.
get_connections: Mendapatkan daftar koneksi.
get_connection_schemas: Mendapatkan daftar skema untuk koneksi.
get_connection_databases: Mendapatkan daftar database untuk koneksi.
get_connection_tables: Mendapatkan daftar tabel untuk koneksi.
get_connection_table_columns: Mendapatkan daftar kolom untuk tabel dalam koneksi.