Menggunakan MCP Toolbox for Databases

Catatan: Server MCP yang dikelola Looker adalah metode yang direkomendasikan untuk menghubungkan aplikasi AI ke instance Looker yang dihosting oleh Looker. Fitur ini menyediakan integrasi bawaan, aman, dan tanpa infrastruktur langsung di dalam platform Looker. Untuk mengetahui petunjuk penyiapan, lihat halaman dokumentasi Server MCP yang dikelola Looker.

Halaman ini menunjukkan cara menggunakan MCP Toolbox for Databases untuk menghubungkan instance Looker Anda ke lingkungan pengembangan terintegrasi (IDE) dan alat developer yang mendukung Model Context Protocol (MCP). MCP Toolbox adalah opsi yang bagus jika Anda menggunakan instance yang dihosting pelanggan, atau jika Anda lebih suka mengelola infrastruktur Anda sendiri. Jika tidak, sebaiknya gunakan server MCP yang dikelola Looker.

Sebaiknya gunakan ekstensi Looker khusus untuk Gemini CLI dengan MCP Toolbox. Gunakan lapisan semantik Looker untuk memberi Gemini CLI akses yang aman, diatur, dan sesuai permintaan ke data tepercaya, serta mempercepat alur kerja dengan mengotomatiskan pembuatan laporan, visualisasi, dan dasbor dari perintah bahasa alami. Sebagai antarmuka command line generasi berikutnya dari 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 lainnya yang mendukung Model Context Protocol (MCP) menggunakan MCP Toolbox for Databases untuk tujuan umum. MCP Toolbox adalah server MCP open source yang menyederhanakan koneksi agen AI ke data Anda dengan menangani kompleksitas seperti autentikasi dan penggabungan koneksi, sehingga Anda dapat berinteraksi dengan data menggunakan bahasa alami langsung dari IDE. Untuk alat ini, metode ini menyediakan kemampuan interaksi database inti.

Catatan: MCP Toolbox adalah project open source yang disediakan "apa adanya". Produk ini bukan produk yang didukung Google Cloud dan tidak tercakup dalam Google Cloud Panduan Layanan Dukungan Teknis atau SLA. Untuk mendapatkan dukungan, lihat halaman Masalah GitHub project.

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 agentic yang elegan untuk berinteraksi dengan layanan data cloud 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 beragam kemampuan, termasuk alat baru, perintah garis miring, dan perintah untuk menyederhanakan alur kerja Anda.

Menyiapkan autentikasi Looker

Anda memiliki dua opsi untuk mengautentikasi klien MCP dengan Looker: Anda dapat menggunakan kredensial API standar atau mengautentikasi klien melalui pendaftaran aplikasi OAuth.

Opsi 1: Kredensial API

1. Dapatkan Client ID dan Rahasia Klien Looker. Ikuti petunjuk di halaman dokumentasi Autentikasi Looker API.
2. Siapkan URL dasar instance Looker Anda. Kemungkinan besar, nama file tersebut adalah https://looker.example.com. Dalam beberapa kasus, API memproses di port yang berbeda, dan Anda harus menggunakan https://looker.example.com:19999.

Opsi 2: Pendaftaran aplikasi OAuth

1. Buka Looker API Explorer.

   API Explorer terinstal

   Jika instance Looker Anda sudah menginstal API Explorer, Anda dapat mengaksesnya dengan format URL ini:

   LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
   

   API Explorer tidak diinstal

   Jika instance Looker Anda tidak memiliki API Explorer, Anda dapat menginstalnya dari Looker Marketplace. Lihat halaman Menggunakan API Explorer untuk mengetahui informasi tentang cara menginstal API Explorer.

   Instance pribadi PSA

   Jika Anda menggunakan instance koneksi pribadi Looker (Google Cloud core) yang menggunakan akses layanan pribadi, Looker Marketplace dan API Explorer tidak didukung. Untuk mendaftarkan agen AI, Anda harus memanggil endpoint API oauth_client_apps secara langsung. Jika menggunakan metode ini, Anda dapat melewati langkah-langkah selanjutnya dalam prosedur API Explorer ini.

   Berikut adalah contoh perintah curl yang dapat Anda gunakan dengan endpoint oauth_client_apps untuk mendaftarkan agen.

   curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
   -H "Authorization: token ACCESS_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{
     "redirect_uri": "REDIRECT_URI",
     "display_name": "CLIENT_NAME",
     "description": "OAuth client to access MCP server using CLIENT_NAME",
     "enabled": true
   }'
   

