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 blog yayınında bulabilirsiniz.

Bu codelab'de, Google Workspace verilerinizi Antigravity 2.0, entegre geliştirme ortamı ve/veya KSA'ya bağlamak için Model Bağlam Protokolü'nü (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. Antigravity'yi, Gmail, Google Drive, Google Dokümanlar, Google E-Tablolar, Google Slaytlar, Google Takvim, Google Chat ve People API ile kod yazmadan etkileşim kuracak şekilde 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 Önizlemesi Programı'na kayıtlı bir Google Cloud projesi
• Google Workspace hesabı
• Yerel makinenizde Antigravity 2.0, IDE ve/veya CLI'nın yüklü olması. Daha fazla bilgi ve yükleme talimatlarını resmi web sitesinde bulabilirsiniz.

Bu codelab'e kolayca erişebilirsiniz.

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 yapmadıysanız lütfen https://developers.google.com/workspace/preview adresinden kaydolun ve hesabınızın programa kabul edildiğinden emin olun.

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 girin.
   • Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png girin.
   • Açıklama bölümüne Chat MCP server girin.
   • İşlevsellik bölümünde Etkileşimli özellikleri etkinleştir'i devre dışı bırakın.
   • Günlükler bölümünde Günlüğe kaydetme işlemine günlük hataları'nı seçin.
3. Kaydet'i tıklayın.

3. OAuth iznini ve istemcisini yapılandırma

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 bir web uygulaması istemcisi oluşturmanız gerekir.

OAuth izin ekranını ayarlama

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

1. Google Cloud Console'da Google Auth Platform > Branding'e (Markalama) 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ı destek e-postası: E-postanızı seçin.
3. Kitle'yi yapılandırın: Dahili'yi (veya Dahili kullanılamıyorsa Harici'yi) seçin.
4. İletişim bilgilerini 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 Ekleme veya Kaldırma'ya gidin. Kapsamları manuel olarak ekleme 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 > 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. Oluştur'u tıklayın ve İstemci Kimliği ile İstemci Gizli Anahtarı'nı kopyalayın. Bu bilgilere bir sonraki adımda 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'yi yüklediyseniz aşağıdaki adımları uygulayarak dosyaya doğrudan erişebilirsiniz:

   1. Düzenleyicinin temsilci panelinin üst kısmındaki ... açılır menüsünden MCP Sunucuları'nı açın.
   2. MCP sunucularını yönetin'i ve 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 yüklü olarak yapılandırdığınız tüm MCP sunucularını 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 birini her Antigravity yüzeyi için ayrı ayrı doğrulamanız gerekir.

Antigravity 2.0

1. Sol alttan 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. Kimliği 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. Yeni 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ğrulama düğmesinin yerini Oturumu kapat düğmesi aldı.
   

Antigravity IDE

1. Pencerenin üst kısmındaki Editöre Özgü Ayarlar menü 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. Kimliği 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. Yeni kopyaladığınız yetkilendirme kodunu Antigravity IDE'nin ayarlarında gösterilen metin alanına yapıştırın ve Gönder'i tıklayın.
   
   5. Kimlik doğrulama düğmesinin yerini Oturumu kapat düğmesi aldı.
   

Antigravity CLI

1. /mcp yazıp 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 Kimlik doğrula'yı seçin ve enter tuşuna basın.
   
   3. Yeni bir tarayıcı penceresinde gösterilen URL'yi açın ve kimlik doğrulama akışını tamamlayın.
   
   4. İşlem tamamlandığında Panoya Kopyala'yı tıklayın.
   
   5. Antigravity CLI çalışırken terminalinizde görüntülenen metin alanına az önce kopyaladığınız yetkilendirme kodunu yapıştırın ve Enter tuşuna basın.
   
   6. Yetkilendirme Gerekli yerine artık Yetkilendirildi durumu gösteriliyor.
   

5. Test araçları

Artık doğal dil kullanarak Google Workspace verilerinizle etkileşim kurabilirsiniz. Her hizmet için bazı istem örneklerini aşağıda bulabilirsiniz.

Not: Aşağıdaki istemlerdeki 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 olanları birkaç cümleyle özetle."
• "E-postam, dokümanlarım ve sohbet mesajlarımda [PROJECT_NAME] ile ilgili her şeyi bul."
• "Pazarlama planıyla ilgili bir sonraki toplantım ne zaman ve bu toplantıyla 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 isteğinde bulunan bir e-posta taslağı oluştur."

Google Drive

Dosyaları aramayı veya okumayı deneyin:

• "Google Drive'ımda "[ANAHTAR KELİME]" kelimesini içeren dosyaları ara."
• "Düzenlediğim en son belgeleri listele."
• "Read the content of my ‘[FILE_NAME]' doc and summarize the main goals." ([FILE_NAME] adlı dokümanımın içeriğini oku ve temel hedefleri özetle.)

Google Dokümanlar, E-Tablolar, Slaytlar

Drive kaynaklarınızda arama yapmayı deneyin:

• "Google Dokümanı [DOCS_TITLE] içeriğinin yapısını göster."
• "[SHEETS_TITLE] adlı Google E-Tablosu'ndaki E-Tablo1'i oku"
• "Google Slaytlar [SLIDES_TITLE] sunusunun sözlü olarak açıklanan 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ş zamanım var mı?"

Google Chat

İletileri aramayı deneyin:

• "Look for messages containing ‘[KEYWORD]' in ‘[SPACE_NAME]'" ([SPACE_NAME] alanında "[KEYWORD]" anahtar kelimesini içeren mesajları ara)

People API

Profilinizde veya kişilerinizde arama yapmayı deneyin:

• "Google profilime göre adım ne?"
• "Find contact info for ‘[NAME]'." ([AD] için iletişim bilgilerini bul.)

Birden Fazla Hizmeti Birleştirme

MCP'nin gerçek gücü, birden fazla hizmetteki görevleri düzenlerken ortaya çıkar. Hizmetler arası özellikleri gösteren aşağıdaki istemleri deneyin:

• "Drive'da "[PROJECT_NAME] dönüm noktası güncellemeleri" ile ilgili dosyaları ara, içeriklerini özetle, "[NAME]" adlı kişinin e-posta adresini bul ve özetle birlikte bu kişiye gönderilecek bir Gmail taslağı oluştur."

Diğer Araçları Keşfedin

Bunlar, yapabileceklerinizden yalnızca birkaç örnektir. 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 her birini (ör. Takvim MCP, Chat MCP) ve API'yi devre dışı bırak'ı tıklayın.

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ırdınız ve test ettiniz.

Referans belgeleri

• Model Bağlam Protokolü'ne (MCP) giriş
• Google Workspace MCP sunucularını yapılandırma
• OAuth iznini yapılandırma
• Antigravity