Menghubungkan Gemini CLI ke Looker dengan MCP Toolbox

1. Sebelum Memulai

Anda harus memiliki akses ke instance Looker yang sedang berjalan. Anda akan memerlukan client_id dan client_secret API.

Prasyarat

  • Memiliki instance Looker yang sedang berjalan
  • Memiliki akses ke command line Linux atau macOS

Yang akan Anda pelajari

  • Cara menginstal Gemini CLI
  • Cara menginstal MCP Toolbox
  • Cara menghubungkan Gemini CLI ke Looker menggunakan MCP Toolbox

Yang Anda butuhkan

  • URL server Looker API. Biasanya sama dengan URL Looker, tetapi Anda mungkin harus menambahkan nomor port seperti :19999, misalnya: https://looker.example.com:19999. Jika ada yang tidak berfungsi dengan baik, coba tanyakan kepada administrator Looker Anda.

2. Persiapan

Anda perlu mengambil client_id dan client_secret.

Login ke instance Looker Anda dan klik profil pengguna di sudut kanan atas layar. Pilih Akun. Di layar Akun, di samping label API Keys, tekan tombol Manage.

Di halaman pengelolaan Kunci API, tekan tombol Create New API Key.

Di entri yang baru dibuat, tambahkan tujuan MCP Toolbox atau sesuatu yang serupa, lalu klik tanda centang untuk menyimpannya. Kemudian, salin dan tempel client_id dan client_secret ke tempat yang aman. Anda harus menekan ikon mata di samping secret untuk melihat dan menyalinnya.

Anda dapat menutup jendela browser Looker sekarang.

3. Menginstal Gemini CLI

Buka aplikasi terminal untuk membuka command line macOS atau Linux.

Jalankan perintah berikut:

npm install -g @google/gemini-cli

Jika gagal karena alasan apa pun, lihat https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation untuk mengetahui opsi penginstalan atau bantuan.

Sekarang jalankan Gemini CLI dengan perintah ini:

gemini

Anda akan diminta untuk login. Ikuti petunjuk tersebut dan Anda akan siap berangkat.

4. Menginstal MCP Toolbox

Buat direktori MCP Toolbox

Di aplikasi terminal, buat direktori mcp-toolbox. Kemudian, buka direktori tersebut:

mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox

Mengidentifikasi arsitektur sistem

Jalankan perintah uname untuk mengetahui jenis sistem yang Anda gunakan:

uname -a

Perintah ini akan menampilkan string yang terlihat seperti ini:

Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux

Perhatikan baik-baik akhir baris tersebut. Jika Anda menggunakan Linux, URL akan berakhir dengan x86_64 GNU/Linux. Untuk macOS, Darwin dan arm64 untuk prosesor Apple atau x86_64 i386 untuk prosesor Intel akan ditampilkan di dekat akhir string tersebut.

Download MCP Toolbox

Jika Anda memiliki Linux, jalankan perintah berikut untuk mendownload MCP Toolbox:

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

Jika Anda memiliki macOS dengan prosesor Apple, jalankan perintah berikut untuk Mendownload MCP Toolbox:

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

Jika Anda memiliki macOS dengan prosesor Intel, jalankan perintah berikut untuk Mendownload MCP Toolbox:

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

Jadikan MCP Toolbox dapat dieksekusi

Buat program MCP Toolbox dapat dieksekusi dengan menjalankan perintah berikut:

chmod +x toolbox

Dapatkan jalur lengkap ke toolbox

Dapatkan jalur lengkap ke file toolbox dengan menjalankan perintah berikut:

echo $HOME/mcp-toolbox/toolbox

Hasilnya mungkin akan seperti ini:

/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox

Simpan hasilnya di tempat yang mudah dijangkau.

5. Mengonfigurasi Gemini CLI

Edit file $HOME/.gemini/settings.json. Gunakan editor teks pilihan Anda. Jika Anda tidak terlalu sering mengedit file di Linux atau macOS, nano adalah pilihan yang baik.

Tambahkan stanza berikut ke file json:

  "mcpServers": {
    "looker": {
      "command": "FULL_PATH_TO_TOOLBOX",
      "args": [
        "--stdio",
        "--prebuilt",
        "looker"
      ],
      "env": {
        "LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
        "LOOKER_CLIENT_ID": "CLIENT_ID",
        "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
        "LOOKER_VERIFY_SSL": "true"
      }
    }
  }

Ganti informasi yang Anda simpan di langkah-langkah sebelumnya untuk FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID, dan CLIENT_SECRET. Simpan file yang diedit.

