Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Google Workspace MCP sunucularını yapılandırma

Google Workspace, yapay zeka ajanlarının Google Workspace verileriyle güvenli bir şekilde etkileşime girmesine olanak tanıyan uzaktan Model Context Protocol (MCP) sunucuları sunar. Google Workspace MCP sunucularını yapılandırarak Google Antigravity ve Claude gibi yapay zeka uygulamalarının Gmail, Google Drive, Google Takvim ve Google Chat gibi Google Workspace uygulamalarında işlem yapmasını sağlayabilirsiniz. Her Google Workspace ürününün kendi özel MCP sunucusu vardır.

Google Workspace MCP sunucuları, yapay zeka ajanlarının aşağıdakileri yapması için standartlaştırılmış bir yöntem sunar:

Verileri okuma: E-postalarda arama yapma, dosyaları alma ve takvim etkinliklerini listeleme
Harekete geçin: E-posta taslakları oluşturun, dosya yükleyin ve toplantı planlayın.
Güvenliğe saygı duyma: Kullanıcıyla aynı izinleri ve veri yönetimi kontrollerini devralın.

Ön koşullar

Google Cloud projesi. Proje oluşturmak için Proje oluşturma başlıklı makaleyi inceleyin.
Google Antigravity gibi bir MCP istemcisi.
Bu sayfadaki komutları çalıştırmak için aşağıdaki adımları uygulayarak gcloud CLI'yı yerel bir geliştirme ortamında ayarlayın:
1. Google Cloud KSA'yı yükleyin. gcloud CLI'yi daha önce yüklediyseniz gcloud components update komutunu çalıştırarak en son sürüme sahip olduğunuzdan emin olun.
2. Harici bir kimlik sağlayıcı (IdP) kullanıyorsanız birleştirilmiş kimliğinizle gcloud CLI'da oturum açın. Daha fazla bilgi için Federasyon kimliğinizle gcloud CLI'da oturum açma başlıklı makaleyi inceleyin.
3. gcloud CLI'yı başlatın.

Google Workspace MCP sunucularını yapılandırma

Google Workspace MCP sunucularını kullanmak için bunları Google Cloud projenizde etkinleştirmeniz ve ardından MCP istemcinizi bunlara bağlanacak şekilde yapılandırmanız gerekir.

API'leri etkinleştirme

Google Workspace MCP sunucularını kullanmak için Google Cloud projenizde aşağıdaki API'leri etkinleştirmeniz gerekir:

Gmail API
Google Drive API
Google Calendar API
Google Chat API
People API

KSA

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com --project=PROJECT_ID

PROJECT_ID kısmını Google Cloud proje kimliğinizle değiştirin.

Konsol

Google Cloud Console'da API'leri etkinleştirin:

API'leri etkinleştirme

MCP hizmetlerini etkinleştirme

Her Google Workspace ürünü için MCP bileşenlerini etkinleştirmek üzere Google Cloud projenizde aşağıdaki hizmetleri etkinleştirmeniz gerekir:

Gmail MCP API
Google Drive MCP API
Google Calendar MCP API
Google Chat MCP API
People MCP API

KSA

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com --project=PROJECT_ID

PROJECT_ID kısmını Google Cloud proje kimliğinizle değiştirin.

Konsol

Google Cloud Console'da 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.

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 gitme
Chat uygulamasını ayarlayın:
1. Uygulama adı alanına Chat MCP girin.
2. Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png girin.
3. Açıklama bölümüne Chat MCP server girin.
4. İşlevsellik bölümünde, Etkileşimli özellikleri etkinleştir seçeneğini devre dışı bırakarak etkileşimli özellikleri kapatın.
5. Günlükler bölümünde Günlüğe kaydetme işlemine hata günlüğü ekle'yi seçin.
Kaydet'i tıklayın.

Chat uygulaması oluşturma hakkında daha fazla bilgi edinmek için Google Chat uygulama mimarisi seçme başlıklı makaleyi inceleyin.

Google Workspace MCP sunucuları, kimlik doğrulama ve yetkilendirme için OAuth 2.0'ı kullanır. OAuth istemci kimliği oluşturabilmeniz için önce OAuth kullanıcı rızası ekranını yapılandırmanız gerekir.

Google Cloud Console'da Google Auth Platform > Branding'e (Markalama) gidin.

