Antigravity'deki Google Workspace MCP sunucuları

1. Giriş

Not: Gemini CLI'ı mı kullanıyorsunuz? Bunun yerine bu codelab'e gidin. Bu kılavuz, Antigravity ile ilgilidir.

Bu codelab'de, Antigravity'yi Google Workspace verilerinize 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. Antigravity'yi, Gmail, Google Drive, 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 Cloud projesi
• Google Workspace hesabı
• Yerel makinenizde Antigravity yüklü olmalıdır.

Bu codelab'e kolay erişim

2. Başlamadan önce

Google Workspace Geliştirici Önizlemesi Programı: Google Workspace MCP sunucularına erişim, herkese açık Geliştirici Önizlemesi 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. Bazı MCP sunucuları bağımsız olarak çalışsa da diğerleri için temel standart API'nin etkinleştirilmesi gerekir:

• Gmail ve Chat için standart API'ler gereklidir.
• Drive, belirli araçlar için standart API'yi gerektirir.
• Takvim'in standart API'nin etkinleştirilmesini gerektirmez.
• People API hem standart erişimi hem de MCP işlevini yönettiğinden etkinleştirilecek ayrı bir MCP hizmeti yoktur.

API'leri etkinleştirme

MCP Hizmetlerini Etkinleştirme

Ardından, ürünler için özel 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ı kurun:
   • 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ük hatalarını Logging'e seçeneğini belirleyin.
3. Kaydet'i tıklayın.

3. OAuth iznini ve istemcisini yapılandırma

Google Workspace MCP sunucuları, güvenli kimlik doğrulama 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 kullanıcı rızası ekranını ayarlama

Google Workspace MCP sunucuları, kimlik doğrulama için OAuth 2.0'ı kullanır. Öncelikle 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ı 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:
   • 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.users.readstate.readonly
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • 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 yüklü değilse Antigravity web sitesindeki yükleme talimatlarını uygulayın.

Özel MCP sunucuları ekleme

1. Düzenleyicinin temsilci panelinin üst kısmındaki ... açılır listesinden MCP Servers'ı (MCP Sunucuları) açın.

2. MCP sunucularını yönetin'i ve ardından Ham yapılandırmayı görüntüle'yi tıklayın.

4. Yeni açılan mcp_config.json dosyasını aşağıdaki özel MCP sunucusu yapılandırmasıyla 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 sırrı ile değiştirin:

{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

5. MCP Sunucularını Yönet'e dönün ve Yenile'yi tıklayın.

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

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 SUNUCULARI altında listelenen her sunucu 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. Tarayıcı penceresini kapatın.
5. Kopyaladığınız yetkilendirme kodunu, Antigravity'nin ayarlarında gösterilen metin alanına yapıştırın.
6. Gönder'i tıklayın.

5. Test araçları

Artık doğal dil kullanarak Google Workspace verilerinizle etkileşim kurabilirsiniz. Her hizmet için bazı örnek istemleri 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.

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)

Google Drive

Dosya arama veya okuma işlemlerini deneyin:

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

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."

People API

Profilinizde veya kişilerinizde aramayı 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 ilgili bir Gmail taslağı oluşturup bu kişiye gönder."

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 Context Protocol'e (MCP) giriş
• Google Workspace MCP sunucularını yapılandırma
• OAuth iznini yapılandırma
• Antigravity Editor: MCP Entegrasyonu