Gmail MCP Server Kurulum Rehberi Claude Desktop

Gmail MCP Server Kurulum Rehberi - Claude Desktop

Bu rehber, Claude Desktop uygulamasına Gmail MCP (Model Context Protocol) server kurulumu için detaylı adım adım talimatları içerir. Bu kurulum sayesinde Claude ile Gmail hesabınıza doğal dil komutları ile erişebilir, email gönderebilir, arayabilir ve yönetebilirsiniz.

📋 Genel Bakış

MCP (Model Context Protocol) nedir? MCP, AI asistanlarının dış kaynaklara güvenli bir şekilde bağlanmasını sağlayan bir protokoldür. Düşünün ki Claude ile Gmail arasında güvenli bir köprü kuruyoruz - Claude artık emaillerinizi okuyabilir, gönderebilir ve yönetebilir.

Bu kurulum sonunda neler yapabileceksiniz?

• Gmail hesabınızdaki emailları listele ve ara
• Yeni email gönder (ek dosya desteği ile)
• Email etiketlerini yönet
• Toplu email işlemleri yap
• Email filtrelerini oluştur ve yönet
• Ek dosyaları indir

🛠️ Gereksinimler

• İşletim Sistemi: Windows 10/11
• Claude Desktop: En son sürüm kurulu
• Node.js: Sistem PATH'inde erişilebilir
• Google Account: Gmail erişimi olan
• İnternet Bağlantısı: Kurulum ve kimlik doğrulama için

📚 Adım 1: Google Cloud Project Kurulumu

1.1 Google Cloud Console'a Erişim

1. Google Cloud Console adresine gidin
2. Google hesabınızla giriş yapın
3. Yeni bir proje oluşturun veya mevcut bir projeyi seçin

1.2 Gmail API'yi Etkinleştirme

1. APIs & Services > Library menüsüne gidin
2. Arama çubuğuna "Gmail API" yazın
3. Gmail API'yi bulun ve tıklayın
4. "Enable" butonuna tıklayın
5. API'nin etkinleşmesini bekleyin (birkaç dakika sürebilir)

1.3 OAuth 2.0 Credentials Oluşturma

1. APIs & Services > Credentials menüsüne gidin
2. "Create Credentials" > "OAuth client ID" seçin
3. "Desktop application" seçeneğini seçin
4. Uygulamanıza bir ad verin (örn: "Gmail MCP Server")
5. "Create" butonuna tıklayın
6. JSON dosyasını indirin
7. İndirilen dosyayı gcp-oauth.keys.json olarak yeniden adlandırın

⚠️ Önemli: JSON dosyasının ismini tam olarak gcp-oauth.keys.json yapın. Dosya adı büyük/küçük harfe duyarlıdır.

🔧 Adım 2: MCP Server Kurulumu

2.1 Otomatik Kurulum (Önerilen)

PowerShell'i yönetici olarak açın ve şu komutu çalıştırın:

npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

Kurulum sırasında:

• Anonim kullanım verileri gönderme konusunda soru gelecek (Y/n)
• İsterseniz "Y" diyerek projeyi destekleyebilirsiniz
• Başarılı kurulum mesajını bekleyin

2.2 Authentication Klasörü Hazırlama

# Gmail MCP için özel klasör oluşturun
mkdir "$env:USERPROFILE\.gmail-mcp"

# OAuth keys dosyasını doğru konuma kopyalayın
copy "gcp-oauth.keys.json" "$env:USERPROFILE\.gmail-mcp\"

# Dosyanın doğru kopyalandığını kontrol edin
dir "$env:USERPROFILE\.gmail-mcp\"

2.3 Google Authentication

npx @gongrzhe/server-gmail-autoauth-mcp auth

Bu komut:

• Tarayıcınızda Google kimlik doğrulama sayfasını açar
• Gmail erişim izinlerini ister
• Başarılı olursa credentials.json dosyasını oluşturur
• "Authentication completed successfully" mesajını gösterir

💡 İpucu: Eğer "Port 3000 already in use" hatası alırsanız, o portu kullanan uygulamayı kapatın.

⚙️ Adım 3: Claude Desktop Yapılandırması

3.1 Config Dosyasını Bulma

Claude Desktop config dosyası şu konumda: %APPDATA%\Claude\claude_desktop_config.json

3.2 Config Dosyasını Düzenleme

PowerShell ile config dosyasını açın:

notepad "$env:APPDATA\Claude\claude_desktop_config.json"

3.3 Doğru Config İçeriği

Config dosyanız şöyle olmalı:

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

Eğer başka MCP serverlarınız varsa:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem"
      ],
      "env": {
        "ALLOWED_DIRECTORIES": "C:\\Users\\YOURUSERNAME"
      }
    },
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

3.4 Claude Desktop'ı Yeniden Başlatma

1. Claude Desktop uygulamasını tamamen kapatın
2. Birkaç saniye bekleyin
3. Claude Desktop'ı yeniden açın

