Google Antigravity 2.0, IDE ve/veya KSA'da Google Workspace MCP sunucuları

1. Giriş

Not: Gemini CLI'ı kullanmaya devam ediyor musunuz? Bu kılavuzda Antigravity CLI ele alınmaktadır. Geçişle ilgili daha fazla bilgiyi bu resmi Antigravity CLI blog yayınında bulabilirsiniz.

Gemini Enterprise'ı mı kullanıyorsunuz? Kuruluşunuz Gemini Enterprise kullanıyorsa uygun müşterilerin yöneticileri, onaylı MCP sunucularını merkezi olarak yönetebilir ve izin verilenler listesine ekleyebilir. Daha fazla bilgi için Antigravity Enterprise blog yayınını ve Gemini Enterprise Codelab'de Antigravity ile Google Workspace MCP sunucuları başlıklı makaleyi inceleyin.

Bu codelab'de, Google Workspace verilerinizi Antigravity 2.0, IDE ve/veya KSA'ya bağlamak için Model Context Protocol'ü (MCP) nasıl kullanacağınızı öğreneceksiniz. MCP, yapay zeka modellerinin uzak sunucular tarafından sağlanan araçları güvenli bir şekilde kullanmasını sağlayan açık bir standarttır. Kod yazmadan Gmail, Google Drive, Google Dokümanlar, Google E-Tablolar, Google Slaytlar, Google Takvim, Google Chat ve People API ile etkileşim kurmak için Antigravity'yi ayarlayacaksınız.

Yapacaklarınız

• Google Cloud projenizde Google Workspace MCP hizmetlerini etkinleştirin.
• Bu MCP hizmetlerine erişmek için Antigravity'yi yapılandırın.
• Google Workspace verilerinizle etkileşim kuran eğlenceli ve faydalı istemlerle entegrasyonu test edin.

İhtiyacınız olanlar

• Chrome gibi bir web tarayıcısı
• Google Workspace Geliştirici Önizleme Programı'na kayıtlı bir Google Cloud projesi
• Google Workspace hesabı
• Yerel makinenizde Antigravity 2.0, IDE ve/veya CLI yüklü olmalıdır. Daha fazla bilgi ve yükleme talimatlarını resmi web sitesinde bulabilirsiniz.

Bu codelab'e kolay erişim

2. Başlamadan önce

Google Workspace Geliştirici Önizleme Programı: Google Workspace MCP sunucularına erişim, Herkese Açık Geliştirici Önizleme Programı'nın bir parçasıdır. Henüz kaydolmadıysanız lütfen https://developers.google.com/workspace/preview adresinden kaydolun ve hesabınızın programa kabul edildiğinden emin olun.

Kurumsal Ön Koşullar: Uygun müşteriler için, kuruluşunuz Gemini Enterprise politikalarını uyguluyorsa yöneticinizin önce AI Geliştirici Araçları'nı etkinleştirmesi ve bağlanabilmeniz için Cloud Console'da Google Workspace MCP sunucu uç noktalarını izin verilenler listesine eklemesi gerekir. Daha fazla bilgi için Antigravity Enterprise blog yayınını ve Gemini Enterprise'da Antigravity ile Google Workspace MCP sunucuları Codelab'ini inceleyin.

Google Cloud projesi oluşturma veya seçme

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

API'leri etkinleştirme

Google Workspace MCP sunucularını kullanmak için standart Google Workspace API'lerini etkinleştirmeniz gerekir.

API'leri etkinleştirme

MCP hizmetlerini etkinleştirme

Ardından Google Workspace MCP hizmetlerini etkinleştirin.

MCP hizmetlerini etkinleştirme

Chat uygulamasını yapılandırma

Google Chat MCP sunucusunu kullanmak için Google Cloud projenizde bir Chat uygulaması yapılandırmanız gerekir.

1. Google Cloud Console'da Google Chat API'yi arayın ve Google Chat API > Yönet > Yapılandırma'yı tıklayın.

Google Chat API'ye gidin

2. Chat uygulamasını ayarlayın:
   • Uygulama adı alanına Chat MCP yazın.
   • Avatar URL (Avatar URL'si) alanına https://developers.google.com/chat/images/quickstart-app-avatar.png değerini girin.
   • Açıklama alanına Chat MCP server yazın.
   • İşlevsellik bölümünde Etkileşimli özellikleri etkinleştir'i kapatın.
   • Günlükler bölümünde Hataları Günlük Kaydı'na kaydet'i seçin.
3. Kaydet'i tıklayın.

3. OAuth kullanıcı rızası ve istemcisini yapılandırma

Kurumsal Not: Kurumsal bir Google Workspace ortamında, Cloud veya Gemini Enterprise yöneticiniz genellikle OAuth kullanıcı rızası ekranını ve istemci kimliğini merkezi olarak sağlar. Yöneticiniz size onaylanmış bir istemci kimliği sağladıysa bu adımı atlayıp doğrudan Antigravity'yi yapılandırma bölümüne geçebilirsiniz.

Google Workspace MCP sunucuları, güvenli kimlik doğrulama ve yetkilendirme için OAuth 2.0'ı kullanır. OAuth kullanıcı rızası ekranı yapılandırmanız ve web uygulaması istemcisi oluşturmanız gerekir.

OAuth kullanıcı rızası ekranını ayarlama

Önce kullanıcı rızası ekranını yapılandırmanız gerekir.

1. Google Cloud Console'da Google Auth Platform > Markalama'ya gidin. Yapılandırılmamışsa Başlayın'ı tıklayın.
2. Uygulama Bilgileri'ni yapılandırın:
   • Uygulama adı: Google Workspace MCP Servers
   • Kullanıcı desteği e-postası: E-posta adresinizi seçin.
3. Kitle'yi yapılandırın: Dahili'yi (veya Dahili seçeneği kullanılamıyorsa Harici'yi) seçin.
4. Contact Information'ı (İletişim Bilgileri) yapılandırın: E-posta adresinizi girin.
5. Kullanıcı Verileri Politikası'nı inceleyip kabul edin, ardından Oluştur'u tıklayın.
6. Harici'yi seçtiyseniz Kitle'ye gidin ve Test kullanıcıları bölümüne e-posta adresinizi ekleyin.
7. Veri Erişimi > Kapsam Ekle veya Kaldır'a gidin. Kapsamları manuel olarak ekleyin bölümünde, kullanmak istediğiniz sunucular için aşağıdakileri ekleyin:
   • Universal: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Google Dokümanlar: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
   • Google E-Tablolar: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
   • Google Slaytlar: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
   • Google Takvim: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.messages.create, https://www.googleapis.com/auth/chat.users.readstate.readonly
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Tabloya ekle'yi, ardından Güncelle'yi ve son olarak Kaydet'i tıklayın.

OAuth istemci kimliği oluşturma

1. Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) gidin.
2. Uygulama türü olarak Web uygulaması'nı seçin.
3. Antigravity olarak adlandırın.
4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve https://antigravity.google/oauth-callback değerini girin.
5. Yapay zeka destekli bir temsilci için bu istemciyi kullan'ı seçin.
6. Create'i (Oluştur) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret (İstemci Gizli Anahtarı) değerlerini kopyalayın. Bir sonraki adımda bunlara ihtiyacınız olacak.

4. Antigravity'yi yapılandırma

Şimdi Antigravity'yi bu uç noktaları kullanacak şekilde yapılandıralım. Antigravity 2.0, IDE ve/veya CLI yüklü değilse Antigravity web sitesindeki talimatları uygulayın.

Özel MCP sunucuları ekleme

Antigravity 2.0, IDE ve KSA, ~/.gemini/config/mcp_config.json dosyasında merkezi bir MCP yapılandırmasını paylaşır.

1. Dosyayı tercih ettiğiniz metin düzenleyicide açın.

   Not: Antigravity IDE yüklüyse aşağıdaki adımları uygulayarak dosyaya doğrudan Antigravity IDE'den erişebilirsiniz:

   1. Düzenleyicinin temsilci panelinin üst kısmındaki ... açılır listesinden MCP Servers'ı (MCP Sunucuları) açın.
   2. MCP Sunucularını Yönet'i, ardından Ham yapılandırmayı görüntüle'yi tıklayın.
2. Aşağıdaki özel MCP sunucusu yapılandırmasını değiştirin. Bunu yapmadan önce <YOUR_CLIENT_ID> ve <YOUR_CLIENT_SECRET> yer tutucularını önceki adımlarda oluşturduğunuz OAuth istemci kimliği ve gizli anahtarıyla değiştirin.
3. Kaydedin.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

Özel MCP sunucularının kimliğini doğrulama

Antigravity'de yapılandırdığınız tüm MCP sunucularının yüklü olduğunu görmeniz gerekir: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat ve gws-people. OAuth jetonları merkezi olmadığından her birinin kimliğini her Antigravity yüzeyi için doğrulamanız gerekir.

Kurumsal politika hatalarını giderme: Bir MCP sunucusu, Yenile'yi tıkladığınızda Unauthorized / Blocked by Admin Policy gösteriyorsa bu hizmet, kuruluşunuzun Gemini Enterprise izin verilenler listesine dahil değildir. Hizmet uç noktasını eklemek için yöneticinizle iletişime geçin ve yapılandırma konusunda rehberlik için Gemini Enterprise Yönetici Kod Laboratuvarı'nı onlarla paylaşın.

Antigravity 2.0

1. Sol alttaki Ayarlar'ı tıklayın.
2. Özelleştirmeler'e gidin.
3. Yüklü MCP sunucuları bölümünde Yenile'yi tıklayın.

4. Listelenen her yüklü MCP sunucusu için:
   1. Kimlik doğrula'yı tıklayın.
   
   2. Açılan yeni tarayıcı penceresinde kimlik doğrulama akışını tamamlayın.
   3. İşlem tamamlandığında Panoya kopyala'yı tıklayın.
   
   4. Kopyaladığınız yetkilendirme kodunu Antigravity 2.0'ın ayarlarında gösterilen metin alanına yapıştırın ve Gönder'i tıklayın.
   
   5. Kimlik doğrula düğmesinin yerine artık Oturumu kapat düğmesi gösterilir.
   

Antigravity IDE

1. Pencerenin üst kısmındaki Editöre Özel ayarlar menüsünün açılır listesinden Antigravity Kullanıcı Ayarları'nı açın.

2. Özelleştirmeler'e gidin.
3. Yüklü MCP sunucuları bölümünde Yenile'yi tıklayın.

4. Listelenen her yüklü MCP sunucusu için:
   1. Kimlik doğrula'yı tıklayın.
   
   2. Açılan yeni tarayıcı penceresinde kimlik doğrulama akışını tamamlayın.
   3. İşlem tamamlandığında Panoya kopyala'yı tıklayın.
   
   4. Kopyaladığınız yetkilendirme kodunu Antigravity IDE'nin ayarlarında gösterilen metin alanına yapıştırın ve Submit'i (Gönder) tıklayın.
   
   5. Kimlik doğrula düğmesinin yerine artık Oturumu kapat düğmesi gösterilir.
   

Antigravity CLI

1. /mcp yazın ve Enter tuşuna basın.

2. Listelenen her MCP sunucusu için:
   1. Yukarı ve aşağı ok tuşlarını kullanarak seçin ve Enter tuşuna basın.
   2. Sol ve sağ ok tuşlarını kullanarak Authenticate'i (Kimlik doğrula) seçin ve Enter tuşuna basın.
   
   3. Gösterilen URL'yi yeni bir tarayıcı penceresinde açın ve kimlik doğrulama akışını tamamlayın.
   
   4. İşlem tamamlandığında Panoya kopyala'yı tıklayın.
   
   5. Kopyaladığınız yetkilendirme kodunu, Antigravity CLI'ın çalıştığı terminalinizde gösterilen metin alanına yapıştırın ve Enter tuşuna basın.
   
   6. Artık Yetkilendirme Gerekli yerine Yetkilendirildi durumu gösterilir.
   

5. Test araçları

Artık doğal dili kullanarak Google Workspace verilerinizle etkileşim kurabilirsiniz. Her hizmet için bazı istem örnekleri aşağıda verilmiştir.

Not: Aşağıdaki istemlerde köşeli parantez içindeki yer tutucuları (ör. [NAME], [FILE_NAME]) kendi Google Workspace verilerinizdeki gerçek değerlerle değiştirin.

tek beden

Farklı ürünlerde arama yapmayı deneyin:

• "Google Workspace hesabımda en son gerçekleşen işlemleri birkaç cümleyle özetle."
• "E-postalarım, dokümanlarım ve sohbet mesajlarımda [PROJE_ADI] ile ilgili her şeyi bul."
• "Pazarlama planıyla ilgili bir sonraki toplantım ne zaman ve bu konuyla ilgili en son notlar ve sohbet mesajları neler?"

Gmail

E-postalarınızı aramayı veya yönetmeyi deneyin:

• "Aldığım son 5 e-postayı özetle."
• "[EMAIL_ADDRESS] adresine '[PROJECT_NAME]' projesiyle ilgili güncelleme isteyen bir e-posta taslağı oluştur."

Google Drive

Dosyaları aramayı veya okumayı deneyin:

• "Google Drive'ımda '[ANAHTAR_KELİME]' ifadesini içeren dosyaları ara."
• "Düzenlediğim en son dokümanları listele."
• "[DOSYA_ADI]' adlı dokümanımın içeriğini oku ve ana hedefleri özetle."

Google Dokümanlar, E-Tablolar, Slaytlar

Drive kaynaklarınızda arama yapmayı deneyin:

• "Google Dokümanı [DOCS_TITLE] belgesinin yapısal içeriğini göster."
• "[SHEETS_TITLE] adlı Google E-Tablosu'ndaki Sayfa1 adlı sayfayı oku"
• "Google Slaytlar'daki [SLIDES_TITLE] sunusunun sözlü düzenini göster."

Google Takvim

Programınızda arama yapmayı deneyin:

• "Bu hafta yaklaşan toplantılarım neler?"
• "Yarın öğleden sonra boş vaktim var mı?"

Google Chat

Mesajları aramayı deneyin:

• "'[SPACE_NAME]' alanında '[KEYWORD]' ifadesini içeren mesajları ara"

People API

Profilinizde veya kişilerinizde arama yapmayı deneyin:

• "Google profilime göre adım ne?"
• "[AD] için iletişim bilgilerini bul."

Birden Fazla Hizmeti Birleştirme

MCP'nin gerçek gücü, birden fazla hizmette görevleri yönetirken ortaya çıkar. Hizmetler arası özellikleri gösteren şu istemleri deneyin:

• "Drive'da '[PROJE_ADI] ara hedef güncellemeleri' ile ilgili dosyaları ara, içeriklerini özetle, '[AD]' adlı kişinin e-posta adresini bul ve bu kişiye özeti içeren bir Gmail taslağı oluştur."

Daha Fazla Araç Keşfedin

Bunlar, yapabileceklerinizden yalnızca birkaçıdır. Her hizmet için kullanılabilen araçların tam listesini görmek ve bunları denemek için resmi belgelerin Desteklenen Ürünler bölümüne bakın.

6. Temizleme

Projenizi silmeden temizlemek için etkinleştirdiğiniz API'leri ve MCP hizmetlerini devre dışı bırakabilirsiniz:

1. Google Cloud Console'da API ve Hizmetler Kontrol Paneli'ne gidin.
2. Etkinleştirdiğiniz Google Workspace ve MCP API'lerinin (ör. Takvim MCP, Chat MCP) her birini tıklayın ve API'yi devre dışı bırak'ı seçin.

Artık kullanmayı planlamıyorsanız Google Auth Platform konsolundaki OAuth istemci kimlik bilgilerini silin.

7. Tebrikler

Tebrikler! Antigravity'yi kullanarak resmi Google Workspace MCP sunucularını başarıyla yapılandırıp test ettiniz.

Referans belgeler

• Model Context Protocol'e (MCP) giriş
• Google Workspace MCP sunucularını yapılandırma
• OAuth kullanıcı rızasını yapılandırma
• Antigravity Enterprise'a Genel Bakış
• Gemini Enterprise'da Antigravity ile Google Workspace MCP sunucuları codelab'i
• Antigravity