Markalama'ya gidin.
Google Auth Platform'u zaten yapılandırdıysanız Markalama, Kitle ve Veri Erişimi'nde aşağıdaki OAuth kullanıcı rızası ekranı ayarlarını yapılandırabilirsiniz. Google Auth Platform henüz yapılandırılmadı mesajını görüyorsanız Başlayın'ı tıklayın:
1. App Information (Uygulama Bilgileri) bölümündeki App name (Uygulama adı) alanına Workspace MCP Servers yazın.
2. Kullanıcı desteği e-postası bölümünde e-posta adresinizi veya uygun bir Google Grubu'nu seçin.
3. İleri'yi tıklayın.
4. Kitle bölümünde Şirket içi'ni seçin. Dahili'yi seçemiyorsanız Harici'yi seçin.
5. İleri'yi tıklayın.
6. İletişim bilgileri bölümünde, projenizde yapılan değişikliklerle ilgili bildirim alabileceğiniz bir e-posta adresi girin.
7. İleri'yi tıklayın.
8. Bitir bölümünde Google API Hizmetleri Kullanıcı Verileri Politikası'nı inceleyin ve kabul ediyorsanız Google API Hizmetleri: Kullanıcı Verileri Politikası'nı kabul ediyorum'u seçin.
9. Devam'ı tıklayın.
10. Oluştur'u tıklayın.
11. Kullanıcı türü için Harici'yi seçtiyseniz test kullanıcıları ekleyin:
  1. Kitle'yi tıklayın.
  2. Test kullanıcıları bölümünde Kullanıcı ekle'yi tıklayın.
  3. E-posta adresinizi ve yetkili diğer test kullanıcılarını girip Kaydet'i tıklayın.
Veri Erişimi > Kapsam Ekleme veya Kaldırma'yı tıklayın. Google Cloud projenizde etkinleştirdiğiniz her API'nin kapsamlarının listelendiği bir panel gösterilir.
1. Kapsamları manuel olarak ekleme bölümünde, kullanmak istediğiniz MCP sunucularının kapsamlarını yapıştırın:
  - 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 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
2. Tabloya Ekle'yi tıklayın.
3. Güncelle'yi tıklayın.
4. Uygulamanızın gerektirdiği kapsamları seçtikten sonra Veri Erişimi sayfasında Kaydet'i tıklayın.

MCP istemcinizi yapılandırın

Google Workspace uzak MCP sunucusunu MCP istemcinize eklemek için istemcinizle ilgili talimatları uygulayın.

Antigravity

Google Workspace uzaktan MCP sunucularını Antigravity'ye eklemek için sunucu yapılandırmasını mcp_config.json dosyanıza ekleyin. Bu talimatlar Antigravity 2.0, Antigravity IDE ve Antigravity CLI'yı destekler.

OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:
1. Google Cloud Console'da Google Auth Platform > Clients > Create Client'a (İstemci Oluştur) gidin.
  
  İstemci Oluştur'a gitme
2. Uygulama türü olarak Web uygulaması'nı seçin.
3. Bir Ad girin.
4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın, ardından URI'ler alanına https://antigravity.google/oauth-callback ekleyin.
5. Oluştur'u tıklayın ve istemci kimliğinizi ve istemci gizli anahtarınızı kopyalayın.
Yapılandırma dosyasını açın veya oluşturun ~/.gemini/antigravity/mcp_config.json.

mcpServers yapılandırmasını mcp_config.json'ye ekleyin:

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

Aşağıdakini değiştirin:

OAUTH_CLIENT_ID: Oluşturduğunuz istemci kimliği.
OAUTH_CLIENT_SECRET: Oluşturduğunuz istemci gizli anahtarı.