🧪 Adım 4: Test ve Doğrulama

4.1 Temel Testler

Claude Desktop'ta şu komutları deneyin:

Gmail profilimi göster

Gmail'deki son 5 emailimi listele

Gmail etiketlerimi listele

4.2 İleri Seviye Testler

Bugün gelen emailleri göster

"password" içeren emailleri ara

Kendime test emaili gönder, konusu "MCP Server Test" olsun

🚨 Sorun Giderme

Problem 1: "Gmail API has not been used" Hatası

Hata: Gmail API has not been used in project [ID] before or it is disabled

Çözüm:

1. Google Cloud Console'da Gmail API'nin etkinleştirildiğinden emin olun
2. 5-10 dakika bekleyin (API propagation süresi)
3. Tekrar deneyin

Problem 2: "Unexpected token" JSON Hataları

Hata: MCP server JSON parsing hataları

Çözüm:

1. Config dosyasında çakışan server tanımları olup olmadığını kontrol edin
2. Aynı servisten iki farklı kurulum varsa birini silin
3. Config dosyasının JSON syntax'ının doğru olduğundan emin olun

Problem 3: "Port 3000 already in use"

Hata: Authentication sırasında port çakışması

Çözüm:

# 3000 portunu kullanan işlemi bulun
netstat -ano | findstr :3000

# İşlemi sonlandırın (PID numarasını kullanarak)
taskkill /PID 
 /F

Problem 4: Authentication Failure

Çözüm:

1. ~\.gmail-mcp\ klasöründeki dosyaları silin
2. OAuth keys dosyasını tekrar kopyalayın
3. Authentication işlemini tekrar yapın

🔒 Güvenlik Notları

Credentials Güvenliği

• OAuth credentials'lar ~\.gmail-mcp\ klasöründe güvenli şekilde saklanır
• Bu dosyaları hiçbir zaman paylaşmayın veya version control'e eklemeyin
• Düzenli olarak Google Account ayarlarınızdan erişimleri gözden geçirin

İzinler

MCP server şu izinleri talep eder:

• Gmail.modify: Email okuma, yazma, silme
• Gmail.settings.basic: Temel ayarlara erişim

📊 Kullanılabilir Özellikler

Email Yönetimi

• ✅ Email gönderme (metin/HTML/multipart)
• ✅ Email okuma ve listeleme
• ✅ Email arama (Gmail syntax desteği)
• ✅ Email silme
• ✅ Ek dosya gönderme ve indirme

Etiket Yönetimi

• ✅ Etiket oluşturma, güncelleme, silme
• ✅ Emaillere etiket ekleme/çıkarma
• ✅ Toplu etiket işlemleri

Filtreleme

• ✅ Gmail filtresi oluşturma
• ✅ Önceden tanımlı filter şablonları
• ✅ Gelişmiş filtreleme kriterleri

Toplu İşlemler

• ✅ Çoklu email silme
• ✅ Toplu etiketleme
• ✅ Batch processing (50 email'e kadar)

🎯 Kullanım Örnekleri

Basit Email Gönderme

john@example.com adresine "Toplantı Hatırlatması" konulu email gönder

Gelişmiş Arama

Son 1 ayda gelen, ek dosyalı emailleri listele

Toplu İşlem

"newsletter" etiketli tüm emailleri sil

Otomasyon

GitHub'dan gelen tüm emailleri "Development" etiketiyle otomatik etiketle

🔄 Güncelleme ve Bakım

Server Güncelleme

npx @gongrzhe/server-gmail-autoauth-mcp@latest auth

Credentials Yenileme

Eğer authentication sorunları yaşarsanız:

# Mevcut credentials'ları silin
del "$env:USERPROFILE\.gmail-mcp\credentials.json"

# Yeniden authentication yapın
npx @gongrzhe/server-gmail-autoauth-mcp auth

🤝 Destek ve Kaynak

• GitHub Repository: Gmail MCP Server
• MCP Documentation: Model Context Protocol
• Smithery Platform: Smithery.ai

📝 Son Notlar

Bu kurulum rehberi, pratik deneyim sonucu oluşturulmuştur. Gmail MCP Server, email yönetimi ve otomasyon için güçlü bir araçtır. Özellikle yapay zeka mühendisleri ve geliştiriciler için email verileriyle çalışma konusunda büyük kolaylık sağlar.

Kurulum tamamlandıktan sonra Claude Desktop üzerinden Gmail hesabınızı doğal dil komutlarıyla yönetebilir, email gönderip alabilir, otomatik filtreleme sistemleri kurabilirsiniz.

Başarılı kurulum sonrası Claude artık email asistanınız! 🚀

*Bu rehber, Windows 10/11 ortamında test edilmiş ve doğrulanmıştır. Farklı işletim sistemleri için adımlar değişiklik gösterebilir.*