6. Menggunakan MCP Toolbox dengan Gemini CLI

Mulai Gemini CLI dengan memasukkan gemini di command line.

Buat daftar alat yang tersedia dengan mengetik perintah berikut di Gemini:

/mcp list looker

Hasil Anda akan terlihat seperti ini:

Configured MCP servers:

🟢 looker - Ready (33 tools)
  Tools:
  - add_dashboard_element
  - add_dashboard_filter
  - create_project_file
  - delete_project_file
  - dev_mode
  - generate_embed_url
  - get_connection_databases
  - get_connection_schemas
  - get_connection_table_columns
  - get_connection_tables
  - get_connections
  - get_dashboards
  - get_dimensions
  - get_explores
  - get_filters
  - get_looks
  - get_measures
  - get_models
  - get_parameters
  - get_project_file
  - get_project_files
  - get_projects
  - health_analyze
  - health_pulse
  - health_vacuum
  - make_dashboard
  - make_look
  - query
  - query_sql
  - query_url
  - run_dashboard
  - run_look
  - update_project_file

Sekarang, mulai ajukan pertanyaan kepada Gemini CLI tentang data yang tersedia. Cobalah beberapa cara berikut:

  1. Model apa yang tersedia di Looker?
  2. Eksplorasi apa yang tersedia di MODEL_NAME?
  3. Ukuran dan dimensi apa yang tersedia di EXPLORE_NAME?

Ganti nilai Anda sendiri untuk MODEL_NAME dan EXPLORE_NAME.

Selanjutnya, coba buat beberapa kueri bahasa alami yang dapat dijawab oleh data di instance Looker Anda: "Berapa total pendapatan saya untuk tahun 2025?", "Berapa banyak widget yang saya jual pada Kuartal 4?", dll.

7. Perintah lain yang dapat Anda coba

Anda juga dapat mencoba menjalankan Look dan dasbor tersimpan, membuat Look dan dasbor, bahkan mengedit model LookML.

  • Jalankan Look yang disimpan dengan memasukkan perintah seperti "Jalankan Look 'Inventaris Bulanan'". Gemini harus menelusuri tampilan bernama 'Inventaris Bulanan', lalu menjalankan kueri terkait dan membagikan hasilnya.
  • Jalankan dasbor dengan memberikan perintah seperti "Ringkas dasbor 'pelacakan pelanggan'". Gemini harus menelusuri dasbor bernama 'customer tracking', menjalankan kueri yang terkait dengan setiap kartu, dan memberikan ringkasan.
  • Untuk membuat tampilan tersimpan, coba perintah seperti "Buat Tampilan untuk melacak pendapatan bulanan saya yang dikelompokkan menurut kategori produk. Tampilkan data sebagai diagram kolom bertumpuk."
  • Untuk membuat dasbor, coba perintah seperti "Buatkan dasbor tren penjualan untuk tahun 2026".

Jika Anda adalah developer LookML, Anda dapat mengubah LookML dengan Gemini. Bereksperimenlah dengan perintah seperti ini:

  1. Minta Gemini untuk mendapatkan daftar project LookML dengan "Project LookML apa yang tersedia?"
  2. Minta Gemini untuk mengambil file project daftar. "File apa saja yang tersedia di project PROJECT_NAME?" Ganti dengan nama project Anda sendiri.
  3. Perintahkan Gemini untuk menambahkan ukuran. "Buat ukuran untuk menghitung rata-rata kolom sales_price dalam tampilan VIEW_NAME." Ganti nama tampilan Anda sendiri.
  4. Ambil daftar koneksi dengan "Koneksi apa yang tersedia di Looker?"
  5. Mendapatkan skema terkait. "Skema apa yang ada di CONNECTION_NAME?" Ganti dengan nama koneksi Anda sendiri.
  6. Mendapatkan tabel terkait. "What tables are in CONNECTION_NAME dalam skema SCHEMA_NAME?) Ganti nama koneksi dan skema Anda sendiri.
  7. Mendapatkan kolom untuk tabel. "Kolom apa saja yang ada di TABLE_NAME?" Ganti dengan nama tabel Anda sendiri.
  8. Sekarang, minta Gemini untuk menambahkan kolom ke tampilan LookML. "Buat dimensi untuk kolom COLUMN_NAME." Ganti dengan nama kolom Anda sendiri.

Gunakan UI Looker untuk menguji perubahan dan berpotensi melakukan commit. Gemini dan MCP Toolbox tidak dapat melakukan commit perubahan LookML dan menerapkannya ke produksi.

8. Informasi tambahan