# Google Sheets MCP Server - Инструкции по установке
## Шаг 1: Создать проект в Google Cloud Console
1. Перейди на https://console.cloud.google.com/
2. Нажми на "Select a Project" → "NEW PROJECT"
3. Назови проект "google-sheets-mcp"
4. Жди создания проекта
## Шаг 2: Включить Google Sheets API
1. В консоли перейди на "APIs & Services" → "Library"
2. Поиск "Google Sheets API"
3. Нажми на результат и потом на кнопку "ENABLE"
4. Подожди включения API
## Шаг 3: Создать Service Account
1. Перейди на "APIs & Services" → "Credentials"
2. Нажми "+ CREATE CREDENTIALS" → "Service Account"
3. Заполни:
- Service account name: "google-sheets-mcp"
- Service account ID: (заполнится автоматически)
- Описание: "MCP server for Google Sheets"
4. Нажми "CREATE AND CONTINUE"
5. Пропусти дополнительные шаги, нажми "DONE"
## Шаг 4: Создать JSON ключ
1. На странице "Credentials" найди только что созданный Service Account
2. Нажми на email аккаунта
3. Перейди на вкладку "KEYS"
4. Нажми "ADD KEY" → "Create new key" → "JSON"
5. Скачается файл `key.json`
6. Переименуй его в `credentials.json`
7. Положи в папку `D:\google-sheets-mcp\`
## Шаг 5: Дать права доступа к своим таблицам
1. Открой свою Google Sheet
2. Нажми "Share" (Поделиться)
3. Скопируй email из `credentials.json` (это поле `client_email`)
4. Вставь этот email в поле "Add people and groups"
5. Дай права "Editor" (Редактор)
6. Нажми "Share"
## Шаг 6: Получить ID таблицы
ID таблицы находится в URL:
```
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit
^^^^^^^^^^^^^^
```
Скопируй этот ID - он понадобится при использовании инструментов.
## Запуск сервера
```bash
cd D:\google-sheets-mcp
npm start
```
Если все правильно настроено, увидишь:
```
✓ Google Sheets API initialized
Google Sheets MCP Server running on stdio
```
## Регистрация в 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"
```
## Использование в Claude
После регистрации, можешь использовать эти инструменты:
- **read_sheet** - читать данные из таблицы
- **write_sheet** - писать данные в таблицу
- **append_sheet** - добавлять данные в конец таблицы
- **get_metadata** - получить информацию о таблице (названия листов и т.д.)
- **clear_sheet** - очистить ячейки
Просто скажи Claude:
> "Прочитай данные из моей таблицы с ID: xxxxx в диапазоне A1:D10"
И Claude сам будет использовать инструменты!
