Yapay zeka kodlama asistanları güçlüdür ancak sınırlamaları vardır. Eğitim verileri belirli bir tarihte kesilir, yeni API özellikleri ve değişiklikleri eksiktir. Gemini'a özel belgelere erişim olmadığında, aracıların optimize edilmiş yaklaşımlar yerine genel kalıplar önermesi mümkündür.
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 Becerileri ile geliştirmenizi öneririz. Bu araçlar bağımsız olarak kullanılabilir ancak eksiksiz kapsam sağlamak için birlikte çalışacak şekilde tasarlanmıştır.
Gemini Dokümanları MCP'sini bağlama
Gemini, gemini-api-docs-mcp.dev adresinde herkese açık bir Model Context Protocol (MCP) sunucusu barındırır. Kodlama aracınızı 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 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 ikisini de yüklediyseniz beceri, dokümanlar için MCP hizmetini kullanır. Ancak MCP yüklenmemiş olsa bile llms.txt, yedek olarak ai.google.dev'den alınır.
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
Genel amaçlı Gemini geliştirme için temel beceri. Bu beceri, aşağıdakilerle ilgili dokümanlar ve en iyi uygulamalar sunar:
- İstemleri mevcut modellere (ör. Gemini 3.1 Pro/Flash) yönlendirme ve desteği sonlandırılan modellerden kaçınma
- Çok formatlı istem yazma, işlev çağrısı, yapılandırılmış çıkışlar ve yaygın entegrasyon kalıpları
Install with skills.sh
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 gerçek zamanlı etkileşimli yapay zeka uygulamaları oluşturma becerisi. Bu beceri, aşağıdakilerle ilgili dokümanlar ve en iyi uygulamalar sunar:
- Düşük gecikmeli akış için WebSocket bağlantıları
- Ses, video ve metin akışı
- Konuşma etkinliği algılama ve araya girme desteği
Install with skills.sh
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
gemini-interactions-api
Etkileşimler API'si ile uygulama oluşturma becerisi. Etkileşimler API'si, Gemini modelleri ve aracılarıyla etkileşim kurmak için kullanılan birleşik bir arayüzdür ve aracı uygulamaları için tasarlanmıştır. Bu beceriyle ilgili konular:
- Metin oluşturma, çok adımlı sohbet ve yayın
- İşlev çağırma, 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
- Python ve TypeScript SDK kalıpları
Install with skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
Context7 ile yükleme
npx ctx7 skills install /google-gemini/gemini-skills gemini-interactions-api
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 onaylayı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
cacheContentveyacachedContents.creategibi 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_documentationaracı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. Bildirimleri 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ğrulama |
|---|---|---|
| Claude Code | Etkin sunucuları ve search_documentation araçlarını görüntülemek için terminale /mcp yazın. |
Etkin olan tüm 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, "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
Aracınız yalnızca genel bilgiler veriyorsa veya Gemini'a özgü yöntemleri tanımıyorsa aşağıdakileri kontrol edin:
Aracı, 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şaretini kullanarak yükleme yaptıysanız aracınız, projeye özel kurallar lehine bu işareti yoksayıyor olabilir.
Düzeltme: Global işaret olmadan beceriyi doğrudan proje kökünüze yüklemeyi deneyin:
npx skills add google-gemini/gemini-skills --skill gemini-api-dev