Gemini MCP ve Skills ile kodlama asistanınızı ayarlama

Yapay zeka kodlama asistanları güçlüdür ancak sınırlamaları vardır. Eğitim verileri belirli bir tarihte sona erer, yeni API özellikleri ve değişiklikleri eksiktir. Gemini'a özel belgelere erişim olmadığında, ajanlar optimize edilmiş yaklaşımlar yerine genel kalıplar önerebilir.

Kodlama asistanınızın, gelişen Gemini API ve önerilen kullanımıyla güncel kalması için Gemini Docs MCP'yi ayarlamanızı ve ortamınızı Gemini API becerileriyle geliştirmenizi öneririz. Bu araçlar bağımsız olarak kullanılabilir ancak eksiksiz bir kapsama alanı sağlamak için birlikte çalışacak şekilde tasarlanmıştır.

Gemini Dokümanları MCP'sini bağlama

Gemini, https://gemini-api-docs-mcp.dev adresinde herkese açık bir Model Bağlam Protokolü (MCP) sunucusu barındırır. Kodlama temsilcinizi bu sunucuya bağladığınızda tüm sorguların en yeni API'lere, kod güncellemelerine ve optimum yapılandırma örneklerine erişebilmesi sağlanır.

Sunucuyu yüklemek için aracınızın terminalinde veya proje kök dizininde aşağıdaki komutu çalıştırın:

npx add-mcp "https://gemini-api-docs-mcp.dev"

Bu sunucu, aracınızın resmi Gemini doküman dosyalarından gerçek zamanlı API tanımlarını ve entegrasyon kalıplarını almak için kullanabileceği bir search_documentation işlevi ekler.

API geliştirme becerileri ekleme

Beceriler, doğrudan asistanınızın bağlamında yerleşik kurallar ve en iyi uygulamalar (ör. doğru SDK ve mevcut model sürümlerini zorunlu kılma) sağlar. Bu beceri, Gemini Dokümanları MCP hizmetiyle birlikte çalışır: Her ikisi de yüklüyse beceri, dokümanlar için MCP hizmetini kullanır. Ancak MCP yüklü olmasa bile ai.google.dev'den /gemini-api/docs/llms.txt'ı yedek olarak getirir (burada, .md.txt eklenerek tek tek sayfalar da ham Markdown olarak getirilebilir, örneğin https://ai.google.dev/gemini-api/docs/speech-generation.md.txt).

Bu becerileri yüklemek için aşağıdaki desteklenen araçlardan birini kullanabilirsiniz. Her ikisi için de yükleme talimatları, her beceri modülünün altında verilmiştir:

  • skills.sh: Önerilir. Taşınabilir temsilci davranışları için açık standart.
  • Context7: Context7 ekosistemini kullanan kullanıcılar tarafından desteklenir.

gemini-api-dev

Gemini API (Interactions API) ile uygulama geliştirme becerisi. Etkileşimler API'si, Gemini modelleri ve aracılarıyla uygulama geliştirmenin en basit ve en iyi yoludur. Bu beceri şunları kapsar:

  • Metin oluşturma, çok aşamalı etkileşim ve yayın
  • İşlev çağrısı, yapılandırılmış çıkış ve görüntü üretme
  • Arka planda yürütme ve Deep Research temsilcileri
  • Sunucu tarafı sohbet durumu yönetimi
  • İstemleri mevcut modellere yönlendirme ve desteği sonlandırılan modellerden kaçınma
  • Python ve TypeScript SDK kalıpları

skills.sh ile yükleme

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

Context7 ile yükleme

npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev

gemini-live-api-dev

Gemini Live API ile anlık sohbet yapabilen yapay zeka uygulamaları oluşturma becerisi. Bu beceri, aşağıdakilerle ilgili dokümanlar ve en iyi uygulamalar sunar:

  • Düşük gecikmeli yayın için WebSocket bağlantıları
  • Ses, video ve metin akışı
  • Ses etkinliği algılama ve araya girme desteği

skills.sh ile yükleme

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

Context7 ile yükleme

npx ctx7 skills install /google-gemini/gemini-skills gemini-live-api-dev

Yüklemeyi doğrula

Yükleme işleminden sonra kodlama asistanınızın Gemini Docs MCP sunucusuna bağlanabildiğini ve yüklediğiniz becerileri kullanabildiğini doğrulayın.

1. Temsilci davranışını doğrulama

Doğrulamanın en güvenilir yolu, aracınıza Gemini API hakkında teknik bir soru sormaktır.

İstem: "Gemini API ile bağlam önbelleğini nasıl kullanırım?"

Başarılı bir kurulum:

  • Doğru kod sağlama: En yeni uç noktalardaki cacheContent veya cachedContents.create gibi belirli Gemini yöntemlerine referans verin.
  • MCP aracını kullanma: Gemini Dokümanları MCP sunucusuna bağlı olduğunu veya veri getirmek için search_documentation aracını kullandığını gösterin.
  • Yüklenen becerileri çağırma: "Beceriyi kullanıyor: gemini-api-dev" (ikincil bir sarmalayıcıya güveniyorsanız) göstergesini gösterin.

2. Manifestoları ve araçları doğrulama

Aracı genel bir yanıt veriyorsa Docs MCP'nin veya becerinin belleğe yüklendiğini doğrulamak için ortamınızla ilgili Discovery veya Status komutlarını kullanın.

Ortam MCP Doğrulaması Beceri Doğrulaması
Claude Code Etkin sunucuları ve search_documentation araçlarını görüntülemek için terminale /mcp yazın. Tüm etkin manifestleri listelemek için terminale /skills yazın.
İmleç Ayarlar > Özellikler > MCP'ye gidin. Sunucunun "Bağlı" olduğundan emin olun. Ayarlar > Kurallar'ı açın. Beceri, "Agent Decides" (Temsilci Karar Verir) bölümünde görünüyor mu?
Antigravity MCP durumunu öğrenmek için Özelleştirmeler > Bağlantılar kenar çubuğunu kontrol edin. /skills list yazın veya Özelleştirmeler > Kurallar kenar çubuğunu kontrol edin.
Gemini CLI gemini mcp list komutunu çalıştırın veya /mcp list kullanın. gemini skills list komutunu çalıştırın veya oturumda /skills eğik çizgi komutunu kullanın.
Copilot Etkin veri bağlayıcılarını listelemek için @gemini /mcp yazın. Etkin uzantıları görüntülemek için @gemini /skills (veya /skills) yazın.

Sorun giderme

Ajanınız yalnızca genel bilgiler veriyorsa veya Gemini'a özgü yöntemleri tanımıyorsa aşağıdakileri kontrol edin:

Ajan, beceriyi keşfetmedi

Çoğu temsilci, becerileri yalnızca başlangıçta dizine ekler.

Düzeltme: IDE'nizi (Cursor/VS Code) tamamen yeniden başlatın veya terminal tabanlı aracınızı (Claude Code) kapatıp yeniden açın.

Küresel ve yerel çatışmalar

--global işaretiyle yükleme yaptıysanız temsilciniz, projeye özel kurallar lehine bu işareti yoksayıyor olabilir.

Düzeltme: Beceriyi global işaret olmadan doğrudan proje kökünüze yüklemeyi deneyin:

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

Kaynaklar