Gemini Cloud Assist

Gemini Cloud Assist MCP sunucusu

[!ÖNEMLİ] Özel Önizleme Bildirimi Gemini Cloud Assist MCP sunucusu API'leri şu anda Özel Önizleme aşamasındadır ve bir izin listesinin arkasındadır. Erişim talep etmek için lütfen Google Cloud hesap ekibinizle iletişime geçin.

[!UYARI] Kullanımdan Kaldırma Bildirimi ve Uzak MCP Sunucusuna Geçiş

Gemini Cloud Assist MCP sunucusu, yerel bir Node.js mimarisinden Uzak MCP Sunucusu mimarisine geçmiştir. Eski yerel Node.js sunucusu önümüzdeki aylarda desteklenmeyecektir.

Yeni Uzak MCP Sunucularını kullanmak için lütfen v0.8.0 veya sonraki bir sürümü kullanın. Geçiş sürecinde eski yerel sunucuyu kullanmaya devam etmek istiyorsanız, yapılandırmanızı eski sürümlere sabitleyin.

Bu sunucu, Model Context Protocol (MCP) istemcilerini Gemini Cloud Assist API'lerine bağlar. Doğal dil kullanarak Google Cloud ortamınızı doğrudan yerel komut satırından anlamanıza, yönetmenize ve sorun gidermenize olanak tanır.

