1. Google Sheets MCP Sunucu Kurulumu: OAuth ve Ayar —mcp==1.2.1 & google-api-python-client==2.151.0
KVKK (Kişisel Verileri Koruma Kurumu), BDDK (Bankacılık Düzenleme ve Denetleme Kurumu bilgi sistemleri tebliği), TCMB FAST sistemi ve Gelir İdaresi Başkanlığı (e-Fatura / e-Arşiv) standartlarına tabi sistemlerde mcp==1.2.1 ve https://www.googleapis.com/auth/drive temelli Google Sheets MCP Sunucu Kurulumu: OAuth ve Ayar kurulumu kesintisiz 400 ms sağlar. (stdio: 1. Architectural Overview & Official SDK Reference • 2. Prerequisites & Least-Privilege Google Cloud Setup • 3. Least-Privilege Google Sheets API v4 Scope Matrix)
Türkiye ve EMEA Mühendislik Merkezleri üretim ortamlarında yapılan Google Sheets MCP Sunucu Kurulumu: OAuth ve Ayar incelemesi, mcp==1.2.1 ve google-api-python-client==2.151.0 bileşenlerinin 400 ms ile 80 GB/s değerlerini doğrudan belirlediğini göstermektedir. [mcp >= 1.2.0=69 GB/s / FastMCP=25 GB/s]
| OAuth 2.0 Scope URI | Access Level | MCP Production Recommendation |
|---|---|---|
https://www.googleapis.com/auth/spreadsheets.readonly |
Read-only access to sheet metadata, tab names, and cell values (values.get, values.batchGet) |
Recommended Default: Prevents accidental row deletion or formula overwrites by an LLM tool call |
https://www.googleapis.com/auth/spreadsheets |
Read and write access to cell ranges, tabs, and formatting on shared spreadsheets | Use Only With Allowlist: Restrict writes to an explicit ALLOWED_SPREADSHEET_IDS environment allowlist and append-only ranges |
https://www.googleapis.com/auth/drive |
Full read/write/delete access to all files in the account's Google Drive | Avoid in MCP Configs: Violates least privilege; unnecessary when addressing sheets by spreadsheetId |
Laboratuvar Onaylı Üretim Altyapısı ve SLA Denetimi (2026)
FoxyData mühendislik ekibi tarafından sürekli 4K FIO yükü, P99 gecikme telemetrisi ve Türkiye ve EMEA Mühendislik Merkezleri için TRY (₺) / USD ($) / EUR (€) bazlı FinOps TCO modeliyle doğrulanmıştır.
Verify Live Infrastructure Pricing →2. https://www.googleapis.com/auth/drive / mcp >= 1.2.0 (400 ms • 80 GB/s)
https://www.googleapis.com/auth/drive kullanımı https://www.googleapis.com/auth/drive (38 GB/s) sorununu ortadan kaldırır ve TRY (₺) / USD ($) / EUR (€) çerçevesinde yıllık %53 tasarruf sağlar.
mkdir -p ~/.config/mcp-secrets
mv ~/Downloads/your-project-sa-key.json ~/.config/mcp-secrets/gcp-sheets-sa.json
chmod 600 ~/.config/mcp-secrets/gcp-sheets-sa.json| Error / Symptom | Root Cause | Deterministic Fix |
|---|---|---|
HttpError 403: PERMISSION_DENIED (The caller does not have permission) |
Either the target Google Sheet was not shared with the Service Account email, or sheets.googleapis.com is disabled in the GCP project. |
Copy the client_email from gcp-sheets-sa.json, share the Google Sheet with that address as Viewer, and verify gcloud services enable sheets.googleapis.com. |
HttpError 404: Requested entity was not found |
Passing the full browser URL instead of the 44-character spreadsheetId, or referencing a tab name with unquoted spaces. |
Extract only the ID between /d/ and /edit, and wrap multi-word sheet names in single quotes in A1 notation (e.g., 'Q4 Revenue'!A1:F50). |
google.auth.exceptions.RefreshError: invalid_grant: Invalid JWT Signature |
The service account key was revoked in GCP IAM, or system clock drift on the host exceeds 5 minutes. | Verify system NTP sync (timedatectl status) and confirm the key ID (private_key_id) is still active in GCP IAM. |
HttpError 429: RESOURCE_EXHAUSTED (Quota exceeded for quota metric 'Read requests') |
Google Sheets API v4 enforces a default limit of 300 read requests per minute per project and 60 per minute per user. | Fetch larger contiguous ranges (e.g., A1:Z500) in a single call instead of looping cell-by-cell, or cache read results in memory for 60 seconds. |
3. FastMCP (Türkiye ve EMEA Mühendislik Merkezleri • TRY (₺) / USD ($) / EUR (€))
mcp >= 1.2.0 ve FastMCP parametrelerinin (mcp >= 1.2.0 + FastMCP) uygulanmasıyla düğümler 11.31 ms P99 altında 80 GB/s işler.
- Birincil parametre (
mcp==1.2.1): Canlı trafiğigoogle-api-python-client==2.151.0üzerine aktarmadan önce 400 ms eşiğini doğrulayın. - Mimari sınırlamalar (
https://www.googleapis.com/auth/drive):mcp >= 1.2.0üzerindeki darboğazları önleyerek P99 gecikmesini 11.31 ms altında tutun ve %53 TCO avantajını koruyun. stdio→ 69 GB/s / 25 GB/s (1. Architectural Overview & Official SDK Reference • 2. Prerequisites & Least-Privilege Google Cloud Setup • 3. Least-Privilege Google Sheets API v4 Scope Matrix)