1. Başlamadan Önce
Çalışan bir Looker örneğine erişiminiz olmalıdır. Bir API client_id ve client_secret'e ihtiyacınız vardır.
Ön koşullar
- Çalışan bir Looker örneğiniz olmalıdır.
- Linux veya macOS komut satırına erişiminiz olmalıdır.
Neler öğreneceksiniz?
- Gemini KSA nasıl yüklenir?
- MCP Toolbox'ı yükleme
- MCP Toolbox'ı kullanarak Gemini CLI'ı Looker'a bağlama
Gerekenler
- Looker API sunucusunun URL'si. Bu URL genellikle Looker URL'siyle aynıdır ancak
:19999gibi bir bağlantı noktası numarası eklemeniz gerekebilir. Örneğin:https://looker.example.com:19999. İşler düzgün gitmiyorsa Looker yöneticinize danışın.
2. Hazırlıklar
client_id ve client_secret değerlerini almanız gerekir.
Looker örneğinize giriş yapın ve ekranın sağ üst köşesindeki kullanıcı profilini tıklayın. Hesap'ı seçin. Hesap ekranında, API Keys etiketinin yanındaki Manage düğmesine basın.
API Anahtarları yönetim sayfasında Create New API Key düğmesine basın.
Yeni oluşturulan girişte, amaç MCP Toolbox veya benzer bir ifade ekleyin ve kaydetmek için onay işaretini tıklayın. Ardından client_id ve client_secret değerlerini kopyalayıp güvenli bir yere yapıştırın. Gizli diziyi görmek ve kopyalamak için yanındaki göz simgesine basmanız gerekir.
Looker tarayıcı pencerelerini şimdi kapatabilirsiniz.
3. Gemini CLI'yı yükleme
macOS veya Linux komut satırına gitmek için terminal uygulamasını açın.
Aşağıdaki komutu çalıştırın:
npm install -g @google/gemini-cli
Bu işlem herhangi bir nedenle başarısız olursa yükleme seçenekleri veya yardım için https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation adresine bakın.
Şimdi Gemini CLI'yi şu komutla çalıştırın:
gemini
Giriş yapmanız istenir. Bu talimatları uyguladığınızda kullanmaya başlayabilirsiniz.
4. MCP Toolbox'ı yükleme
MCP Araç Kutusu dizini oluşturma
Terminal uygulamanızda mcp-toolbox dizinini oluşturun. Ardından bu dizine girin:
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
Sistem mimarisini belirleme
Ne tür bir sistem kullandığınızı öğrenmek için uname komutunu çalıştırın:
uname -a
Bu komut, aşağıdaki gibi bir dizeyle yanıt verir:
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
Bu satırın sonuna dikkat edin. Linux kullanıyorsanız dosya adı x86_64 GNU/Linux ile biter. macOS'te bu dize, Darwin ve dizenin sonuna yakın bir yerde Apple işlemci için arm64, Intel işlemci için x86_64 i386 ile gösterilir.
MCP Toolbox'ı indirin
Linux kullanıyorsanız MCP Toolbox'ı indirmek için aşağıdaki komutu çalıştırın:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
Apple işlemcili bir macOS kullanıyorsanız MCP Toolbox'ı indirmek için aşağıdaki komutu çalıştırın:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
Intel işlemcili bir macOS kullanıyorsanız MCP Toolbox'ı indirmek için aşağıdaki komutu çalıştırın:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
MCP Araç Kutusu'nu yürütülebilir hale getirme
Aşağıdaki komutu çalıştırarak MCP Toolbox programını yürütülebilir hale getirin:
chmod +x toolbox
Araç kutusunun tam yolunu alma
Aşağıdaki komutu çalıştırarak araç kutusu dosyasının tam yolunu alın:
echo $HOME/mcp-toolbox/toolbox
Büyük olasılıkla şöyle bir sonuç elde edersiniz:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
Sonucu uygun bir yere kaydedin.
5. Gemini KSA'yı yapılandırma
Dosyayı düzenleyin $HOME/.gemini/settings.json. Tercih ettiğiniz metin düzenleyiciyi kullanın. Linux veya macOS'te dosyaları çok sık düzenlemiyorsanız nano iyi bir seçenektir.
JSON dosyasına aşağıdaki kıtayı ekleyin:
"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"
}
}
}
FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID ve CLIENT_SECRET için önceki adımlarda kaydettiğiniz bilgileri girin. Düzenlenen dosyayı kaydedin.
6. MCP Toolbox'ı Gemini CLI ile kullanma
Komut satırına gemini girerek Gemini CLI'yı başlatın.
Gemini istemine aşağıdakileri yazarak kullanılabilir araçları listeleyin:
/mcp list looker
Sonucunuz aşağıdaki gibi görünmelidir:
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
Artık Gemini CLI'ya mevcut veriler hakkında soru sormaya başlayabilirsiniz. Aşağıdakilerden bazılarını deneyin:
- Looker'da hangi modeller kullanılabilir?
- MODEL_NAME'de hangi keşifler kullanılabilir?
- EXPLORE_NAME'de hangi ölçüler ve boyutlar kullanılabilir?
MODEL_NAME ve EXPLORE_NAME için kendi değerlerinizi girin.
Ardından, Looker örneğinizdeki verilerle yanıtlanabilecek bazı doğal dil sorguları oluşturmayı deneyin: "2025'teki toplam gelirim ne kadar?", "4. çeyrekte kaç widget sattım?" gibi sorular sorabilirsiniz.
7. Deneyebileceğiniz diğer istemler
Ayrıca, kaydedilmiş görünümleri ve kontrol panellerini çalıştırmayı, görünüm ve kontrol paneli oluşturmayı, hatta LookML modellerini düzenlemeyi de deneyebilirsiniz.
- "Aylık Envanter" Look'unu çalıştır gibi bir istem girerek kaydedilmiş bir Look'u çalıştırın. Gemini, "Aylık Envanter" adlı bir görünümü aramalı, ardından ilişkili sorguyu çalıştırmalı ve sonuçları paylaşmalıdır.
- "Müşteri izleme kontrol panelini özetle" gibi bir istem girerek kontrol paneli çalıştırın. Gemini, "Müşteri takibi" adlı bir kontrol panelini aramalı, her bir kutucukla ilişkili sorguları çalıştırmalı ve bir özet vermelidir.
- Kaydedilmiş bir görünüm oluşturmak için "Aylık gelirimi ürün kategorisine göre ayrılmış şekilde izlemek için bir görünüm oluştur" gibi bir istem deneyin. Verileri yığınlı sütun grafiği olarak göster."
- Kontrol paneli oluşturmak için "2026 yılı için satış nabzı kontrol paneli oluştur" gibi bir istem deneyin.
LookML geliştiricisiyseniz LookML'yi Gemini ile değiştirebilirsiniz. Aşağıdaki gibi istemlerle denemeler yapın:
- "Hangi LookML projeleri kullanılabilir?" istemini kullanarak Gemini'dan LookML projelerinin listesini alın.
- Gemini'dan proje dosyalarının listesini almasını isteyin. "PROJECT_NAME projesinde hangi dosyalar var?" Kendi proje adınızı kullanın.
- Gemini'dan bir ölçü eklemesini isteyin. "VIEW_NAME görünümündeki sales_price alanının ortalamasını alacak bir ölçü oluştur." Kendi görünüm adınızı kullanın.
- "Looker'da hangi bağlantılar kullanılabilir?" başlıklı makaleyi inceleyerek bağlantı listesini alın.
- İlişkili şemaları alın. "CONNECTION_NAME içinde hangi şemalar var?" Kendi bağlantı adınızı girin.
- İlişkili tabloları alın. "SCHEMA_NAME şemasındaki CONNECTION_NAME bağlantısında hangi tablolar var?" Kendi bağlantı ve şema adlarınızı kullanın.
- Tablonun sütunlarını alma. "TABLE_NAME tablosunda hangi sütunlar var?" Kendi tablo adınızı kullanın.
- Şimdi Gemini'dan bir LookML görünümüne sütun eklemesini isteyin. "COLUMN_NAME sütunu için bir boyut oluştur." Kendi sütun adınızı kullanın.
Değişiklikleri test etmek ve gerekirse uygulamak için Looker kullanıcı arayüzünü kullanın. Gemini ve MCP Araç Kutusu, LookML değişikliklerini kaydedip canlı sürüme aktaramaz.