Google Sheets MCP Server

# Чек-лист установки MCP сервера для Google Sheets ## Фаза 1: Google Cloud Console ☁️ - [ ] **1.1** Перейти на https://console.cloud.google.com/ - [ ] **1.2** Создать новый проект "google-sheets-mcp" - [ ] **1.3** Дождаться создания проекта (1-2 минуты) - [ ] **1.4** Убедиться что проект выбран (смотри название вверху) **Статус:** _______________ --- ## Фаза 2: API ⚙️ - [ ] **2.1** Перейти в "APIs & Services" → "Library" - [ ] **2.2** Найти "Google Sheets API" - [ ] **2.3** Нажать "ENABLE" - [ ] **2.4** Подождать включения (10-15 секунд) - [ ] **2.5** Видишь сообщение "Google Sheets API is now enabled" **Статус:** _______________ --- ## Фаза 3: Service Account 👤 - [ ] **3.1** Перейти в "APIs & Services" → "Credentials" - [ ] **3.2** Нажать "+ CREATE CREDENTIALS" → "Service Account" - [ ] **3.3** Заполнить: - [ ] Service account name: `google-sheets-mcp` - [ ] Description: `MCP server for Google Sheets` - [ ] **3.4** Нажать "CREATE AND CONTINUE" - [ ] **3.5** Пропустить доп. шаги (SKIP и DONE) **Статус:** _______________ --- ## Фаза 4: JSON ключ 🔑 - [ ] **4.1** На странице "Credentials" найти свой Service Account - [ ] **4.2** Найти строку с email `google-sheets-mcp@....iam.gserviceaccount.com` - [ ] **4.3** Нажать на email аккаунта - [ ] **4.4** Перейти на вкладку "KEYS" - [ ] **4.5** Нажать "+ ADD KEY" → "Create new key" - [ ] **4.6** Выбрать тип: "JSON" - [ ] **4.7** Нажать "CREATE" - [ ] **4.8** Дождаться скачивания файла **Скачанный файл:** _______________ (Обычно называется: google-sheets-mcp-xxxxx.json) **Статус:** _______________ --- ## Фаза 5: Переименование файла 📝 - [ ] **5.1** Открыть папку загрузок (обычно C:\Users\User\Downloads\) - [ ] **5.2** Найти скачанный файл (google-sheets-mcp-xxxxx.json) - [ ] **5.3** Нажать правой кнопкой → "Rename" - [ ] **5.4** Переименовать на: `credentials.json` - [ ] **5.5** Нажать Enter **Имя файла:** `credentials.json` ✓ **Статус:** _______________ --- ## Фаза 6: Перемещение файла 📂 - [ ] **6.1** Скопировать файл `credentials.json` - [ ] **6.2** Открыть папку `D:\google-sheets-mcp\` - [ ] **6.3** Вставить файл туда (Ctrl+V) - [ ] **6.4** Убедиться что файл находится: `D:\google-sheets-mcp\credentials.json` **Расположение файла:** `D:\google-sheets-mcp\credentials.json` ✓ **Статус:** _______________ --- ## Фаза 7: Проверка содержимого 🔍 - [ ] **7.1** Открыть файл `D:\google-sheets-mcp\credentials.json` в Notepad - [ ] **7.2** Убедиться что видишь JSON структуру - [ ] **7.3** Найти строку `"client_email": "google-sheets-mcp@...."` - [ ] **7.4** **Скопировать и сохранить этот email!** (понадобится на следующем шаге) **Service Account email:** `_________________________________` **Статус:** _______________ --- ## Фаза 8: Предоставление доступа к таблице 🗂️ - [ ] **8.1** Открыть свою Google Sheets таблицу - [ ] **8.2** Нажать кнопку "Share" вверху справа - [ ] **8.3** В поле "Add people and groups" вставить Service Account email: ``` google-sheets-mcp@....iam.gserviceaccount.com ``` - [ ] **8.4** Выбрать права: "Editor" (Редактор) - [ ] **8.5** Нажать "Share" - [ ] **8.6** Если появилось предупреждение - нажать "Share anyway" **Google Sheets ID (для справки):** ``` Из URL: https://docs.google.com/spreadsheets/d/ИДЕНТИФИКАТОР/edit ID: _________________________________ ``` **Статус:** _______________ --- ## Фаза 9: Регистрация в Claude Code 🔧 - [ ] **9.1** Открыть терминал/PowerShell - [ ] **9.2** Выполнить команду: ```bash claude mcp add --transport stdio google-sheets-mcp --env GOOGLE_CREDENTIALS_PATH="D:/google-sheets-mcp/credentials.json" -- node "D:/google-sheets-mcp/index.js" ``` - [ ] **9.3** Дождаться завершения команды - [ ] **9.4** Убедиться что нет ошибок **Статус:** _______________ --- ## Фаза 10: Проверка работы ✅ - [ ] **10.1** Открыть Claude Code - [ ] **10.2** Проверить что MCP сервер зарегистрирован: ```bash claude mcp list ``` - [ ] **10.3** Должен видеть `google-sheets-mcp` в списке **Статус:** _______________ --- ## Финал: Готово к использованию! 🎉 ``` ✓ Google Cloud проект создан ✓ Google Sheets API включен ✓ Service Account создан ✓ JSON ключ скачан и переименован ✓ credentials.json находится в нужном месте ✓ Сервис-аккаунт имеет доступ к таблице ✓ MCP сервер зарегистрирован в Claude Code ``` --- ## Тестирование MCP сервера Используй в Claude Code: ``` Прочитай данные из моей Google Sheets таблицы (ID: [вставь твой ID из фазы 8]) диапазон A1:D10 ``` Если работает - **ВСЁ ГОТОВО!** 🚀 --- ## Если что-то не получилось | Фаза | Проблема | Решение | |------|----------|--------| | 1 | Не видишь кнопку "Select a Project" | Обнови страницу или попробуй другой браузер | | 2 | Google Sheets API не включается | Подожди 1-2 минуты и обнови страницу | | 3 | Не вижу кнопку "CREATE CREDENTIALS" | Убедись что ты в "Credentials", а не в другом разделе | | 4 | Файл не скачивается | Проверь блокировщик pop-up, разреши скачивание | | 5 | Не вижу скачанный файл | Посмотри в папку Downloads (C:\Users\User\Downloads) | | 6 | Не могу переместить файл | Скопируй вместо перемещения | | 7 | JSON невалидный | Скачай credentials.json еще раз | | 8 | "Permission denied" при использовании | Подожди 5-10 минут пока права применятся | | 9 | Ошибка при регистрации сервера | Проверь что путь правильный: `D:/google-sheets-mcp/` | | 10 | MCP сервер не появился в списке | Перезагрузи Claude Code | --- **Дата начала:** ______________ **Дата завершения:** ______________ **Примечания:** ``` _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ ```