Google Sheets MCP Sunucusu

“Google Sheets” MCP Sunucusu ne yapar?

Google Sheets MCP (Model Context Protocol) Sunucusu, AI asistanlarının Google Sheets ile iyi tanımlanmış, tipli araçlar aracılığıyla güvenli şekilde etkileşime geçmesini sağlayan TypeScript tabanlı bir araçtır. AI ajanları ile Google Sheets/Drive API arasında köprü görevi görerek sağlam otomasyon ve veri işleme iş akışları sunar. Sunucu hem OAuth2 hem de Servis Hesabı kimlik doğrulamasını destekler, bu da farklı güvenlik gereksinimleri için esneklik sağlar. Ana rolü, geliştiricilere ve AI iş akışlarına programatik ve güvenli bir şekilde tablo oluşturma, hücre verileri okuma-yazma, sayfa ve sekme yönetimi ile belge paylaşımı gibi görevleri yerine getirme olanağı tanımaktır. Bu entegrasyon, Google Sheets içinde veritabanı tarzı sorgulamalar, iş birliğine dayalı düzenleme ve iş akışı otomasyonunu kolaylaştırarak üretkenliği ve AI tabanlı geliştirme süreçlerini güçlendirir.

Prompt Listesi

Depoda açıkça belgelenmiş prompt şablonları yok.

Kaynak Listesi

Depoda açıkça belgelenmiş kaynak yok.

Araç Listesi

• create
  Yeni bir tablo oluşturur ve isteğe bağlı olarak belirtilen bir Drive klasörüne taşır.
• listSheets
  Belirtilen bir tabloda tüm sayfa sekmelerini listeler.
• renameSheet
  Mevcut bir sayfa sekmesinin adını değiştirir.
• createSheet
  Bir tabloya yeni bir sayfa sekmesi ekler.
• spreadsheetInfo
  Bir tablonun metadata’sını (başlık, sayfa kimlikleri, grid özellikleri) getirir.
• listSpreadsheets
  Yapılandırılmış Drive klasörünüzdeki veya My Drive’daki tüm tabloları listeler.
• shareSpreadsheet
  Bir tabloyu kullanıcılara (okuyucu/yorumlayıcı/yazıcı) paylaşır ve bildirim gönderir.
• sheetData
  Bir sayfadaki ve aralıktaki (veya tüm sayfanın) hücre değerlerini okur.
• updateCells
  A1 tarzı bir aralığa 2 boyutlu bir değer dizisi yazar.
• batchUpdate
  Tek bir istekte birden fazla aralık güncellemesi uygular.
• addRows / addColumns
  Belirtilen bir indeks konumunda satır veya sütun ekler.
• copySheet
  Sayfa sekmesini tablolar arasında kopyalar, yeniden adlandırma seçeneğiyle.

Bu MCP Sunucusunun Kullanım Senaryoları

• Otomatik Tablo Oluşturma ve Yönetimi
  Tamamen otomatik iş akışları aracılığıyla yeni tablolar oluşturun, sayfa/sekme ekleyin veya yeniden adlandırın ve dosyaları Google Drive içinde organize edin.
• Veri Çıkarımı ve Güncelleme
  Google Sheets’ten/birçok veriyi okuyun ve yazın; ETL boru hatları, raporlama ve gösterge paneli otomasyonu için idealdir.
• İş Birlikçi Erişim ve Paylaşım
  Tabloları programatik olarak farklı kullanıcılarla paylaşın ve izinler atayın; ekip iş birliğini ve otomatik bildirimleri kolaylaştırır.
• Toplu İşlemler ve Veri Manipülasyonu
  Toplu güncellemeler yapın, birden fazla satır/sütun ekleyin ve büyük sayfalarda değişiklikleri verimli şekilde uygulayın; tekrarlayan işler için zaman kazandırır.
• Sayfa Kopyalama ve Organizasyon
  Takım içinde ölçeklenebilir işlemleri destekleyerek şablonlama, yedekleme veya organizasyon iş akışları için sayfaları tablolar arasında kopyalayın.

Nasıl Kurulur

Windsurf

1. Bun (v1.0+) yüklü olduğundan ve Google Cloud kimlik bilgilerinizi (OAuth2 veya Servis Hesabı) ayarladığınızdan emin olun.
2. Depoyu klonlayıp bağımlılıkları yükleyin:
   git clone https://github.com/rohans2/mcp-google-sheets.git
cd mcp-google-sheets
bun install
3. Aşağıda gösterildiği gibi ortam değişkenlerini yapılandırın.
4. Windsurf yapılandırma dosyanıza MCP sunucusunu bir JSON kesitiyle ekleyin.
5. Yapılandırmanızı kaydedin ve Windsurf’ü yeniden başlatın.

Örnek JSON yapılandırması:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

API anahtarlarını ortam değişkenleriyle güvence altına alma:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Claude

1. Ön koşulları yükleyin ve depoyu klonlayın.
2. Google Cloud kimlik doğrulamasını ve ortam değişkenlerini ayarlayın.
3. Claude’un MCP yapılandırma dosyasını bulun ve düzenleyin.
4. Google Sheets MCP sunucusunu yapılandırma kesitiyle ekleyin.
5. Claude’u yeniden başlatın ve bağlantıyı doğrulayın.

Örnek JSON yapılandırması:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cursor

1. Bun yüklü olduğundan ve kimlik bilgilerinizin yapılandırıldığından emin olun.
2. Depoyu indirin ve kurun.
3. Cursor MCP yapılandırma dosyasını düzenleyin.
4. Google Sheets MCP sunucusu kaydını ekleyin.
5. Değişiklikleri kaydedin ve sunucuyu etkinleştirmek için Cursor’ı yeniden başlatın.

Örnek JSON yapılandırması:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cline

1. Bun’u yükleyin ve Google Cloud proje kimlik bilgilerinizi ayarlayın.
2. Depoyu klonlayın ve tüm gerekli bağımlılıkları yükleyin.
3. Cline’ın MCP sunucu yapılandırmasına erişin ve düzenleyin.
4. Google Sheets MCP sunucusunu JSON formatı ile kaydedin.
5. Yapılandırmanın uygulanması için Cline’ı yeniden başlatın.

Örnek JSON yapılandırması:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

API anahtarlarını ortam değişkenleriyle güvenli hale getirme:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Bu MCP’yi iş akışlarında nasıl kullanırsınız

FlowHunt’ta MCP kullanımı

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

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

{
  "google-sheets": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandıktan sonra, AI ajanı bu MCP’yi bir araç olarak tüm fonksiyon ve yetenekleriyle kullanabilir. “google-sheets” adını kendi MCP sunucunuzun adıyla, URL’yi ise kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Bizim görüşümüz

Bu MCP sunucusu, kurulum için iyi dokümante edilmiş ve Google Sheets otomasyonu için güçlü bir araç seti sunuyor. Ancak, açık MCP prompt şablonları ve kaynakları eksik, ayrıca sampling veya kök desteğinden bahsedilmiyor. Güçlü araç kapsamı ve net güvenlik rehberliği ile tablo otomasyonu için değerli; ancak prompt/kaynak dokümantasyonu ve sampling/kök desteği açıklamaları eklenirse daha da geliştirilebilir.

MCP Puanı