# Пошаговая настройка Google Cloud для MCP сервера
## Часть 1: Создание проекта в Google Cloud Console
### Шаг 1.1: Перейди на Google Cloud Console
1. Открой браузер и перейди на https://console.cloud.google.com/
2. Если тебя попросит вход - введи свой Google аккаунт
3. Если это первый раз - примени условия использования
### Шаг 1.2: Создай новый проект
1. В верхней левой части видишь "Google Cloud" и кнопку с названием проекта (или "Select a Project")
```
┌─────────────────────────────┐
│ Google Cloud │ [Select a Project] ▼
└─────────────────────────────┘
```
2. Нажми на "Select a Project" → откроется окно
3. В окне нажми кнопку "+ CREATE PROJECT" (синяя кнопка справа вверху)
4. Заполни форму:
```
Project name: google-sheets-mcp
Organization: (оставь по умолчанию или выбери свою)
```
5. Нажми "CREATE"
6. Подожди 1-2 минуты пока проект создастся. Внизу справа видишь прогресс.
**✓ Проект создан!**
---
## Часть 2: Включение Google Sheets API
### Шаг 2.1: Открой библиотеку API
1. После создания проекта, перейди в левое меню
2. Нажми на "APIs & Services" → "Library"
```
Меню слева:
├── APIs & Services
│ ├── Dashboard
│ ├── Enabled APIs & services
│ ├── Library ← ТЫ ЗДЕСЬ
│ └── ...
```
### Шаг 2.2: Найди Google Sheets API
1. Видишь поле поиска вверху: "Search for APIs & Services"
2. Введи: `google sheets`
3. Нажми Enter
4. Видишь результат "Google Sheets API"
5. Нажми на него
### Шаг 2.3: Включи API
1. Откроется страница Google Sheets API
2. Видишь большую синюю кнопку "ENABLE"
3. Нажми на неё
4. Подожди 10-15 секунд
5. Должна появиться синяя полоса "Google Sheets API is now enabled for your project"
**✓ Google Sheets API включен!**
---
## Часть 3: Создание Service Account
### Шаг 3.1: Перейди на Credentials (Учетные данные)
1. В левом меню нажми "APIs & Services" → "Credentials"
```
Меню слева:
├── APIs & Services
│ ├── Dashboard
│ ├── Enabled APIs & services
│ ├── Library
│ └── Credentials ← ТЫ ЗДЕСЬ
```
### Шаг 3.2: Создай Service Account
1. Видишь кнопку сверху "+ CREATE CREDENTIALS"
2. Нажми на неё → появится выпадающее меню
3. Выбери "Service Account" из меню
4. Откроется форма "Create service account". Заполни:
```
Service account name: google-sheets-mcp
Service account ID: (заполнится автоматически)
Description: MCP server for Google Sheets
```
5. Нажми "CREATE AND CONTINUE"
### Шаг 3.3: Пропусти дополнительные шаги
1. На странице "Grant this service account access to project":
- Это опционально
- Можешь оставить пустым или добавить базовую роль
- Нажми "CONTINUE" или "SKIP"
2. На странице "Grant users access to this service account":
- Это тоже опционально
- Нажми "DONE"
**✓ Service Account создан!**
---
## Часть 4: Создание JSON ключа
### Шаг 4.1: Найди свой Service Account
1. Перейди на "APIs & Services" → "Credentials"
2. Видишь таблицу с сервис-аккаунтами
3. Найди аккаунт "google-sheets-mcp" (тот что только что создал)
4. Нажми на его email (выглядит как `google-sheets-mcp@...iam.gserviceaccount.com`)
### Шаг 4.2: Перейди на вкладку KEYS
1. Откроется страница Service Account
2. Вверху видишь вкладки: "DETAILS", "PERMISSIONS", "KEYS" и т.д.
3. Нажми на вкладку "KEYS"
### Шаг 4.3: Создай новый ключ
1. Видишь кнопку "+ ADD KEY" → "Create new key"
2. Нажми на стрелку рядом и выбери "Create new key"
3. Откроется окно с вопросом какой тип ключа:
```
( ) RSA 1 (2048 bit)
(●) JSON ← ВЫБЕРИ ЭТО!
( ) PKCS12
```
4. Выбери JSON и нажми "CREATE"
5. Файл скачается автоматически (обычно в папку "Загрузки")
6. Скачанный файл называется что-то типа: `google-sheets-mcp-xxx.json`
**✓ JSON ключ скачан!**
---
## Часть 5: Переименование и перемещение файла
### Шаг 5.1: Найди скачанный файл
1. Открой папку где находятся загрузки:
- Обычно: `C:\Users\User\Downloads\`
2. Найди файл который выглядит как: `google-sheets-mcp-xxxxx.json`
### Шаг 5.2: Переименуй файл
1. Нажми правой кнопкой на файл
2. Выбери "Rename" (Переименовать)
3. Измени имя на: `credentials.json`
4. Нажми Enter
### Шаг 5.3: Переместить в папку проекта
1. Скопируй файл `credentials.json`
2. Перейди в папку: `D:\google-sheets-mcp\`
3. Вставь файл туда (Ctrl+V или правой кнопкой → Paste)
**✓ Файл credentials.json находится в D:\google-sheets-mcp\**
---
## Часть 6: Проверка содержимого credentials.json
### Шаг 6.1: Открой файл в текстовом редакторе
1. Нажми правой кнопкой на `credentials.json`
2. Выбери "Open with" → "Notepad" (или любой текстовый редактор)
3. Должен видеть JSON с такой структурой:
```json
{
"type": "service_account",
"project_id": "google-sheets-mcp-xxxxx",
"private_key_id": "xxxxx",
"private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
"client_email": "google-sheets-mcp@....iam.gserviceaccount.com",
"client_id": "xxxxx",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/..."
}
```
4. **Запомни или скопируй `client_email`** - это понадобится на следующем шаге!
5. Закрой файл
**✓ credentials.json валиден!**
---
## Часть 7: Даю доступ сервис-аккаунту к своим таблицам
### Шаг 7.1: Открой свою Google Sheets таблицу
1. Перейди на https://docs.google.com/spreadsheets/
2. Открой таблицу с которой хочешь работать через MCP сервер
3. Если таблицы нет - создай новую (кнопка "+" или File → New)
### Шаг 7.2: Поделись таблицей с сервис-аккаунтом
1. Вверху справа видишь кнопку "Share" (Поделиться)
2. Нажми на неё
3. Откроется диалог "Share with others"
4. В поле "Add people and groups" вставь email сервис-аккаунта:
```
Это email который ты нашел в credentials.json:
google-sheets-mcp@xxxx-xxxx.iam.gserviceaccount.com
```
5. Выбери права доступа: **"Editor"** (Редактор)
```
Выпадающее меню:
├── Viewer (Просмотрщик)
├── Commenter (Комментатор)
└── Editor (Редактор) ← ВЫБЕРИ ЭТО
```
6. Нажми "Share"
7. Может появиться предупреждение что это не аккаунт Google - это нормально!
8. Нажми "Share anyway" если появилось предупреждение
**✓ Сервис-аккаунт имеет доступ к таблице!**
---
## Часть 8: Получение ID таблицы
### Шаг 8.1: Скопируй ID из URL
1. Открыта твоя Google Sheets таблица
2. Посмотри на URL в адресной строке:
```
https://docs.google.com/spreadsheets/d/1A2B3C4D5E6F7G8H9I0J1K2L3M4N5O6P/edit#gid=0
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ЭТО - ID ТАБЛИЦЫ
```
3. Скопируй этот ID (от первого слеша до следующего слеша)
4. **Сохрани его где-то** - понадобится при использовании!
**✓ Готово!**
---
## Итоги
Теперь у тебя есть всё необходимое:
- ✅ Google Cloud проект создан
- ✅ Google Sheets API включен
- ✅ Service Account создан
- ✅ credentials.json скачан и находится в `D:\google-sheets-mcp\`
- ✅ Сервис-аккаунт имеет доступ к твоим таблицам
- ✅ Ты знаешь ID своей таблицы
---
## Следующий шаг
Теперь можешь:
1. Зарегистрировать MCP сервер в Claude Code:
```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"
```
2. Использовать инструменты в Claude:
```
Прочитай данные из моей Google Sheets таблицы (ID: 1A2B3C4D...) диапазон A1:D10
```
---
## Если что-то не получилось
### Ошибка: "Credentials file not found"
- Проверь что `credentials.json` точно находится в папке `D:\google-sheets-mcp\`
- Проверь что имя файла точно `credentials.json` (малые буквы)
### Ошибка: "Permission denied"
- Убедись что дал права доступа (Step 7)
- Убедись что это именно Service Account email, а не твой личный email
- Подожди 5-10 минут пока права применятся
### Ошибка: "Invalid credentials"
- Скачай credentials.json еще раз
- Убедись что в файле JSON правильный формат (открой в Notepad)
- Проверь что `private_key` не обрезан
### Google Cloud Console не открывается
- Попробуй другой браузер (Chrome, Firefox, Edge)
- Очисти cookies браузера
- Попробуй приватный режим браузера
### Не вижу кнопку "CREATE CREDENTIALS"
- Убедись что ты в разделе "Credentials"
- Убедись что выбран правильный проект (проверь имя вверху)
- Обнови страницу (F5)
---
## Дополнительная информация
### Что такое Service Account?
Service Account - это специальный аккаунт который используется приложениями и скриптами для работы с Google API. Это не обычный Google аккаунт.
- Нет пароля (используется JSON ключ)
- Может работать автоматически
- Можешь дать конкретные права
- Безопаснее чем использовать личный аккаунт
### Безопасность
⚠️ **ВАЖНО**: Не делись файлом `credentials.json` ни с кем!
- Этот файл содержит приватный ключ
- Любой кто имеет этот файл может получить доступ к твоим таблицам
- Не загружай его в Git/GitHub
- Не отправляй его по email
### Если скомпрометировал credentials.json
1. Перейди на https://console.cloud.google.com/
2. Найди свой Service Account
3. На вкладке "KEYS" удали скомпрометированный ключ
4. Создай новый JSON ключ
5. Замени старый `credentials.json` на новый
---
## Готово к использованию! 🎉
Если всё прошло успешно, переходи к следующему шагу - регистрации MCP сервера в Claude Code.