[!NOT] Google Cloud Platform Hizmet Şartları (https://cloud.google.com/terms/ adresinde mevcuttur) ve Veri İşleme ve Güvenlik Şartları (https://cloud.google.com/terms/data-processing-terms adresinde mevcuttur), Gemini Cloud Assist MCP Sunucusu yazılımının hiçbir bileşeni için geçerli değildir.

Gemini Cloud Assist hakkında daha fazla bilgi edinmek için Google Cloud dokümantasyonundaki Gemini Cloud Assist genel bakış bölümüne bakın.

✨ Temel özellikler

• Altyapı tasarlayın: Google Cloud için altyapı yapılandırmaları oluşturun ve mimarisini kurun.
• Sorunları giderin: Google Cloud ortamınızdaki karmaşık sorunların kök nedenini bulmak için derinlemesine araştırmalar yapın.
• Kaynakları yönetin: Sohbet iş akışınızdan doğrudan Google Cloud kaynakları oluşturun, güncelleyin ve silin (Agent Actions gerektirir).
• Maliyetleri optimize edin: Harcamalarınızı analiz edin, maliyetleri takip edin ve boşta kalan kaynaklar gibi verimlilik fırsatlarını belirleyin.
• Genel yardım alın: Google Cloud en iyi uygulamaları, mimarileri ve operasyonları hakkında sorular sorun ve rehberlik alın.

Hızlı başlangıç

Başlamadan önce aşağıdakilerin kurulu olduğundan emin olun:

• Google Cloud SDK kurulu ve yapılandırılmış.
• Bir Google Cloud projesi.
• Kullanıcı hesabınızda aşağıdaki IAM rolleri:
  • roles/serviceusage.serviceUsageAdmin: Cloud Assist API'lerini etkinleştirmek için gereklidir.
  • roles/geminicloudassist.user: Cloud Assist API'lerine istek göndermek için gereklidir.

Adım 1: Google Cloud'da kimlik doğrulama

Gemini Cloud Assist MCP sunucusu, Google Cloud'da güvenli bir şekilde kimlik doğrulamak için yerel Uygulama Varsayılan Kimlik Bilgilerini (ADC) kullanır. ADC'yi kurmak için aşağıdaki gcloud komutlarını çalıştırın:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

MCP istemcinizi yapılandırın

İstemci-ajan yapılandırması, kullandığınız ajana bağlıdır.

Antigravity

mcp_config.json dosyanıza aşağıdakileri ekleyin:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. Google Cloud projenizde bir masaüstü uygulaması için OAuth 2.0 istemci kimliği oluşturun.
2. URI://anysphere.cursor-mcp/oauth/callback değerini yönlendirme URL'si olarak yapılandırın.
3. Aşağıdaki yapılandırma bloğunu ekleyin veya birleştirin:

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

Belirli uygulamanız için yapılandırma talimatlarını izleyin:

• Claude.ai

MCP Araçları

Gemini Cloud Assist MCP araçları

Gemini Cloud Assist, bir dizi MCP aracı aracılığıyla erişilebilen bir ajandır. MCP araç çağrılarıyla çağrılan ajan, dahili olarak Google Cloud'a kendi araç çağrılarını yapar. Ajanların tüketmesi için aşağıdaki MCP araçları yayınlanmıştır:

Araç	Açıklama
ask_cloud_assist	Google Cloud yardımı ve Gemini Cloud Assist ajanı için birincil arayüz. Tüm işlevsellik bu araç üzerinden erişilebilir.
design_infra	Google Cloud'da altyapı tasarlama ve mimarisini kurma iş akışlarını destekler.
investigate_issue	Google Cloud'da sorun giderme iş akışlarını destekler. Bir Araştırma kaynağı aracılığıyla hızlı sorun giderme veya daha derin sorun giderme yapabilir.
invoke_operation	Google Cloud'da kaynak oluşturma, güncelleme ve silme iş akışlarını destekler. Yalnızca Agent Actions etkinleştirildiğinde çalışır.
optimize_costs	Google Cloud maliyetlerini analiz etme, takip etme ve optimize etme iş akışlarını destekler. Harcama dökümleri sağlar ve maliyet verimliliği fırsatlarını belirler.

Uygulama Tasarım Merkezi MCP araçları

Uygulama Tasarım Merkezi MCP araçları, genellikle GCA'nın design_infra aracı tarafından düzenlenir ve Uygulama Tasarım Merkezi'ni kullanarak altyapı uygulaması yaşam döngüsünü yönetir; şablon yönetimi, güvenlik uyumluluğu ve düzeltme ile dağıtım dahil.

Araç	Açıklama
setup_adc	Uygulama Tasarım Merkezi ortamını başlatır. Bu, diğer ADC araçları kullanılmadan önce yapılması gereken tek seferlik bir kurulum adımıdır.
manage_application	Bir uygulamanın dağıtım yaşam döngüsünü yönetir. Uygulama Tasarım Merkezi'ni kullanarak doğrulanmış bir tasarımı dağıtmak veya mevcut bir dağıtımın durumunu ve ayrıntılarını almak için bu aracı kullanın. Bu, tasarımınızı Google Cloud'da dağıtılmış bir altyapıya dönüştüren son adımdır.
manage_application_template	Altyapı tasarımınızın Altyapı Olarak Kod (IaC) içeriğini yönetir. Tasarımı bir Uygulama Tasarım Merkezi şablonu olarak kaydetmek, tasarımı Terraform dosyaları olarak dışa aktarmak veya tasarımı güncellemek (ör. bileşen, parametre yapılandırmaları vb.) için bunu kullanın.
assess_best_practices	Dağıtımdan önce uygulama tasarımınızda kapsamlı bir güvenlik ve yapılandırma denetimi gerçekleştirir. Tasarımı Security Command Center çerçevelerine ve ilgili kontrollere göre doğrular ve düzeltme için uygulanabilir bulgular içeren bir rapor döndürür.
list_application_templates	Mevcut tüm uygulama tasarımlarını listeler.

Not: Bu araçlar sabit API'ler olarak değerlendirilmemelidir. Parametreler, Gemini Cloud Assist'in gelişen yeteneklerini hesaba katmak için yeniden adlandırılabilir veya değiştirilebilir.

Ajan Becerileri

Gemini Cloud Assist MCP araçları, ajanınıza araçları nasıl doğru kullanacağı konusunda talimat vermek için SKILL.md dosyalarından yararlanır. Beceriler, ajanınızı birden fazla aracı bir iş akışında birleştirme, ilgili yerel bilgileri Gemini Cloud Assist'e iletme ve açık çağrıyı etkinleştirme konusunda yönlendirmeye yardımcı olur.

Beceri	Açıklama
designing-and-deploying-infrastructure	Ajanı, Uygulama Tasarım Merkezi (ADC) ve Gemini Cloud Assist araçlarını kullanarak bulut altyapısını nasıl tasarlayacağı, değerlendireceği, dağıtacağı ve sorunlarını nasıl gidereceği konusunda yönlendirir.
operating-google-cloud	Özel MCP araçları kullanarak Google Cloud Platform (GCP) kaynaklarını ve Kubernetes'i yönetmek için talimatlar sağlar.

Katkıda bulunma

• Bir hata ile karşılaşırsanız, lütfen GitHub Sorunları sayfamızda bir sorun bildirin.
• Bir çekme isteği göndermeden önce lütfen Katkıda Bulunma Rehberimizi inceleyin.

Lisans

Bu proje Apache 2.0 Lisansı altında lisanslanmıştır ve herhangi bir kullanım veya amaç için garanti veya temsil olmaksızın olduğu gibi sağlanır. Ayrıntılar için LİSANS dosyasına bakın.