2. Di bagian metode Auth, temukan endpoint API Register OAuth App. Anda juga dapat menelusuri "oauth app" di kolom Search.

3. Pilih Run It.

4. Untuk client_guid, masukkan string kustom (misalnya, gemini_cli atau claude-desktop).

5. Dalam isi permintaan, masukkan konfigurasi JSON berikut:

   {
     "redirect_uri": "AI_AGENT_REDIRECT_URI",
     "display_name": "APPLICATION_NAME",
     "description": "APPLICATION_DESCRIPTION",
     "enabled": true
   }
   

   Ganti kode berikut:

   • AI_AGENT_REDIRECT_URI: URI pengalihan untuk ekstensi agen AI atau aplikasi layanan bersama Anda.

     • Untuk aplikasi yang dihosting di Cloud, URL-nya mungkin terlihat seperti URL HTTPS yang aman: https://AI_AGENT_URL/oauth2callback

     • Untuk aplikasi yang berjalan secara lokal, URL-nya harus berupa URL localhost dengan port statis: http://localhost:7777/oauth/callback

       Catatan: Beberapa alat, seperti Gemini CLI, mungkin mengharuskan Anda menetapkan variabel lingkungan (misalnya, export OAUTH_CALLBACK_PORT=7777) untuk memastikan bahwa alat tersebut menggunakan port statis yang cocok dengan URI pengalihan terdaftar Anda.

     • Untuk IDE, tampilannya mungkin seperti berikut: vscode://google.vscode-looker-official/oauth_callback

   • APPLICATION_NAME: Nama tampilan untuk aplikasi OAuth Anda—misalnya, Claude Desktop.

   • APPLICATION_DESCRIPTION: Deskripsi singkat aplikasi OAuth Anda.

6. Centang kotak konfirmasi di samping I understand that this API endpoint will change data, lalu pilih Run.

Menginstal MCP Toolbox

Catatan: Jika Anda menggunakan Gemini CLI atau Gemini Code Assist untuk terhubung ke instance Looker menggunakan MCP Toolbox for Databases, Anda tidak perlu menginstal MCP Toolbox. MCP Toolbox akan diinstal saat ekstensi Gemini diinstal selama langkah konfigurasi.

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

   linux/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox
   
   

   darwin/arm64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox
   
   

   darwin/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox
   
   

   windows/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/windows/amd64/toolbox.exe
   
   

2. Jadikan biner sebagai file yang dapat dieksekusi.

   chmod +x toolbox
   

3. Verifikasi penginstalannya.

   ./toolbox --version
   

Menjalankan MCP Toolbox sebagai layanan bersama

Untuk klien MCP yang memerlukan autentikasi OAuth melalui HTTPS, Anda harus men-deploy MCP Toolbox di balik reverse proxy HTTPS (seperti Cloud Run). Reverse proxy menghentikan SSL dan meneruskan permintaan ke container MCP Toolbox.

Mengonfigurasi lingkungan server

1. Tetapkan variabel lingkungan berikut dalam deployment Anda:

   • LOOKER_BASE_URL=YOUR_LOOKER_BASE_URL
   • LOOKER_USE_CLIENT_OAUTH=true

2. Jalankan MCP Toolbox dengan argumen berikut:

   • --prebuilt=looker,looker-dev
   • --mcp-prm-file=prm.json
   • [--address=0.0.0.0]
   • [--port=8080]

   MCP Toolbox biasanya memproses port 5000 127.0.0.1. Jika reverse proxy berada di host lain, gunakan --address=0.0.0.0 untuk mengikat ke semua alamat IP. Gunakan setelan --port= jika Anda perlu menggunakan port pemantauan selain 5000. Misalnya, Cloud Run otomatis meneruskan traffic eksternal dari port 443, port HTTPS, ke 8080.

