Halaman ini diterjemahkan oleh Cloud Translation API.

Menghubungkan IDE Anda ke Looker menggunakan MCP Toolbox

Halaman ini menunjukkan cara menggunakan MCP Toolbox untuk database guna menghubungkan instance Looker Anda ke lingkungan pengembangan terintegrasi (IDE) dan alat developer yang mendukung Model Context Protocol (MCP). Gunakan alat ini untuk menjalankan kueri dan berinteraksi dengan Looker. Panduan ini ditujukan bagi developer yang menggunakan IDE dan alat developer yang ada untuk bekerja dengan Looker.

MCP adalah protokol terbuka untuk menghubungkan model bahasa besar (LLM) ke sumber data seperti Looker. Halaman ini menjelaskan cara menggunakan MCP Toolbox for Databases untuk mengekspos alat bantuan developer ke instance Looker menggunakan IDE berikut:

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

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 Toolbox MCP

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

linux/amd64

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

darwin/arm64

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

darwin/amd64

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

windows/amd64

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

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

Mengonfigurasi klien MCP

Gemini CLI

Instal Gemini CLI.
Di direktori kerja Anda, buat folder bernama .gemini. Di dalam folder tersebut, buat file settings.json.
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 Anda.

{
  "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",
     }
    }
  }
}

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 Anda.

{
  "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 Anda.

{
  "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 Anda.

{
  "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 Anda.

{
  "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 Anda.

{
  "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",
     }
    }
  }
}

Selancar Angin

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 Anda.

{
  "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:

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 dibuat oleh Looker untuk kueri.
query_url: Menampilkan link ke kueri di Looker untuk eksplorasi lebih lanjut.
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.
add_dashboard_element: Menambahkan kartu ke dasbor.