Gmail MCP Sunucusu Entegrasyonu

“Gmail” MCP Sunucusu ne yapar?

Gmail MCP Sunucusu, Gmail işlevlerini Claude Desktop gibi AI platformlarına entegre etmek için tasarlanmış bir Model Context Protocol (MCP) sunucusudur. Temel rolü, AI asistanları ile Gmail arasında köprü işlevi görerek e-postaların doğal dilde yönetilmesini sağlar. Bu; e-posta gönderme ve okuma, etiket yönetimi, ekleri işleme, belirli mesajları arama ve toplu işlemler yapmayı içerir. Bu yetenekleri MCP aracı ve kaynağı olarak sunarak Gmail MCP Sunucusu, geliştiricilerin güçlü iş akışları oluşturmasına olanak tanır; böylece AI ajanları e-posta yönetimini otomatikleştirip kolaylaştırabilir, gelen kutularından bağlamsal veri çekebilir ve Gmail içeriğini programatik olarak işleyebilir. Tüm bunlar güvenli OAuth2 tabanlı kimlik doğrulama ile gerçekleşir.

İstem Listesi

Depoda veya dokümantasyonda açık bir istem şablonu bulunmamaktadır.

Kaynaklar Listesi

• E-posta Mesajları
  E-posta mesajlarını, LLM etkileşimlerinde bağlam olarak okunabilir ve kullanılabilir kaynaklar olarak sunar.

• Gmail Etiketleri
  E-postaların organize edilmesi veya alınması için sistem ve kullanıcı tanımlı Gmail etiketlerine erişim sağlar.

• Ekler Metadata
  E-posta ekleriyle ilgili dosya adı, tür ve boyut gibi bilgilerin alınmasını mümkün kılar.

• Arama Sonuçları
  Konu, gönderen veya tarih aralığına göre gelişmiş e-posta arama sonuçlarına erişim sağlar.

Araçlar Listesi

Dokümantasyonda listelenen özelliklere göre Gmail MCP Sunucusu şu araçları sağlar:

• send_email
  Konu, içerik, ekler ve alıcılarla e-posta gönderin; HTML ve uluslararası karakter desteği vardır.

• read_email
  ID ile e-posta mesajlarını alın; karmaşık MIME yapılarını destekler.

• list_labels
  Tüm mevcut Gmail etiketlerini (sistem ve kullanıcı tanımlı) listeleyin.

• manage_labels
  Kapsamlı etiket yönetimi için etiket oluşturun, güncelleyin, silin ve listeleyin.

• search_emails
  Konu, gönderen, tarih aralığı gibi çeşitli kriterlerle e-posta arayın.

• list_emails_by_label
  Gelen kutusu, gönderilen veya özel etiketlerdeki e-postaları listeleyin.

• mark_read_unread
  E-postaları okundu/okunmadı olarak işaretleyin.

• move_email
  E-postaları farklı etiketlere/klasörlere taşıyın.

• delete_email
  E-postaları posta kutusundan silin.

• batch_operations
  Birden fazla e-postayı verimli şekilde toplu olarak işleyin.

Bu MCP Sunucusunun Kullanım Senaryoları

• Otomatik E-posta Gönderimi
  Geliştiriciler, AI ajanlarının otomatik olarak e-posta hazırlayıp göndermesini sağlayan iş akışları kurabilir; böylece rutin iletişimlerde manuel iş yükü azalır.

• Gelen Kutusu Önceliklendirme ve Yönetimi
  AI asistanları, e-postaları kategorize edebilir, etiketleyebilir ve uygun klasörlere taşıyabilir; böylece kullanıcıların gelen kutularını düzenli tutmasına ve önemli mesajları önceliklendirmesine yardımcı olur.

• E-posta Arama ve Getirme
  Gelişmiş arama kriterleriyle kullanıcılar, belirli mesaj ya da ekleri hızla bulabilir; Gmail hesaplarından bilgi alma sürecini kolaylaştırır.

• Toplu İşlem
  Yüksek hacimli kullanıcılar için e-postaları silme, okundu/okunmadı yapma veya taşıma gibi toplu işlemler otomatikleştirilebilir ve zaman kazandırır.

• Etiket Yönetimi Otomasyonu
  AI, Gmail etiketlerini dinamik olarak oluşturabilir, güncelleyebilir veya silebilir; böylece değişen kullanıcı ihtiyaçlarına veya proje gereksinimlerine göre uyarlanabilir organizasyon stratejileri uygulanır.

Kurulum

Windsurf

1. Node.js gibi ön gereksinimlerin kurulu olduğundan emin olun.
2. Windsurf yapılandırma dosyasını açın (genellikle windsurf.json veya benzeri).
3. Gmail MCP Sunucusu paketini ekleyin:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve Windsurf’ü yeniden başlatın.
5. MCP sunucusunun Windsurf panelinde listelendiğini kontrol ederek kurulumu doğrulayın.

API Anahtarlarını Güvenceye Alma Örneği:

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude

1. Node.js ve Claude platformunun kurulu olduğundan emin olun.
2. Claude MCP yapılandırma dosyasını düzenleyin.
3. Gmail MCP Sunucusunu ekleyin:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve Claude’u yeniden başlatın.
5. Sunucunun Claude içinde aktif olduğunu doğrulayın.

Ortam Değişkeni Örneği:

{
  "env": {
    "GOOGLE_CLIENT_ID": "your-client-id",
    "GOOGLE_CLIENT_SECRET": "your-client-secret"
  }
}

Cursor

1. Node.js’i kurun ve Cursor’ın çalıştığından emin olun.
2. Gmail MCP Sunucusunu içerecek şekilde Cursor yapılandırmasını güncelleyin:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. Değişikliklerin etkili olması için Cursor’ı yeniden başlatın.
4. Kullanılabilir MCP sunucularını kontrol ederek entegrasyonu doğrulayın.

Cline

1. Ortamınızı Node.js ile hazırlayın.
2. Gmail MCP Sunucusu girişini Cline yapılandırmasına ekleyin:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. Kaydedin ve Cline’ı yeniden başlatın.
4. Gmail MCP Sunucusunun arayüzde tanındığını kontrol edin.

Not:
Hassas API anahtarları veya kimlik bilgilerinizi her zaman ortam değişkeni olarak saklayın, yapılandırma dosyalarına doğrudan yazmayın. Kimlik bilgilerini güvenle aktarmak için MCP sunucu yapılandırmanızda env özelliğini kullanın.

Bu MCP’yi iş akışlarında nasıl kullanabilirsiniz

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, önce MCP bileşenini akışınıza ekleyin ve AI ajanınızla bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırma bölümüne, MCP sunucu bilgilerinizi şu JSON formatında girin:

{
  "gmail-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırmadan sonra AI ajanı artık tüm işlevlere ve yeteneklere erişimi olan bu MCP’yi bir araç olarak kullanabilir. “gmail-mcp” adını kendi MCP sunucunuzun gerçek adıyla ve URL’yi kendi MCP sunucu adresinizle değiştirmeniz gerektiğini unutmayın.

Genel Bakış

Mevcut dokümantasyona göre, Gmail MCP Sunucusu Gmail iş akışı otomasyonu ve entegrasyonu için iyi özelliklere sahip; ancak açık istem şablonları ve örnekleme/kök desteği dokümantasyonu eksik. Güvenlik yönetimi ve araç/kaynak sunumu güçlü; bu nedenle bu MCP’yi 10 üzerinden 7.5 olarak geliştirici hazır bulunuşluğu açısından derecelendiriyorum.

MCP Puanı