mcp_config.json tasarruf edin.
MCP sunucularının kimliğini doğrulayın. Kimlik doğrulama işlemini, GUI ayarlarını veya KSA'yı kullanarak yapabilirsiniz:
- Antigravity IDE veya GUI (Antigravity 2.0) için:
  1. Ayarlar ekranınızı açın (ör. sol alttaki Ayarlar'ı tıklayın veya 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 sunucu için (gmail, drive, calendar, people, chat) Kimlik doğrula'yı tıklayın, Google Hesabınızda oturum açın, yetkilendirme kodunu kopyalayın, giriş iletişim kutusuna yapıştırın ve Gönder'i tıklayın.
- Antigravity CLI için:
  1. Antigravity CLI'yı başlatın:
```
agy
```
  2. Aşağıdaki komutu çalıştırarak etkileşimli MCP yönetim panelini açın:
```
/mcp
```
  3. Her MCP sunucusunun kimliğini doğrulayın:
    1. Sunucuyu seçmek için ok tuşlarını kullanın, Kimlik doğrulama işlemine gidin ve Enter tuşuna basın. Tarayıcınızda oturum açma akışını tamamlayın, yetkilendirme kodunu kopyalayın, terminal istemine yapıştırın ve Enter tuşuna basın.
    2. Yapılandırdığınız her sunucu için bu adımları tekrarlayın (gmail, drive, calendar, people, chat).
Sunucuların doğru şekilde yapılandırıldığını ve çalıştığını doğrulayın:
- Antigravity IDE veya GUI için: Özelleştirmeler > Yüklü MCP Sunucuları bölümündeki her sunucunun yanında bir Oturumu kapat düğmesi gösterilir.
- Antigravity CLI için: Yapılandırılmış MCP sunucularınızı görüntülemek üzere /mcp panelini açın. Doğrulanmış ve kimliği doğrulanmış sunucular, etkileşimli TUI panelinde adlarının yanında Authed (Kimliği Doğrulanmış) ifadesini gösterir. Durumunu incelemek ve kullanılabilir tüm araçlarını listelemek için kontrol paneli görünümündeki herhangi bir sunucuyu seçebilirsiniz.

Uzak MCP sunucuları Antigravity'de kullanıma hazırdır.

Claude

Google Workspace'in uzaktan MCP sunucularını Claude.ai veya Claude Desktop ile kullanmak için Claude Enterprise, Pro, Max ya da Team planınız olmalıdır.

Google Workspace uzak MCP sunucularını Claude'a eklemek için OAuth istemci kimliği ve gizli anahtarıyla özel bir bağlayıcı yapılandırın.

OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:
1. Google Cloud Console'da Google Auth Platform > Clients > Create Client'a (İstemci Oluştur) gidin.
  
  İstemci Oluştur'a gitme
2. Uygulama türü olarak Web uygulaması'nı seçin.
3. Bir Ad girin.
4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve URI'ler alanına https://claude.ai/api/mcp/auth_callback ekleyin.
5. Oluştur'u tıklayın ve istemci kimliğinizi ve istemci gizli anahtarınızı kopyalayın.
Claude'da MCP sunucusunu yapılandırın:
1. Claude.ai veya Claude Desktop'ta Ayarlar (veya Yönetici ayarları) > Bağlayıcılar'a gidin.
2. Özel bağlayıcı ekle'yi tıklayın.
3. Eklemek istediğiniz Google Workspace ürünü için bağlantı ayrıntılarını girin:
  - Sunucu adı: Sunucu için bir ad (ör. Gmail).
  - Uzak MCP sunucu URL'si: Google Workspace ürününün URL'si (ör. aşağıdakilerden biri):
    - Gmail: https://gmailmcp.googleapis.com/mcp/v1
    - Google Drive: https://drivemcp.googleapis.com/mcp/v1
    - Google Takvim: https://calendarmcp.googleapis.com/mcp/v1
    - Google Chat: https://chatmcp.googleapis.com/mcp/v1
    - People API: https://people.googleapis.com/mcp/v1
4. Gelişmiş ayarlar bölümünde OAuth istemci kimliğinizi ve OAuth istemci gizli anahtarınızı girin.
5. Ekle'yi tıklayın.
6. Eklemek istediğiniz her Google Workspace ürünü için bu adımları tekrarlayın.

Diğer

Birçok yapay zeka uygulamasında uzak bir MCP sunucusuna bağlanma yöntemleri vardır. Genellikle sunucuyla ilgili ayrıntıları (ör. adı, uç noktaları, aktarım protokolü ve kimlik doğrulama yöntemi) girmeniz gerekir. Google Workspace uzak MCP sunucuları için aşağıdakileri girin:

Sunucu adı: googleworkspace
Sunucular: Her Google Workspace ürününün kendi sunucu URL'si vardır:
- Gmail: https://gmailmcp.googleapis.com/mcp/v1
- Google Drive: https://drivemcp.googleapis.com/mcp/v1
- Google Takvim: https://calendarmcp.googleapis.com/mcp/v1
- Google Chat: https://chatmcp.googleapis.com/mcp/v1
- People API: https://people.googleapis.com/mcp/v1
Taşıma: HTTP
Kimlik doğrulama: Google Workspace uzaktan MCP sunucusu OAuth 2.0'ı kullanır. Ayrıntılar için Kimlik doğrulama ve yetkilendirme hakkında başlıklı makaleyi inceleyin.

Farklı istemci türlerini bağlama hakkında daha fazla bilgi için Yapay zeka uygulamasında MCP'yi yapılandırma başlıklı makaleyi inceleyin.

Google Workspace MCP sunucularını test etme

MCP istemcisini yapılandırdıktan sonra bazı test istemleri çalıştırarak bağlantıyı doğrulayabilirsiniz.

MCP istemcinize aşağıdaki soruları sormayı deneyin:

"Google Profilime göre adım ne?"

İstemci, Google Workspace profil bilgilerinizi almak için people.get_user_profile kullanır.
"Pazarlama Planı dosyasını özetle."

Müşteri, "Pazarlama Planı"nı bulmak için drive.search_files'ı arar, ardından içeriğini almak ve özetlemek için drive.read_file_content'ı kullanır.
"Ariel, pazarlama planımızla ilgili son e-postasında ne demişti?"

İstemci, Ariel'den gelen e-postaları gmail.search_threads kullanarak filtreler, en son ileti dizisinin içeriğini gmail.get_thread ile alır ve ardından sizin için özetler.
"ariel@example.com adresine, pazarlama planını onayladığımı belirten bir e-posta taslağı oluştur."

İstemci, taslaklar klasörünüzde e-posta oluşturmak için gmail.create_draft kullanır. Böylece, e-postayı Gmail'den inceleyip gönderebilirsiniz.
"Ariel ile bir sonraki toplantım ne zaman?"

Müşteri, calendar.list_events ve ayrıntıları kullanarak programınızı kontrol eder ve Ariel ile bir sonraki toplantınızı planlar.

Araçlar başarıyla çalışırsa ve alakalı yanıtlar alırsanız Google Workspace MCP sunucularınız doğru şekilde yapılandırılmıştır.

Sorun giderme

MCP sunucularına bağlanırken sorun yaşarsanız OAuth günlüklerinde hataları kontrol edebilirsiniz. Yöneticinizden güvenlik incelemesi aracındaki OAuth günlüğü etkinliklerini kontrol etmesini isteyin.

Desteklenen ürünler

Aşağıdaki Google Workspace ürünleri, Google Workspace MCP sunucularını destekler ve aşağıdaki araçları sunar:

Önemli güvenlik noktası: Dolaylı istem enjeksiyonu

Bir dil modelini güvenilmeyen verilere maruz bıraktığınızda dolaylı istem yerleştirme saldırısı riski oluşur. Google Antigravity gibi MCP istemcileri, Google Workspace MCP sunucuları aracılığıyla güçlü araçlara ve API'lere erişebildiğinden Google Hesabınızdaki verileri okuyabilir, değiştirebilir ve silebilir.

Bu riskleri azaltmak için aşağıdaki en iyi uygulamaları izleyin:

Yalnızca güvenilir araçları kullanın. Google Workspace MCP sunucularını hiçbir zaman güvenilmeyen veya doğrulanmamış uygulamalara bağlamayın.
Güvenilmeyen girişlere karşı dikkatli olun. MCP istemcinizden, doğrulanmamış kaynaklardan gelen e-postaları, dokümanları veya diğer kaynakları işlemesini istemeyin. Bu girişler, oturumunuzu ele geçirebilecek gizli talimatlar içerebilir. Bu durumda saldırganlar verilerinizi değiştirebilir, çalabilir veya silebilir.
Tüm işlemleri inceleyin. Doğru olduklarından ve amaçlarınızla uyumlu olduklarından emin olmak için yapay zeka istemcinizin sizin adınıza yaptığı işlemleri her zaman dikkatlice inceleyin.

Google Workspace MCP sunucularını yapılandırma Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Ön koşullar

Google Workspace MCP sunucularını yapılandırma

API'leri etkinleştirme

KSA

Konsol

MCP hizmetlerini etkinleştirme

KSA

Konsol

Chat uygulamasını yapılandırma

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

MCP istemcinizi yapılandırın

Antigravity

Claude

Diğer

Google Workspace MCP sunucularını test etme

Sorun giderme

Desteklenen ürünler

Önemli güvenlik noktası: Dolaylı istem enjeksiyonu

İlgili konular

Google Workspace MCP sunucularını yapılandırma