Gemini Enterprise'da Antigravity ile Google Workspace MCP sunucuları

1. Giriş

Not: Geliştirici misiniz? Bu kılavuz, Gemini Enterprise yöneticileri içindir. Google Workspace MCP sunucularını Antigravity 2.0, IDE ve/veya CLI'nize nasıl bağlayacağınızı öğrenmek için Antigravity Codelab ile birlikte Google Workspace MCP sunucularımızı kullanın.

Bu codelab'i kullanan uygun müşteriler, Gemini Enterprise'ı kullanarak Antigravity'de Google Workspace Model Bağlam Protokolü (MCP) sunucularını nasıl yapılandıracaklarını, yöneteceklerini ve güvenliğini sağlayacaklarını öğrenecekler. MCP, yapay zeka ajanlarının uzaktaki arka uç hizmetleri tarafından kullanıma sunulan araçları güvenli bir şekilde sorgulamasına ve yürütmesine olanak tanıyan açık bir standarttır.

Karmaşık özellikler geliştirilirken mimari spesifikasyonlar, ürün şartları belgeleri (PRD'ler) ve işletme metrikleri Google Dokümanlar, E-Tablolar ve Drive'da yer alır. Tarayıcı sekmeleri arasında metin kopyalayıp yapıştırmak, eski bağlam oluşturur ve veri sızıntısı riskine yol açar. Gemini Enterprise'ı kullanarak Workspace MCP sunucularını bağladığınızda, geliştiricileriniz kurumsal düzeyde yönetim uygularken canlı bağlam bilgisi alabilir.

Antigravity Enterprise blog yayınında kurumsal yapay zeka geliştirici özellikleri hakkında daha fazla bilgi edinin.

Yapacaklarınız

• Gemini Enterprise'da Yapay zeka geliştirici araçlarını etkinleştirin ve merkezi MCP sunucusu izin verilenler listelerini yapılandırın.
• Google Cloud'da arka uç Google Workspace ve MCP API'lerini etkinleştirin.
• Kapsamlı OAuth 2.0 web uygulaması kimlik bilgilerini kuruluşunuzla sınırlı olacak şekilde yapılandırın.
• Onaylanan Workspace MCP hizmetlerini Antigravity'de kaydedin ve kimliklerini doğrulayın.
• İzin verilenler listesi engelleme, kullanıcı ACL eşliği ve denetim günlük kaydı dahil olmak üzere yönetimsel güvenlik sınırlarını doğrulayın.

İhtiyacınız olanlar

• Google Chrome gibi bir web tarayıcısı
• Faturalandırmanın etkin olduğu bir Google Cloud projesi ve Gemini Enterprise yönetici erişimi.
• Google Workspace Geliştirici Önizleme Programı'na kayıtlı Google Cloud projesi.
• İş istasyonunuzda Antigravity 2.0, IDE veya CLI yüklü olmalıdır. Ayrıntılı yükleme kılavuzunu Antigravity doküman sitesinde bulabilirsiniz.

2. Gemini Enterprise Yapay Zeka Geliştirici Araçları'nı etkinleştirme ve izin verilenler listelerini kullanma

Kurumsal güvenlik, merkezi yönetimle başlar. Bireysel geliştiricilerin MCP sunucularını yerel olarak kaydetmeden önce Workspace yöneticilerinin entegrasyonu yetkilendirmesi gerekir.

Google Cloud projesi oluşturma veya seçme

Google Cloud Console'da bir Google Cloud projesi seçin veya oluşturun.

Yapay zeka geliştirici araçlarını etkinleştirme

1. Google Cloud Console'u açın.
2. Gezinme menüsünde Gemini Enterprise > Ayarlar'a gidin.
3. Yapay zeka geliştirici araçları'nı seçin ve anahtarı Etkin konumuna getirin.

Bu ayar, yetkili ekip üyelerinin kurumsal Google Cloud hesaplarını kullanarak Antigravity oturumlarının kimliğini doğrulamasına olanak tanır.

MCP sunucusu izin verilenler listesini tanımlayın

Yöneticiler, yetkisiz üçüncü taraf aracı bağlantılarını önlemek için onaylanmış MCP sunucusu uç noktalarının açık bir izin verilenler listesini tanımlar.

1. Gemini Enterprise > Ayarlar > Yapay zeka geliştirici araçları'na gidin.
2. Güvenlik'in yanındaki Düzenle'yi tıklayın.
3. MCP Sunucuları ayarını bulun ve Etkin olarak değiştirin.
4. İzin verilen sunucu yapılandırması alanına, onaylanmış Google Workspace MCP sunucusu yapılandırmasını girin:

{
  "mcpServers": {
    "remote_servers": [
      {
        "id": "drive",
        "url": "https://drivemcp.googleapis.com/mcp/v1"
      },
      {
        "id": "docs",
        "url": "https://docsmcp.googleapis.com/mcp/v1"
      },
      {
        "id": "sheets",
        "url": "https://sheetsmcp.googleapis.com/mcp/v1"
      }
    ]
  }
}

5. Kaydet'i tıklayın.

Yönetim ve merkezi dağıtım: Bu izin verilenler listesi, kuruluşunuzun hangi Workspace API'lerinin aracı ortamlarına erişilebilir olduğu konusunda ayrıntılı kontrolü sürdürmesini sağlar. Yöneticiler, MDM, Google Cloud Workstation şablonları veya filo yapılandırma komut dosyaları aracılığıyla mühendislik makinelerine önceden doldurulmuş bir mcp_config.json dosyası dağıtarak istemci yapılandırmalarını merkezi olarak yönetebilir. Bu sayede geliştiriciler için manuel yapılandırma yükü ortadan kalkar. Daha fazla bilgi için AI Developer Tools Settings documentation (Yapay Zeka Geliştirici Araçları Ayarları dokümanı) başlıklı makaleyi inceleyin.

3. Arka uç API'lerini ve OAuth kimlik bilgilerini yapılandırma

Yönetici yönetimi etkinleştirilmişken istekleri yönlendirmek ve kullanıcı kimlik doğrulamasını işlemek için Google Cloud projenizi yapılandırın.

Yönetici Sorumluluğu: Yönetici olarak, projeniz veya kuruluşunuz için OAuth kullanıcı rızası ekranını ve istemci kimliğini bir kez yapılandırırsınız. Ardından, bu istemci kimliğini mühendislik ekiplerinizle paylaşırsınız. Böylece, Cloud Console yönetici ayrıcalıklarına ihtiyaç duymadan yerel Antigravity ortamlarını yapılandırabilirler.

Arka uç API'lerini ve MCP hizmetlerini etkinleştirme

Standart Google Workspace API'lerini ve bunlara karşılık gelen MCP arka uç hizmetlerini etkinleştirin.

1. Google Drive, Dokümanlar ve E-Tablolar API'lerini etkinleştirin:

Workspace API'lerini etkinleştirme

2. Google Drive, Dokümanlar ve E-Tablolar MCP hizmetlerini etkinleştirin:

MCP Hizmetlerini Etkinleştirme

OAuth kullanıcı rızası ekranını yapılandırma

1. Google Cloud Console'da Google Auth Platform > Branding'e (Markalama) (veya API'ler ve Hizmetler > OAuth kullanıcı rızası ekranı) gidin.
2. Uygulama Adı'nı WorkspaceMCPDemo olarak ayarlayın.
3. User support email (Kullanıcı desteği e-posta adresi) ve Developer contact information'ı (Geliştirici iletişim bilgileri) ayarlayın, ardından Save and Continue'ı (Kaydet ve Devam Et) tıklayın.

Kitleyi yapılandırma

1. Kitle bölümünde Dahili kullanıcı türünü seçin. Bu, kimlik doğrulama işlemini yalnızca kuruluşunuzdaki Google Workspace kullanıcılarıyla sınırlar.

OAuth 2.0 istemci kimlik bilgileri oluşturma

1. Google Auth Platform > Clients'a (İstemciler) (veya API'ler ve Hizmetler > Kimlik Bilgileri'ne) gidin.
2. İstemci Oluştur'u (veya Kimlik Bilgileri Oluştur > OAuth istemci kimliği) tıklayın.
3. Uygulama türü olarak Web uygulaması'nı seçin.
4. Ad'ı WorkspaceMCPDemoClient olarak ayarlayın.
5. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve şunları girin: https://antigravity.google/oauth-callback
6. Oluştur'u tıklayın ve istemci kimliğinizi ve istemci gizli anahtarınızı kaydedin.

4. Antigravity MCP Hizmetlerini Yapılandırma

Yönetici kurulumunuzu doğrulamak ve geliştiricileriniz için oryantasyon kılavuzu hazırlamak üzere Antigravity'de onaylı MCP hizmetlerini yapılandırın.

Geliştirici oryantasyonu ve merkezi yönetim seçenekleri: Aşağıdaki yapılandırma, mühendislik ekiplerinize dağıtacağınız (veya merkezi yapılandırma yönetimi aracılığıyla dağıtacağınız) yapılandırmadır. Geliştiricilerin, kuruluşunuzun OAuth kimlik bilgilerini yalnızca yerel mcp_config.json dosyalarına eklemeleri gerekir. Ayrıca, IDE ve CLI ile ilgili tüm kılavuzlar için Developer Codelab'i de paylaşabilirsiniz.

Onaylı MCP sunucularını kaydetme

Antigravity, ~/.gemini/config/mcp_config.json konumunda bulunan merkezi bir yapılandırma dosyası kullanır.

1. Tercih ettiğiniz metin düzenleyicide ~/.gemini/config/mcp_config.json dosyasını açın (veya Antigravity'de Ayarlar > Özelleştirmeler'e gidip Open MCP Config'i (MCP Yapılandırmasını Aç) tıklayın).
2. İzin verilenler listesindeki hizmetlerin (drive, docs, sheets) tanımlarını doldurun. <YOUR_CLIENT_ID> ve <YOUR_CLIENT_SECRET> yerine OAuth kimlik bilgilerinizi girin:

{
  "mcpServers": {
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

3. Dosyayı kaydedin.
4. Antigravity'de Ayarlar > Özelleştirmeler'e dönün ve Yenile'yi tıklayın. Google Drive, Dokümanlar ve E-Tablolar, etkin olarak yüklenmiş MCP sunucularınızın altında görünür.

5. Canlı Workspace Dokümanlarının Kimliğini Doğrulama ve Bunları Sorgulama

Temsilcinin araç çağrıları yapabilmesi için uçtan uca işlevselliği doğrulamak üzere kullanıcı oturumunuzu OAuth kimlik bilgilerinizle bağlayın.

OAuth el sıkışmasını tamamlama

1. Özelleştirmeler panelinde, her etkin hizmetin yanındaki Kimlik doğrula'yı tıklayın.
2. Tarayıcı tabanlı OAuth akışını kurumsal Google Workspace hesabınızla tamamlayın.
3. Kimlik doğrulama işlemi tamamlandıktan sonra her sunucu, kayıtlı araçlarını (ör. read_doc, get_spreadsheet ve search_files) gösterir.

Temellendirilmiş temsilci istemlerini çalıştırma

Temsilcinin, canlı Workspace dosyalarını doğrudan sohbet arayüzünden okuyup sentezleyebildiğini doğrulayın.

1. istem: Yapılandırılmış Google E-Tablosu verilerini ayıklama

Read the 'Pricing Catalog' Sheet in my Google Drive and list our three most expensive items along with their specifications.

Aracı, sheets.get_spreadsheet işlevini çağırır, tablo verilerini ayrıştırır ve tam rakamlarla en iyi öğeleri döndürür.

2. istem: Google Dokümanlar'daki mimari spesifikasyonları sentezleme

Read the 'PRD: Online Storefront' Google Doc in Drive. Summarize the architectural requirements and highlight any missing security considerations.

Aracı, docs.read_doc işlevini çağırır, en son düzeltmeyi alır ve özellikler, risk noktaları ve önerilerle ilgili uygulanabilir bir özet sunar.

6. Kurumsal güvenlik sınırlarını ve yönetimi doğrulama

Kurumsal dağıtımlar için doğrulanabilir güvenlik sınırları gerekir. Gemini Enterprise ve Antigravity'nin politika kısıtlamalarını nasıl uyguladığını test edin.

Test 1: Katı yönetim izin verilenler listesi zorunluluğu

Geliştiricilerin onaylanmamış MCP sunucularını bağlayamadığını doğrulayın.

1. ~/.gemini/config/mcp_config.json dosyasını açın ve onaylanmamış bir sunucu tanımı (ör. People API) ekleyin:

{
  "mcpServers": {
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

2. Antigravity Ayarlar > Özelleştirmeler bölümünde Yenile'yi tıklayın.
3. Yerçekimi karşıtı, bağlantıyı durdurur. Onaylanmamış sunucu Unauthorized / Blocked by Admin Policy durumunu gösterir ve başlatılamaz veya sorgulanamaz.
4. Onaylanmamış girişi mcp_config.json'dan kaldırıp Yenile'yi tekrar tıklayın.

2. test: Kullanıcı kimliği ve ACL eşliği

Workspace MCP entegrasyonu, standart erişim kontrol listelerini (EKL'ler) zorunlu kılar:

• Sıfır ayrıcalık yükseltme: Aracı, kimliği doğrulanmış kullanıcının OAuth erişim jetonu altında kesinlikle çalışır.
• Erişim Zorlama: Bir geliştiricinin belirli bir Google Dokümanı veya Drive klasörünü görüntüleme izni yoksa aracı bir HTTP 403 Forbidden hatası alır ve dosyayı inceleyemez.
• Denetleme Günlüğü: Aracı tarafından oluşturulan tüm API çağrıları, Google Cloud Denetleme Günlükleri'nde kimliği doğrulanmış kullanıcının kimliği altında kaydedilir.

7. Temizleme

Bu codelab'de oluşturulan kaynakları temizlemek için:

1. Google Cloud Console'da API'ler ve Hizmetler Kontrol Paneli'ne gidin.
2. Etkinleştirilmiş her bir MCP hizmetini (drivemcp.googleapis.com, docsmcp.googleapis.com, sheetsmcp.googleapis.com) seçin ve API'yi devre dışı bırak'ı tıklayın.
3. Google Auth Platform > Clients'ta (İstemciler) WorkspaceMCPDemoClient OAuth istemci kimlik bilgilerini silin.
4. Gemini Enterprise > Ayarlar > Yapay zeka geliştirici araçları'nda, artık gerekmiyorsa MCP sunucusu izin verilenler listelerini devre dışı bırakın.

8. Tebrikler

Tebrikler! Gemini Enterprise ile Antigravity'de Google Workspace MCP sunucuları için merkezi yönetimi, izin verilenler listelerini ve kapsamlı OAuth kimlik doğrulamasını başarıyla yapılandırdınız ve doğruladınız.

Kapsam dahilinde olanlar

• Gemini Enterprise'da Yapay zeka geliştirici araçlarını etkinleştirmiş ve MCP sunucusu izin verilenler listelerini tanımlamış olmanız gerekir.
• Google Cloud'da etkinleştirilmiş arka uç Google Workspace API'leri ve MCP hizmetleri.
• Kapsamlı dahili OAuth 2.0 web uygulaması kimlik bilgileri oluşturulur.
• Antigravity'de olumlu veri alımı ve olumsuz politika yaptırımı doğrulandı.
• Doğrulanmış en az ayrıcalık güvenlik sınırları ve denetim günlük kaydı.

Sonraki adımlar: Geliştiricilerinizle paylaşın

Kurumsal ortamınız yapılandırılıp güvenli hale getirildiğine göre, aşağıdaki yardımcı geliştirici kılavuzumuzu mühendislik ekiplerinizle paylaşın:

• Google Antigravity 2.0, IDE ve/veya CLI'deki Google Workspace MCP sunucuları

Referans belgeleri

• Gemini Enterprise'daki Yapay Zeka Geliştirici Araçları
• Google Workspace MCP sunucularını yapılandırma
• Antigravity Enterprise'a Genel Bakış
• Model Bağlam Protokolü (MCP) Özelliği