Настройте сервер Sheets MCP.

Google Sheets предоставляет удаленный сервер протокола контекста модели (MCP) , который позволяет агентам искусственного интеллекта безопасно взаимодействовать с данными Google Sheets. Настроив сервер MCP Google Sheets, вы позволяете таким приложениям ИИ, как Google Antigravity и Claude, выполнять действия в Google Sheets.

Сервер Google Sheets MCP предоставляет стандартизированный способ для агентов искусственного интеллекта:

  • Чтение данных : получение значений ячеек, названий листов, свойств сетки и других метаданных электронных таблиц.
  • Выполните следующие действия : обновите значения ячеек, задайте формулы, вставьте строки/столбцы и выполните пакетное обновление структуры электронной таблицы.
  • Соблюдайте правила безопасности : наследуйте те же права доступа и средства управления данными, что и пользователь.

Предварительные требования

Настройте сервер Google Sheets MCP.

Для использования сервера Google Sheets MCP необходимо включить его в вашем проекте Google Cloud, а затем настроить клиент MCP для подключения к нему.

Включите API

Для использования сервера Google Sheets MCP необходимо включить следующий API в вашем проекте Google Cloud:

  • API Google Таблиц

CLI 

gcloud services enable sheets.googleapis.com --project=PROJECT_ID

Замените PROJECT_ID на идентификатор вашего проекта в Google Cloud.

Консоль

Включите API в консоли Google Cloud:

Включите API

Включите службы MCP.

Для включения компонентов MCP для Google Таблиц необходимо активировать следующую службу в вашем проекте Google Cloud:

  • Google Sheets MCP API

CLI 

gcloud services enable sheetsmcp.googleapis.com --project=PROJECT_ID

Замените PROJECT_ID на идентификатор вашего проекта в Google Cloud.

Консоль

Включите сервисы MCP в консоли Google Cloud:

Включите службы MCP.

Сервер Google Sheets MCP использует OAuth 2.0 для аутентификации и авторизации. Перед созданием идентификатора клиента OAuth необходимо настроить экран согласия OAuth.

  1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Брендинг .

    Перейти к разделу «Брендинг»

  2. Если вы уже настроили платформу аутентификации Google , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение о том, что платформа аутентификации Google еще не настроена , нажмите «Начать» :

    1. В разделе «Информация о приложении» в поле «Название приложения» введите Sheets MCP Server .
    2. В разделе «Электронная почта службы поддержки пользователей» выберите свой адрес электронной почты или соответствующую группу Google.
    3. Нажмите «Далее» .
    4. В разделе «Аудитория» выберите «Внутренняя» . Если выбрать «Внутренняя» невозможно, выберите «Внешняя» .
    5. Нажмите «Далее» .
    6. В поле «Контактная информация» укажите адрес электронной почты , на который вы сможете получать уведомления об изменениях в вашем проекте.
    7. Нажмите «Далее» .
    8. В разделе «Завершить» ознакомьтесь с Политикой использования пользовательских данных сервисов Google API и, если вы согласны, выберите «Я согласен с Политикой использования пользовательских данных сервисов Google API» .
    9. Нажмите «Продолжить» .
    10. Нажмите «Создать» .
    11. Если для типа пользователя выбран «Внешний» , добавьте тестовых пользователей:
      1. Нажмите «Аудитория» .
      2. В разделе «Проверка пользователей» нажмите «Добавить пользователей» .
      3. Введите свой адрес электронной почты и имена других авторизованных пользователей, участвующих в тестировании, затем нажмите «Сохранить» .

  3. Нажмите «Доступ к данным» > «Добавить или удалить области действия ». Откроется панель со списком областей действия для каждого API, который вы включили в своем проекте Google Cloud.

    1. В разделе «Добавить области действия вручную» вставьте области действия для сервера Google Sheets MCP:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/spreadsheets.readonly

    2. Нажмите «Добавить в таблицу» .

    3. Нажмите «Обновить» .

    4. После выбора областей доступа, необходимых для вашего приложения, на странице «Доступ к данным» нажмите «Сохранить» .

Настройте свой клиент MCP.

Чтобы добавить удаленный сервер Google Sheets MCP в ваш клиент MCP, следуйте инструкциям для вашего клиента.

Антигравитация

