google-sheet-mcp 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/docs/quickstart-ru.md +91 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,6 +19,8 @@ Once configured, you can tell your AI agent:
|
|
|
19
19
|
|
|
20
20
|
## ⚡ Quick Start
|
|
21
21
|
|
|
22
|
+
> 🇷🇺 **Инструкция на русском:** [docs/quickstart-ru.md](docs/quickstart-ru.md) — пошагово для новичков.
|
|
23
|
+
|
|
22
24
|
Pick the auth method that fits your use case:
|
|
23
25
|
|
|
24
26
|
### Service Account (recommended for team/automation)
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
# 🚀 Быстрый старт (для новичков)
|
|
2
|
+
|
|
3
|
+
> Время: ~5 минут. Никаких специальных знаний не нужно.
|
|
4
|
+
|
|
5
|
+
## Шаг 1. Создать сервисный аккаунт Google
|
|
6
|
+
|
|
7
|
+
1. Открой [Google Cloud Console](https://console.cloud.google.com/)
|
|
8
|
+
2. Создай проект — кнопка в верхней панели, название любое
|
|
9
|
+
3. В левом меню: **APIs & Services** → **Library**
|
|
10
|
+
4. Найди **Google Sheets API** → нажми **Enable**
|
|
11
|
+
5. В левом меню: **Credentials** → **Create Credentials** → **Service Account**
|
|
12
|
+
6. Назови, например, `mcp-bot` → **Create** → **Done**
|
|
13
|
+
7. Нажми на созданный аккаунт → вкладка **Keys** → **Add Key** → **Create New Key** → **JSON**
|
|
14
|
+
8. Скачается файл `*.json` — сохрани, не теряй
|
|
15
|
+
9. Открой свою Google Таблицу → **Share** → вставь email из JSON (поле `client_email`) → дай права **Редактор**
|
|
16
|
+
|
|
17
|
+
> 📺 Нужен видео-гайд? Поищи на YouTube: [«Google Service Account create JSON key»](https://www.youtube.com/results?search_query=google+service+account+create+json+key)
|
|
18
|
+
|
|
19
|
+
## Шаг 2. Открыть терминал
|
|
20
|
+
|
|
21
|
+
| Система | Как открыть |
|
|
22
|
+
|---------|-------------|
|
|
23
|
+
| **Mac** | `Cmd + Пробел` → введи «Terminal» → `Enter` |
|
|
24
|
+
| **Windows** | `Win + R` → введи `cmd` → `Enter` |
|
|
25
|
+
| **Linux** | `Ctrl + Alt + T` |
|
|
26
|
+
|
|
27
|
+
## Шаг 3. Установить и настроить
|
|
28
|
+
|
|
29
|
+
В терминале одна команда:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
npx google-sheet-mcp init
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Мастер задаст два вопроса:
|
|
36
|
+
|
|
37
|
+
| Вопрос | Что ввести |
|
|
38
|
+
|--------|-----------|
|
|
39
|
+
| **Google Sheet URL** | Ссылку на таблицу — скопируй из адресной строки браузера |
|
|
40
|
+
| **Path to credentials JSON** | Путь к скачанному JSON-файлу — перетащи файл в окно терминала |
|
|
41
|
+
|
|
42
|
+
Готово! Настройки сохранятся в файл `.google-sheet-mcp.json`.
|
|
43
|
+
|
|
44
|
+
## Шаг 4. Подключить к IDE
|
|
45
|
+
|
|
46
|
+
Создай файл в папке своего проекта:
|
|
47
|
+
|
|
48
|
+
**Cursor** → файл `.cursor/mcp.json`:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"google-sheets": {
|
|
54
|
+
"command": "npx",
|
|
55
|
+
"args": ["google-sheet-mcp"]
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**VS Code / Copilot** → файл `.vscode/mcp.json`:
|
|
62
|
+
|
|
63
|
+
```json
|
|
64
|
+
{
|
|
65
|
+
"servers": {
|
|
66
|
+
"google-sheets": {
|
|
67
|
+
"type": "stdio",
|
|
68
|
+
"command": "npx",
|
|
69
|
+
"args": ["google-sheet-mcp"]
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Шаг 5. Перезапустить IDE
|
|
76
|
+
|
|
77
|
+
Закрой и открой редактор. Готово! 🎉
|
|
78
|
+
|
|
79
|
+
## Как проверить
|
|
80
|
+
|
|
81
|
+
Напиши AI-агенту в чате:
|
|
82
|
+
|
|
83
|
+
- «Прочитай все строки из листа Отчёты»
|
|
84
|
+
- «Добавь новую строку: имя=Иван, сумма=500»
|
|
85
|
+
- «Какие листы есть в моей таблице?»
|
|
86
|
+
|
|
87
|
+
## Если что-то пошло не так
|
|
88
|
+
|
|
89
|
+
1. Проверь, что Google Sheets API включён — [APIs & Services](https://console.cloud.google.com/apis/dashboard)
|
|
90
|
+
2. Проверь, что таблица расшарена на email сервисного аккаунта с правами **Редактор**
|
|
91
|
+
3. Выполни проверку: `npx google-sheet-mcp test`
|
package/package.json
CHANGED