Takvim MCP sunucusunu yapılandırın

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

Google Takvim MCP sunucusu, yapay zeka ajanlarının şunları yapması için standart bir yol sağlar:

  • Verileri okuma: Takvimleri listeleme, etkinlikleri alma ve müsaitlik durumunu kontrol etme.
  • Harekete geçin: Etkinlik oluşturma, güncelleme ve silme
  • 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 Takvim MCP sunucusunu yapılandırma

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

API'leri etkinleştirme

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

  • Google Calendar API

KSA

gcloud services enable calendar-json.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

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

  • Google Calendar MCP API

KSA

gcloud services enable calendarmcp.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

Google Takvim MCP sunucusu, 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.

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

    Markalama'ya gidin.

  2. Google Auth Platform'u daha önce 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ürseniz Başlayın'ı tıklayın:

    1. App Information (Uygulama Bilgileri) bölümündeki App name (Uygulama adı) alanına Calendar 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, 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.

  3. 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 ekle bölümünde, Google Takvim MCP sunucusunun kapsamlarını yapıştırın:

      • https://www.googleapis.com/auth/calendar.calendarlist.readonly
      • https://www.googleapis.com/auth/calendar.events.freebusy
      • https://www.googleapis.com/auth/calendar.events.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 Takvim uzaktan MCP sunucusunu MCP istemcinize eklemek için istemcinize yönelik talimatları uygulayın.

Antigravity

Google Takvim uzaktan 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 > 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.

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

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

    {
  "mcpServers": {
    "calendar": {
      "serverUrl": "https://calendarmcp.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. GUI ayarlarını veya CLI'yı kullanarak kimlik doğrulaması 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. Listede calendar simgesini bulun, Authenticate'i (Kimlik doğrulama) 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şlatın:

        agy

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

        /mcp

      3. Ok tuşlarını kullanarak calendar simgesini seçin, 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.

  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 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ünde sunucuyu seçebilirsiniz.

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

Claude

Claude.ai veya Claude Desktop ile Google Takvim'in uzaktan MCP sunucusunu kullanmak için Claude Enterprise, Pro, Max veya Team planına sahip olmanız gerekir.

Google Takvim uzak MCP sunucusunu Claude'a eklemek için OAuth istemci kimliği ve gizli anahtarıyla ö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 > 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://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.

  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 Takvim ürünü için bağlantı ayrıntılarını girin:
      • Sunucu adı: Google Calendar.
      • Uzak MCP sunucu URL'si: https://calendarmcp.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.

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 Takvim uzak MCP sunucusu için aşağıdakileri girin:

  • Sunucu adı: calendar

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

  • Taşıma: HTTP

  • Kimlik doğrulama: Google Takvim'in 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 Takvim 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:

  • "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 Takvim 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üklerinde hataları kontrol edebilirsiniz. Yöneticinizden güvenlik incelemesi aracındaki OAuth günlüğü etkinliklerini kontrol etmesini isteyin.

Araç referansı

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

  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • suggest_time
  • update_event

Ö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 Takvim 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 aşağıdaki en iyi uygulamaları izleyin:

  • Yalnızca güvenilir araçları kullanın. Google Takvim MCP sunucusunu 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 etkinlikleri 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.