Чтобы добавить удаленный сервер Google Sheets MCP в Antigravity, добавьте конфигурацию сервера в файл mcp_config.json . Эти инструкции поддерживают Antigravity 2.0, Antigravity IDE и Antigravity CLI.

  1. Создайте идентификатор клиента и секретный ключ OAuth 2.0:

    1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент

      Перейдите в раздел «Создать клиента».

    2. В качестве типа приложения выберите «Веб-приложение» .

    3. Введите имя .

    4. В разделе «Авторизованные URI перенаправления» нажмите « + Добавить URI» , а затем в поле «URI» добавьте https://antigravity.google/oauth-callback .

    5. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

  2. Откройте или создайте конфигурационный файл ~/.gemini/antigravity/mcp_config.json .

  3. Добавьте конфигурацию mcpServers в mcp_config.json :

    {
  "mcpServers": {
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Замените следующее:

    • OAUTH_CLIENT_ID : Идентификатор клиента, который вы создали.
    • OAUTH_CLIENT_SECRET : Созданный вами секретный ключ клиента.

  4. Сохраните mcp_config.json .

  5. Выполните аутентификацию на сервере MCP. Аутентификацию можно выполнить либо через графический интерфейс, либо через командную строку:

    • Для Antigravity IDE или GUI (Antigravity 2.0):

      1. Откройте экран настроек (например, нажмите «Настройки» в левом нижнем углу или откройте «Пользовательские настройки Antigravity »).
      2. Перейдите в раздел «Настройки» .
      3. В разделе «Установленные серверы MCP» нажмите «Обновить» .
      4. Найдите sheets в списке, нажмите «Аутентифицировать» , войдите в свою учетную запись Google, скопируйте код авторизации, вставьте его в диалоговое окно ввода и нажмите «Отправить» .

    • Для интерфейса командной строки Antigravity:

      1. Запуск интерфейса командной строки Antigravity:

        agy

      2. Откройте интерактивную панель управления MCP, выполнив следующую команду:

        /mcp

      3. Используйте клавиши со стрелками, чтобы выбрать sheets , перейдите к действию «Аутентификация» и нажмите Enter . Завершите процесс входа в систему в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Enter .

  6. Убедитесь, что сервер правильно настроен и запущен:

    • Для Antigravity IDE или GUI: кнопка «Выход» отображается рядом с сервером в разделе «Настройки» > «Установленные серверы MCP» .
    • Для Antigravity CLI: Откройте панель /mcp , чтобы просмотреть настроенные серверы MCP. Проверенные и аутентифицированные серверы отображаются с пометкой «Authented» рядом со своими именами в интерактивной панели TUI. Вы можете выбрать любой сервер в панели управления, чтобы проверить его статус и просмотреть список всех доступных инструментов.

Удаленный MCP-сервер готов к использованию в Antigravity.

Клод

Для использования удаленного сервера Google Sheets MCP с Claude.ai или Claude Desktop вам необходим тарифный план Claude Enterprise, Pro, Max или Team.

Чтобы добавить удаленный сервер Google Sheets MCP в Claude, настройте пользовательский коннектор с идентификатором клиента OAuth и секретным ключом.

  1. Создайте идентификатор клиента и секретный ключ OAuth 2.0:

    1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент

      Перейдите в раздел «Создать клиента».

    2. В качестве типа приложения выберите «Веб-приложение» .

    3. Введите имя .

    4. В разделе «Авторизованные URI перенаправления» нажмите « + Добавить URI» , а затем в поле «URI» добавьте https://claude.ai/api/mcp/auth_callback .

    5. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

  2. Настройте сервер MCP в Claude:

    1. В Claude.ai или Claude Desktop перейдите в Настройки (или Административные настройки ) > Коннекторы .
    2. Нажмите « Добавить пользовательский коннектор» .
    3. Введите данные для подключения к продукту Google Sheets:
      • Имя сервера : Google Sheets .
      • URL удаленного MCP-сервера : https://sheetsmcp.googleapis.com/mcp/v1
    4. В разделе «Расширенные настройки» введите идентификатор клиента OAuth и секретный ключ клиента OAuth .
    5. Нажмите «Добавить» .

Другие

Многие приложения искусственного интеллекта позволяют подключаться к удалённому серверу MCP. Обычно для этого требуется ввести данные о сервере, такие как его имя, конечные точки, транспортный протокол и метод аутентификации. Для удалённого сервера MCP в Google Sheets введите следующее:

Для получения более подробной информации о подключении различных типов клиентов см. раздел «Настройка MCP в приложении ИИ» .

Проверьте работу сервера Google Sheets MCP.

После настройки клиента MCP вы можете проверить соединение, запустив несколько тестовых запросов.

Попробуйте задать своему клиенту MCP следующие вопросы:

  • "Прочитайте лист Sheet1 из таблицы Google Sheets abcd123 ."

    Клиент получает значения сетки с помощью sheets.get_values .

  • "Вставьте столбец с индексом 2 в таблицу Google Sheets abcd123 ."

    Клиент выполняет sheets.insert_dimension для изменения значений в столбцах.

Если инструменты работают успешно и вы получаете соответствующие ответы, значит, ваш сервер Google Sheets MCP настроен правильно.

Поиск неисправностей

Если у вас возникли проблемы с подключением к серверу MCP, вы можете проверить наличие ошибок в журналах OAuth. Попросите вашего администратора проверить события журнала OAuth в инструменте анализа безопасности .

Справочник инструментов

Для сервера Google Sheets MCP доступны следующие инструменты:

  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension

Важный аспект безопасности: непрямая инъекция подсказки.

Когда вы предоставляете языковой модели доступ к ненадежным данным, существует риск косвенной атаки с внедрением подсказок . Поскольку клиенты MCP, такие как Google Antigravity, имеют доступ к мощным инструментам и API через сервер Google Sheets MCP, они могут читать, изменять и удалять данные в вашей учетной записи Google.

Для снижения этих рисков следуйте этим передовым методам:

  • Используйте только проверенные инструменты. Никогда не подключайте сервер Google Sheets MCP к ненадежным или непроверенным приложениям.
  • Будьте осторожны с ненадежными входными данными. Избегайте запросов к вашему MCP-клиенту на обработку электронных таблиц или других ресурсов из непроверенных источников. Эти входные данные могут содержать скрытые инструкции, которые могут перехватить вашу сессию, позволив злоумышленнику изменить, украсть или удалить ваши данные.
  • Проверяйте все действия. Всегда внимательно проверяйте действия, выполняемые вашим ИИ-клиентом от вашего имени, чтобы убедиться в их правильности и соответствии вашим намерениям.