Sohbet MCP sunucusunu yapılandırma

Google Chat, yapay zeka ajanlarının Google Chat verileriyle güvenli bir şekilde etkileşim kurmasına olanak tanıyan uzak bir Model Context Protocol (MCP) sunucusu sunar. Google Chat MCP sunucusunu yapılandırarak Google Antigravity ve Claude gibi yapay zeka uygulamalarının Google Chat'te işlem yapmasına izin verirsiniz.

Google Chat MCP sunucusu, yapay zeka ajanlarının aşağıdakileri yapması için standart bir yöntem sunar:

  • Verileri okuma: Görüşmeleri listeleme ve arama, mesajları okuma.
  • Güvenliğe saygı: Kullanıcıyla aynı izinleri ve veri yönetimi kontrollerini devralır.

Ön koşullar

Google Chat MCP sunucusunu yapılandırma

Google Chat MCP sunucusunu kullanmak için Google Cloud projenizde etkinleştirmeniz ve ardından MCP istemcinizi sunucuya bağlanacak şekilde yapılandırmanız gerekir.

API'leri etkinleştirme

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

  • Google Chat API

KSA

gcloud services enable chat.googleapis.com --project=PROJECT_ID

PROJECT_ID yerine Google Cloud proje kimliğinizi yazın.

Konsol

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

API'leri etkinleştirme

MCP hizmetlerini etkinleştirme

Google Chat için MCP bileşenlerini etkinleştirmek istiyorsanız Google Cloud projenizde aşağıdaki hizmeti etkinleştirmeniz gerekir:

  • Google Chat MCP API

KSA

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

PROJECT_ID yerine Google Cloud proje kimliğinizi yazın.

Konsol

Google Cloud Console'da MCP hizmetlerini etkinleştirin:

MCP hizmetlerini etkinleştirme

Chat uygulamasını yapılandırma

Google Chat MCP sunucusunu kullanarak görüşme arama gibi salt okunur işlemler gerçekleştirmek için API'yi etkinleştirmeniz ve bir OAuth istemcisi oluşturmanız gerekir. Yapılandırılmış bir Chat uygulaması gerekli değildir.

Mesaj gönderme gibi yazma işlemleri gerçekleştirmek 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ı ayarlama:

    1. Uygulama adı alanına Chat MCP yazın.
    2. Avatar URL alanına https://developers.google.com/chat/images/quickstart-app-avatar.png değerini girin.
    3. Description (Açıklama) alanına Chat MCP server yazın.
    4. İşlevsellik bölümünde, Etkileşimli özellikleri etkinleştir ayarını kapatarak etkileşimli özellikleri devre dışı bırakın.
    5. Günlükler bölümünde Hataları Günlük Kaydı'na kaydet'i seçin.

  3. Kaydet'i tıklayın.

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

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

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

    Markalama'ya gidin

  2. Google Auth Platform'u zaten yapılandırdıysanız aşağıdaki OAuth kullanıcı rızası ekranı ayarlarını Markalama, Kitle ve Veri Erişimi'nde yapılandırabilirsiniz. Google Auth Platform not configured yet (Google Auth Platform henüz yapılandırılmadı) mesajını görürseniz Get Started'ı (Başlayın) tıklayın:

    1. Uygulama Bilgileri bölümündeki Uygulama adı alanına Chat MCP Server yazın.
    2. Kullanıcı destek 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, projenizle ilgili değişiklikler hakkında bilgilendirilebileceğ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 diğer yetkili test kullanıcılarını girip Kaydet'i tıklayın.

  3. Veri Erişimi > Kapsam Ekle veya Kaldır'ı tıklayın. Google Cloud projenizde etkinleştirdiğiniz her API için kapsam listesini içeren bir panel gösterilir.

    1. Kapsamları manuel olarak ekleyin bölümünde, Google Chat MCP sunucusunun kapsamlarını yapıştırın:

      • 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
      • https://www.googleapis.com/auth/chat.users.spacesettings

    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ırma

Google Chat uzaktan MCP sunucusunu MCP istemcinize eklemek için istemcinizin talimatlarını uygulayın.