3. Buat file konfigurasi Metadata Resource yang Dilindungi (PRM) (prm.json) dengan struktur berikut:

   {
   "resource": "https://PROXY_URL/mcp",
   "authorization_servers": ["LOOKER_URL"],
   "scopes_supported": ["cors_api"]
   }
   

   Ganti kode berikut:

   • PROXY_URL: Domain dan jalur dasar server reverse proxy Anda.
   • LOOKER_URL: URL dasar instance Looker Anda.

Untuk mengetahui contoh cara mengonfigurasi klien saat Anda menjalankan MCP Toolbox sebagai layanan bersama, lihat contoh konfigurasi desktop Claude.

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 tertentu guna melihat petunjuk konfigurasi.

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

Gemini CLI

Pilih metode koneksi yang didasarkan pada pilihan autentikasi Anda:

Opsi 1: Kredensial API dengan ekstensi

1. Instal Gemini CLI.
2. Instal ekstensi Looker untuk Gemini CLI dari repositori GitHub menggunakan perintah berikut:

   gemini extensions install https://github.com/gemini-cli-extensions/looker
   

3. 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"
   

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

Opsi 2: Layanan bersama jarak jauh dengan OAuth

Untuk terhubung ke layanan bersama jarak jauh menggunakan OAuth, jangan instal ekstensi Looker. Sebagai gantinya, konfigurasikan Gemini CLI untuk terhubung langsung ke server MCP jarak jauh Anda.

1. Instal Gemini CLI.
2. Tambahkan server MCP jarak jauh menggunakan perintah berikut, dengan mengganti PROXY_URL dengan domain server reverse proxy Anda:

   gemini mcp add --transport http looker https://PROXY_URL/mcp
   

   Atau, Anda dapat mengonfigurasinya secara manual dengan menambahkan konfigurasi berikut ke file settings.json (terletak di ~/.gemini/settings.json atau direktori project Anda):

   {
     "mcpServers": {
       "looker": {
         "httpUrl": "https://PROXY_URL/mcp"
       }
     }
   }
   

3. Mulai Gemini CLI dalam mode interaktif:

   gemini
   

   Saat diminta untuk terhubung, CLI akan memulai alur otorisasi OAuth untuk melakukan autentikasi dengan aman ke instance Looker Anda.

Gemini Code Assist

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

1. Pastikan Anda telah menginstal dan mengonfigurasi Gemini CLI dan ekstensi looker (untuk kredensial API) atau konfigurasi server MCP jarak jauh (untuk layanan bersama dengan OAuth).
2. Konfigurasi Gemini Code Assist untuk menggunakan Gemini CLI.
3. Mulai berinteraksi dengan instance Looker Anda menggunakan bahasa alami langsung dalam chat Gemini Code Assist.

Claude Code

Pilih metode koneksi yang didasarkan pada pilihan autentikasi Anda:

Opsi 1: Kredensial API

1. Instal Claude Code.
2. Buat file .mcp.json di root project Anda, jika belum ada.
3. 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",
          }
          }
        }
      }
  

Opsi 2: Layanan bersama jarak jauh dengan OAuth

1. Instal Claude Code.
2. Buat file .mcp.json di root project Anda, jika belum ada.
3. Tambahkan konfigurasi berikut, ganti PROXY_URL dengan domain server reverse proxy Anda, lalu simpan.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

Claude desktop

Pilih metode koneksi yang didasarkan pada pilihan autentikasi Anda:

Opsi 1: Kredensial API

1. Buka Claude desktop, lalu buka Settings.
2. Di tab Developer, klik Edit Config untuk membuka file konfigurasi.
3. 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",
          }
          }
        }
      }
  

Opsi 2: Layanan bersama jarak jauh dengan OAuth

