Google Sheets MCP Server

# 🚀 НАЧНИ ОТСЮДА Добро пожаловать! Здесь находится MCP сервер для Google Sheets, который позволит Claude читать и писать данные в твои Google таблицы напрямую. --- ## 📚 Выбери свой путь ### 🏃‍♂️ Я в спешке! (5 минут) → Открой **`QUICK_START.md`** - Краткая версия всех шагов - Минимум информации - Максимум скорости ### 📖 Дай мне пошагово (20 минут) → Открой **`GOOGLE_CLOUD_SETUP.md`** - Подробное руководство - Объяснение каждого шага - Решение проблем - Скрин-шоты в описании ### ✅ Я люблю чек-листы (10 минут) → Открой **`CHECKLIST.md`** - Интерактивный чек-лист - Отмечай выполненное - Быстрая навигация - Таблица проблем ### 📚 Дай мне всю информацию → Открой **`README.md`** - Полная документация - Все инструменты - Примеры использования - Лимиты и ограничения --- ## 🎯 План действий ### Шаг 1: Настройка Google (одноразово) Выбери один из документов выше и следуй инструкциям: 1. Создай проект в Google Cloud Console 2. Включи Google Sheets API 3. Создай Service Account 4. Скачай JSON ключ → переименуй в `credentials.json` 5. Положи `credentials.json` в папку `D:\google-sheets-mcp\` 6. Дай доступ сервис-аккаунту к своим таблицам ### Шаг 2: Регистрируй сервер в 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" ``` ### Шаг 3: Используй в Claude! 🎉 Просто напиши: ``` Прочитай данные из моей Google Sheets таблицы (ID: xxxxx) диапазон A1:D10 ``` И Claude сам будет использовать инструменты! --- ## 📂 Содержимое папки ``` google-sheets-mcp/ │ ├── START_HERE.md ← ТЫ ЗДЕСЬ │ ├── 📖 ДОКУМЕНТАЦИЯ: │ ├── QUICK_START.md (5 мин, быстро) │ ├── GOOGLE_CLOUD_SETUP.md (20 мин, подробно) │ ├── CHECKLIST.md (чек-лист) │ ├── README.md (полная документация) │ ├── SETUP.md (основная инструкция) │ └── .env.example (переменные окружения) │ ├── 💻 КОД: │ ├── index.js (главный файл сервера) │ ├── package.json (зависимости Node.js) │ └── node_modules/ (установленные пакеты) │ └── 🔐 КОНФИГ (после настройки): └── credentials.json (ТЫ ДОЛЖЕН СКАЧАТЬ И ПОЛОЖИТЬ СЮДА) ``` --- ## ⚡ Самые частые вопросы **Q: Где скачать credentials.json?** A: Создай Service Account в Google Cloud Console (смотри GOOGLE_CLOUD_SETUP.md шаг 4) **Q: Куда положить credentials.json?** A: В папку `D:\google-sheets-mcp\` рядом с `index.js` **Q: Как получить ID таблицы?** A: Из URL таблицы: `https://docs.google.com/spreadsheets/d/ВОТ_ЭТОТ_ID/edit` **Q: Не работает - что делать?** A: Смотри раздел "Решение проблем" в GOOGLE_CLOUD_SETUP.md **Q: Нужна помощь?** A: Спроси меня напрямую - помогу отладить! --- ## 🔐 Безопасность ⚠️ **ВАЖНО**: Файл `credentials.json` содержит приватный ключ! ``` ✓ ДЕЛАЙ: - Храни его безопасно - Добавь в .gitignore если используешь Git - Никому не показывай ✗ НЕ ДЕЛАЙ: - Не отправляй по email - Не загружай на GitHub - Не делись с кем-то ``` --- ## 🚀 Быстрый старт Если ты уже знаешь что делаешь: ```bash # 1. Google Cloud Setup (смотри QUICK_START.md) # Должен быть файл: D:\google-sheets-mcp\credentials.json # 2. Регистрируй сервер 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" # 3. Проверь что работает claude mcp list # 4. Используй! # "Прочитай данные из моей Google Sheets (ID: ...) диапазон A1:D10" ``` --- ## 📊 Что можно делать с MCP сервером ✅ Читать данные из таблиц ✅ Писать данные в таблицы ✅ Добавлять новые строки ✅ Очищать ячейки ✅ Получать информацию о листах 🚀 Это полностью решает твою проблему с GAS! Теперь Claude видит результаты скриптов в реальном времени. --- ## 🎓 Готов начать? 1. **Выбери документ выше** (QUICK_START.md или GOOGLE_CLOUD_SETUP.md) 2. **Следуй инструкциям** (все очень просто) 3. **Зарегистрируй сервер** (одна команда) 4. **Используй в Claude!** (профит 🎉) --- ## ✨ Что дальше? После настройки: - Читай и пиши в таблицы через Claude - Используй для мониторинга GAS скриптов - Логируй результаты выполнения - Быстро отлаживай код **Вопросы? Спроси меня!** Я помогу настроить. --- **Создано специально для твоих Google Apps Script проектов!** 🎯