Antigravity

Google Chat uzak MCP sunucusunu 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.

  1. OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:

    1. Google Cloud Console'da Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) gidin.

      İstemci Oluştur'a gidin

    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 ardından URI'ler alanına https://antigravity.google/oauth-callback değerini ekleyin.

    5. Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin.

    6. Create'i (Oluştur) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret (İstemci Gizli Anahtarı) değerlerinizi kopyalayın.

  2. ~/.gemini/config/mcp_config.json yapılandırma dosyasını açın veya oluşturun.

  3. mcpServers yapılandırmasını mcp_config.json hizmetine ekleyin:

    {
  "mcpServers": {
    "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ı.

  4. mcp_config.json tasarruf edin.

  5. MCP sunucusunun kimliğini doğrulayın. Kimlik doğrulama için GUI ayarlarını veya CLI'yı kullanabilirsiniz:

    • 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. Listede chat öğesini bulun, Authenticate'i (Kimlik doğrula) tıklayın, Google Hesabınızda oturum açın, yetkilendirme kodunu kopyalayın, giriş iletişim kutusuna yapıştırın ve Submit'i (Gönder) tıklayın.

    • Antigravity CLI için:

      1. Antigravity CLI'yı başlatma:

        agy

      2. Aşağıdaki komutu çalıştırarak etkileşimli MCP yönetim panelini açın:

        /mcp

      3. Ok tuşlarını kullanarak chat seçeneğini belirleyin, 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'a basın.

  6. Sunucunun 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ünde sunucunun yanında Oturumu kapat düğmesi gösterilir.
    • Antigravity CLI için: Yapılandırılmış MCP sunucularınızı görüntülemek için /mcp panelini açın. Doğrulanmış ve kimliği doğrulanmış sunucuların adlarının yanında, etkileşimli TUI panelinde Authed (Kimliği Doğrulandı) ifadesi gösterilir. Durumunu incelemek ve mevcut tüm araçlarını listelemek için kontrol paneli görünümünde herhangi bir sunucuyu seçebilirsiniz.

Uzak MCP sunucusu Antigravity'de kullanıma hazır.

Claude

Google Chat uzaktan MCP sunucusunu Claude.ai veya Claude Masaüstü ile kullanmak için Claude Enterprise, Pro, Max veya Team planınızın olması gerekir.

Google Chat uzaktan MCP sunucusunu Claude'a eklemek için OAuth istemci kimliği ve gizli anahtarı içeren özel bir bağlayıcı yapılandırın.

  1. OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:

    1. Google Cloud Console'da Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) gidin.

      İstemci Oluştur'a gidin

    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 ardından URI'ler alanına https://claude.ai/api/mcp/auth_callback değerini ekleyin.

    5. Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin.

    6. Create'i (Oluştur) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret (İstemci Gizli Anahtarı) değerlerinizi kopyalayın.

  2. 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. Google Chat ürünü için bağlantı ayrıntılarını girin:
      • Sunucu adı: Google Chat.
      • Uzak MCP sunucu URL'si: https://chatmcp.googleapis.com/mcp/v1
    4. Gelişmiş ayarlar'da OAuth istemci kimliğinizi ve OAuth istemci gizli anahtarınızı girin.
    5. Ekle'yi tıklayın.

Diğer

Birçok yapay zeka uygulamasında uzak MCP sunucusuna bağlanma yöntemleri vardır. Genellikle sunucuyla ilgili adı, uç noktaları, aktarım protokolü ve kimlik doğrulama yöntemi gibi bilgileri girmeniz gerekir. Google Chat uzak MCP sunucusu için aşağıdakileri girin:

  • Sunucu adı: chat

  • Sunucu URL'si: https://chatmcp.googleapis.com/mcp/v1

  • Aktarım: Akış yapılabilir HTTP

  • Kimlik doğrulama: Google Chat uzaktan MCP sunucusu, OAuth 2.0 kullanır. OAuth 2.0 istemcinizi oluştururken Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin. Ayrıntılar için Kimlik doğrulama ve yetkilendirme hakkında bilgi 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 Chat MCP sunucusunu 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:

  • "'X Projesi' alanındaki son mesaj neydi?"

    İstemci, search_conversations kullanarak alanı bulur ve ardından list_messages kullanarak mesajları alır.

Araçlar başarıyla yürütülür ve alakalı yanıtlar alırsanız Google Chat MCP sunucunuz doğru şekilde yapılandırılmıştır.

Sorun giderme

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

MCP sunucusuna gönderdiğiniz istekler reddedilirse OAuth 2.0 istemcinizin Google Auth Platform > Clients (İstemciler) bölümünde Use this client for an AI-powered agent (Bu istemciyi yapay zeka destekli bir temsilci için kullan) seçeneğinin belirlendiğinden emin olun. Mevcut bir OAuth istemcisinde bu ayarı değiştiremiyorsanız Bu istemciyi yapay zeka destekli bir temsilci için kullan seçeneğini belirleyerek yeni bir OAuth istemcisi oluşturun ve uygulamanızı bu istemciyi kullanacak şekilde güncelleyin. Mevcut bir OAuth istemcisi hem yapay zeka ajanı hem de ajan olmayan özellikler için kullanılıyorsa yapay zeka ajanı için ayrı bir OAuth istemcisi oluşturun ve mevcut istemciyi ajan olmayan özellikleriniz için kullanmaya devam edin. Talimatlar için MCP istemcinizi yapılandırma ve OAuth istemcilerini yönetme başlıklı makaleleri inceleyin.

Yaklaşık her saatte bir yeniden oturum açmanız isteniyorsa MCP istemciniz yenileme jetonu almıyor demektir. Google'ın yetkilendirme sunucusu, yenileme jetonlarını yalnızca yetkilendirme isteği access_type=offline içerdiğinde verir. Yalnızca OIDC offline_access kapsamını istemek yeterli değildir. MCP istemciniz özel yetkilendirme parametrelerini destekliyorsa yetkilendirme isteğine access_type=offline parametresini ekleyin. Daha önce erişim izni vermiş bir kullanıcı için yeni bir yenileme jetonu almak istiyorsanız prompt=consent parametresini de ekleyin.

Araç referansı

Google Chat MCP sunucusu için aşağıdaki araçlar kullanılabilir:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

Güvenlikle ilgili önemli bir husus: Dolaylı istem enjeksiyonu

Bir dil modelini güvenilmeyen verilere maruz bıraktığınızda dolaylı istem enjeksiyonu saldırısı riski ortaya çıkar. Google Antigravity gibi MCP ana makineleri, Google Chat MCP sunucusu üzerinden 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 istemleri ve yanıtları kötü amaçlı içerik veya istem enjeksiyonu saldırılarına karşı taramanız gerekir. Google tarafından sağlanan Model Armor'ı kullanabilir veya kullanıcıların bu riski kabul etmesi için belgelediğiniz kendi çözümünüzü kullanabilirsiniz. Daha fazla bilgi için Google Workspace MCP sunucuları için güvenlik ayarlarını yapılandırma başlıklı makaleyi inceleyin.

Aşağıdaki en iyi uygulamalardan yararlanın:

  • Yalnızca güvenilir araçları kullanın. Google Chat MCP sunucusunu hiçbir zaman güvenilir olmayan veya doğrulanmamış uygulamalara bağlamayın.
  • Güvenilmeyen girişlere karşı dikkatli olun. MCP istemcinizden doğrulanmamış kaynaklardan gelen mesajları veya diğer kaynakları işlemesini istemeyin. Bu girişler, oturumunuzu ele geçirebilecek gizli talimatlar içerebilir ve saldırganların verilerinizi değiştirmesine, çalmasına veya silmesine olanak tanıyabilir.
  • Tüm işlemleri inceleyin. Yapay zeka istemcinizin sizin adınıza gerçekleştirdiği işlemleri her zaman dikkatlice inceleyerek doğru olduklarından ve niyetinizle uyumlu olduklarından emin olun.