1. Di Claude desktop, buka Settings, lalu pilih Connectors.
2. Pilih Add custom connector dan masukkan nama (misalnya, Looker).
3. Untuk URL, masukkan endpoint server reverse proxy Anda dengan jalur /mcp yang ditambahkan (misalnya, https://looker-mcp-toolbox.example.com/mcp).
4. Di bagian Advanced settings, masukkan string yang sama persis dengan yang Anda gunakan untuk client_guid selama pendaftaran aplikasi OAuth. Kosongkan rahasia klien OAuth.
5. Pilih Tambahkan untuk menyimpan konektor. Saat diminta untuk terhubung, Claude desktop akan memulai alur otorisasi PKCE dengan aman melalui browser Anda.

4. Mulai ulang Claude desktop.

Cline

Pilih metode koneksi yang didasarkan pada pilihan autentikasi Anda:

Opsi 1: Kredensial API

1. Buka ekstensi Cline di VS Code, lalu klik ikon server MCP.
2. Klik Configure MCP Servers untuk membuka file konfigurasi.
3. 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.

Opsi 2: Layanan bersama jarak jauh dengan OAuth

1. Buka ekstensi Cline di VS Code, lalu klik ikon server MCP.
2. Klik Configure MCP Servers untuk membuka file konfigurasi.
3. Tambahkan konfigurasi berikut, ganti PROXY_URL dengan domain server reverse proxy Anda, lalu simpan.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.

Kursor

Pilih metode koneksi yang didasarkan pada pilihan autentikasi Anda:

Opsi 1: Kredensial API

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

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

Opsi 2: Layanan bersama jarak jauh dengan OAuth

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, ganti PROXY_URL dengan domain server reverse proxy Anda, lalu simpan.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

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

Visual Studio Code (Copilot)

Pilih metode koneksi yang didasarkan pada pilihan autentikasi Anda:

Opsi 1: Kredensial API

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

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

Opsi 2: Layanan bersama jarak jauh dengan OAuth

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, ganti PROXY_URL dengan domain server reverse proxy Anda, lalu simpan.

      {
        "servers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

Windsurf

Pilih metode koneksi yang didasarkan pada pilihan autentikasi Anda:

Opsi 1: Kredensial API

1. Buka Windsurf dan buka asisten Cascade.
2. Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.
3. 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",
          }
          }
        }
      }
  

Opsi 2: Layanan bersama jarak jauh dengan OAuth

1. Buka Windsurf dan buka asisten Cascade.
2. Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.
3. Tambahkan konfigurasi berikut, ganti PROXY_URL dengan domain server reverse proxy Anda, lalu simpan.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

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 yang disimpan.

Catatan: Kumpulan alat yang tersedia di server MCP yang dikelola Looker dapat berubah seiring pengoptimalan alat untuk performa dan keamanan.

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 di Eksplorasi tertentu.
• get_parameters: Mencantumkan parameter dalam Explore 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 (Look dan Dasbor) dari instance Looker dan membuat konten tersimpan baru.

• get_looksMenampilkan Look tersimpan yang cocok dengan judul atau deskripsi.
• run_look: Menjalankan Look yang disimpan dan menampilkan data.
• make_look: Membuat Look tersimpan di Looker dan menampilkan URL.
• get_dashboards: Menampilkan dasbor tersimpan yang cocok dengan judul atau deskripsi.
• make_dashboard: Membuat dasbor tersimpan di Looker dan menampilkan URL.
• add_dashboard_element: Menambahkan ubin ke dasbor.

Alat Kesehatan Instance Looker

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

• health_pulse: Memeriksa respons instance Looker.
• health_analyze: Menganalisis penggunaan objek Looker.
• health_vacuum: Menemukan 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: Mengaktifkan dan menonaktifkan Mode Pengembangan untuk sesi. Pembuatan LookML harus dilakukan dalam Mode Pengembangan. Kueri yang dijalankan dalam Mode Pengembangan menggunakan LookML yang telah diubah sehingga Anda dapat menguji dampak perubahan Anda.
• 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: Membuat file LookML baru.
• update_project_file: Mengubah file LookML yang ada.
• delete_project_file: Menghapus file LookML.
• get_connections: Dapatkan 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.

Catatan: Alat bawaan adalah versi pra-1.0, jadi perkirakan beberapa perubahan alat antar-versi. Karena LLM beradaptasi dengan alat yang tersedia, sebagian besar pengguna tidak akan terpengaruh.