В Документах есть удаленный сервер Model Context Protocol (MCP), который позволяет ИИ-агентам безопасно взаимодействовать с данными Документов. Настроив MCP-сервер Документов, вы разрешите ИИ-приложениям, таким как Google Antigravity и Claude, выполнять действия в Документах.
MCP-сервер Документов предоставляет ИИ-агентам стандартизированный способ:
- Чтение данных. Чтение структурной информации и текстового контента документа.
- Действия: Обновите стиль и структуру документа с помощью пакетных обновлений.
- Соблюдение требований безопасности. Наследование тех же разрешений и элементов управления данными, что и у пользователя.
Требования
Участие в программе предварительной версии для разработчиков Google Workspace.
Проект Google Cloud. Подробнее о том, как создать проект…
Хост MCP – ИИ-приложение, например Google Antigravity или Claude. ИИ-приложение создает подключение MCP-клиента для каждого MCP-сервера.
Чтобы запустить команды, приведенные на этой странице, настройте gcloud CLI в одной из следующих сред разработки:
Cloud Shell
Чтобы использовать онлайн-терминал с уже настроенным gcloud CLI, активируйте Cloud Shell:
Локальная оболочка
Чтобы использовать локальную среду разработки, выполните следующие действия:
- Установите Google Cloud CLI.
Если вы уже установили gcloud CLI, убедитесь, что у вас последняя версия, выполнив команду
gcloud components update. - Если вы используете внешнего поставщика идентификационной информации, войдите в gcloud CLI с помощью федеративной идентификационной информации. Дополнительную информацию можно найти в статье Как войти в gcloud CLI с помощью федеративной идентификационной информации.
- Инициализируйте gcloud CLI.
- Установите Google Cloud CLI.
Если вы уже установили gcloud CLI, убедитесь, что у вас последняя версия, выполнив команду
Настройте MCP-сервер Документов
Чтобы использовать MCP-сервер Документов, включите его в проекте Google Cloud и настройте подключение к нему в ИИ-приложении.
Включение API
Чтобы использовать MCP-сервер Документов, включите в своем облачном проекте Google Cloud следующий API:
Google Docs API
ИКС
gcloud services enable docs.googleapis.com --project=PROJECT_ID
Замените PROJECT_ID идентификатором проекта Google Cloud.
Консоль
Включите API в консоли Google Cloud:
Включите сервисы MCP
Чтобы включить компоненты MCP для Документов, включите следующий сервис в облачном проекте Google Cloud:
Docs MCP API
ИКС
gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID
Замените PROJECT_ID идентификатором проекта Google Cloud.
Консоль
Включите сервисы MCP в консоли Google Cloud:
Как настроить окно запроса доступа OAuth
MCP-сервер Docs использует OAuth 2.0 для аутентификации и авторизации. Прежде чем создавать идентификатор клиента OAuth, необходимо настроить окно запроса доступа OAuth.
В консоли Google Cloud выберите Google Auth Platform (Платформа идентификации Google) > Branding (Брендинг).
Если вы уже настроили платформу идентификации Google, то можете задать следующие параметры окна запроса доступа OAuth: Брендинг, Аудитория и Доступ к данным. Если вы видите сообщение Google Auth Platform not configured yet (Платформа Google Auth Platform ещё не настроена), нажмите Get Started (Начать).
- В разделе App Information (Информация о приложении) в поле App name (Название приложения) введите
Docs MCP Server. - В поле Электронный адрес службы поддержки выберите свой адрес электронной почты или адрес группы Google.
- Нажмите Далее.
- В разделе Аудитория выберите Внутренние. Если вы не можете выбрать Внутреннее, выберите Внешнее.
- Нажмите Далее.
- В разделе Контактная информация укажите адрес электронной почты, на который вы хотите получать уведомления об изменениях в проекте.
- Нажмите Далее.
- В разделе Завершение ознакомьтесь с правилами в отношении пользовательских данных в сервисах API Google и, если вы согласны с ними, установите флажок Я принимаю правила в отношении пользовательских данных в сервисах API Google.
- Нажмите Продолжить.
- Нажмите Создать.
- Если вы выбрали тип пользователя Внешний, добавьте тестовых пользователей:
- Нажмите Аудитория.
- В разделе Тестовые пользователи нажмите Добавить пользователей.
- Введите свой адрес электронной почты и адреса других авторизованных тестовых пользователей, а затем нажмите Сохранить.
- В разделе App Information (Информация о приложении) в поле App name (Название приложения) введите
Нажмите Доступ к данным > Добавить или удалить области действия. Появится панель со списком областей действия для каждого API, включенного в проекте Google Cloud.
В разделе Добавить области действия вручную вставьте области действия для сервера MCP Документов:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
Нажмите Добавить в таблицу.
Нажмите Обновить.
Выбрав области действия, необходимые для вашего приложения, на странице Доступ к данным нажмите Сохранить.
Настройте ИИ-приложение
Чтобы добавить удаленный MCP-сервер Документов в ИИ-приложение, следуйте инструкциям для этого приложения.
Для идентификаторов клиентов OAuth 2.0, делегированных пользователями, которые вызывают MCP-сервер Документов, должен быть выбран параметр Использовать этот клиент для агента на основе искусственного интеллекта в разделе Платформа Google Auth > Клиенты. Чтобы обновить существующий идентификатор клиента OAuth 2.0, выберите этот параметр в разделе Google Auth Platform > Clients (Клиенты), как описано в статье Как управлять клиентами OAuth. Если вы не можете изменить эту настройку для существующего клиента или если клиент также поддерживает функции, не связанные с агентами, создайте новый идентификатор клиента OAuth 2.0 для своего ИИ-агента. Если запрос отклонен, вы используете сервисные аккаунты с делегированием доступа к данным в домене или Google Apps Script, ознакомьтесь с разделом Устранение неполадок.
Antigravity
Чтобы добавить удаленный MCP-сервер Документов в Antigravity,
добавьте конфигурацию сервера в файл mcp_config.json. Эти инструкции подходят для Antigravity 2.0, Antigravity IDE и Antigravity CLI.
Создайте идентификатор клиента и секретный код OAuth 2.0:
В консоли Google Cloud выберите Google Auth Platform (Платформа Google Auth) > Clients (Клиенты) > Create Client (Создать клиента).
В качестве типа приложения выберите Веб-приложение.
Укажите название.
В разделе Разрешенные URI перенаправления нажмите + Добавить URI и в поле URI введите
https://antigravity.google/oauth-callback.Выберите Использовать этого клиента для агента на основе искусственного интеллекта.
Нажмите Создать и скопируйте идентификатор клиента и секретный код клиента.
Откройте или создайте файл конфигурации
~/.gemini/config/mcp_config.json.Добавьте конфигурацию
mcpServersвmcp_config.json:{ "mcpServers": { "docs": { "serverUrl": "https://docsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }Замените следующее:
OAUTH_CLIENT_ID– созданный вами идентификатор клиента.OAUTH_CLIENT_SECRET: секретный код клиента, который вы создали.
Экономите
mcp_config.json.Выполните аутентификацию MCP-сервера. Вы можете выполнить аутентификацию с помощью настроек графического интерфейса пользователя или интерфейса командной строки.
Для Antigravity IDE или GUI (Antigravity 2.0):
- Откройте экран настроек (например, нажмите Settings (Настройки) в левом нижнем углу или откройте Antigravity User Settings (Пользовательские настройки Antigravity)).
- Перейдите в раздел Настройки.
- В разделе Установленные MCP-серверы нажмите Обновить.
- Найдите в списке
docs, нажмите Authenticate (Аутентификация), войдите в аккаунт Google, скопируйте код авторизации, вставьте его в диалоговое окно и нажмите Submit (Отправить).
Antigravity CLI:
Запустите Antigravity CLI:
agyОткройте интерактивную панель управления MCP, выполнив следующую команду:
/mcpС помощью клавиш со стрелками выберите
docs, перейдите к действию Аутентификация и нажмите Ввод. Выполните вход в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Ввод.
Убедитесь, что сервер правильно настроен и работает:
- Для Antigravity IDE или графического интерфейса пользователя. Кнопка Выйти показывается рядом с сервером в разделе Настройки > Установленные MCP-серверы.
- Для Antigravity CLI. Откройте панель
/mcp, чтобы посмотреть настроенные серверы MCP. Рядом с названиями проверенных и аутентифицированных серверов на интерактивной панели TUI будет показываться пометка Authed. Вы можете выбрать любой сервер на панели управления, чтобы проверить его статус и посмотреть список доступных инструментов.
Удаленный MCP-сервер готов к использованию в Antigravity.
Claude
Чтобы использовать удаленный MCP-сервер Документов с Claude.ai или Claude Desktop, у вас должен быть тарифный план Claude Enterprise, Pro, Max или Team.
Чтобы добавить удаленный MCP-сервер Документов в Claude, настройте собственный коннектор с идентификатором клиента OAuth и секретным кодом.
Создайте идентификатор клиента и секретный код OAuth 2.0:
В консоли Google Cloud выберите Google Auth Platform (Платформа Google Auth) > Clients (Клиенты) > Create Client (Создать клиента).
В качестве типа приложения выберите Веб-приложение.
Укажите название.
В разделе Разрешенные URI перенаправления нажмите + Добавить URI и в поле URI введите
https://claude.ai/api/mcp/auth_callback.Выберите Использовать этого клиента для агента на основе искусственного интеллекта.
Нажмите Создать и скопируйте идентификатор клиента и секретный код клиента.
Настройте MCP-сервер в Claude:
- В Claude.ai или Claude Desktop перейдите в Settings (Настройки) > Connectors (Коннекторы) или Admin settings (Настройки администратора) > Connectors (Коннекторы).
- Нажмите Добавить собственный коннектор.
- Укажите сведения о подключении для продукта "Документы":
- Имя сервера:
Docs. - URL удаленного MCP-сервера:
https://docsmcp.googleapis.com/mcp/v1
- Имя сервера:
- В разделе Расширенные настройки введите идентификатор клиента OAuth и секретный код клиента OAuth.
- Нажмите Добавить.
Другое
Многие ИИ-приложения могут подключаться к удаленному MCP-серверу. Обычно вам нужно ввести сведения о сервере, такие как его имя, конечные точки, транспортный протокол и способ аутентификации. Для удаленного MCP-сервера Документов введите следующее:
Имя сервера:
docsURL сервера:
https://docsmcp.googleapis.com/mcp/v1Транспорт: Streamable HTTP
Аутентификация. Удаленный MCP-сервер Документов использует OAuth 2.0. При создании клиента OAuth 2.0 выберите Использовать этот клиент для агента на основе искусственного интеллекта. Подробнее об аутентификации и авторизации…
Чтобы избежать ежечасных предложений войти в аккаунт с клиентом OAuth веб-приложения, настройте клиент MCP на запрос офлайн-доступа с помощью
access_type=offlineили области действияoffline_access. Подробнее о повторяющихся ежечасных запросах на вход…
Подробнее о том, как подключать разные типы ИИ-приложений, рассказывается в статье Как настроить MCP в ИИ-приложении.
Протестируйте MCP-сервер Docs
После настройки ИИ-приложения вы можете проверить подключение, выполнив несколько тестовых запросов.
Попробуйте задать ИИ-приложению следующие вопросы:
Покажи мне структуру документа Google
abcd123.Клиент получает структуру и содержимое документа с помощью
docs.read_doc."Вставь заголовок 'Мой маркетинговый план' в документ Google
abcd123".Клиент выполняет
docs.update_doc, чтобы обновить структурные элементы и вставить текст.
Если инструменты выполняются успешно и вы получаете релевантные ответы, значит MCP-сервер Документов настроен правильно.
Устранение неполадок
В разделах ниже описано, как устранить распространенные проблемы с аутентификацией и подключением к MCP-серверу Документов.
Как посмотреть события в журнале OAuth
Если у вас возникли проблемы с подключением к MCP-серверу, проверьте журналы OAuth на наличие ошибок. Попросите администратора Google Workspace проверить события в журнале OAuth с помощью инструмента "Анализ безопасности".
Отклоненные запросы от клиентов OAuth, делегированных пользователями
Если запросы к MCP-серверу отклоняются, убедитесь, что для идентификатора клиента OAuth 2.0, делегированного пользователем, в трехстороннем процессе OAuth выбран параметр Использовать этого клиента для агента на основе искусственного интеллекта в Google Auth Platform > Клиенты.
- Существующий клиент поддерживает настройку. Выберите Использовать этот клиент для агента на основе искусственного интеллекта для существующего клиента OAuth.
- Существующий клиент нельзя обновить. Создайте новый клиент OAuth, выбрав Использовать этот клиент для агента на основе искусственного интеллекта, и обновите приложение, чтобы использовать его.
- Существующий клиент также поддерживает функции, не связанные с агентом. Создайте отдельный клиент OAuth для ИИ-агента и сохраните существующий клиент для функций, не связанных с агентом.
Инструкции приведены в статьях Как настроить ИИ-приложение и Как управлять клиентами OAuth.
Сервисные аккаунты, которым делегирован доступ к данным в домене
Если в вашем приложении используется сервисный аккаунт с делегированием доступа к данным в домене для двухстороннего протокола OAuth, вы не можете выбрать Использовать этот клиент для агента на основе искусственного интеллекта, потому что сервисные аккаунты не управляются в Google Auth Platform > Клиенты.
- Контроль доступа. Запросы к MCP-серверу от этих сервисных аккаунтов не отклоняются из-за отсутствия настройки агента. Вместо этого доступ регулируется настройками делегирования доступа к данным в домене, которыми управляет администратор Google Workspace. Подробные сведения о настройках администратора приведены в статье Как управлять доступом к API, используя делегирование доступа к данным в домене.
- Действия, связанные с безопасностью. MCP-серверы Google Workspace по-прежнему возвращают запросы на заполнение форм для подтверждения человеком в контуре конфиденциальных вызовов инструментов, выполняемых с помощью делегирования доступа к данным в домене с входом под чужим именем.
Запросы из Apps Script
Если вы вызываете сервер MCP из Apps Script, вы не можете выбрать Использовать этот клиент для агента на основе искусственного интеллекта в клиенте OAuth по умолчанию, который Apps Script создает и которым управляет для вашего скрипта. Это правило действует, даже если в скрипте используется стандартный проект Google Cloud.
Чтобы вызвать сервер MCP из Apps Script, сделайте следующее:
- В консоли Google Cloud перейдите в раздел Google Auth Platform > Clients (Клиенты), создайте клиент OAuth и выберите Use this client for an AI-powered agent (Использовать этот клиент для агента на основе искусственного интеллекта).
- В скрипте используйте библиотеку OAuth2 для Apps Script, чтобы авторизовать пользователей с помощью этого клиента OAuth.
- При вызове MCP-сервера отправьте токен доступа, возвращенный библиотекой, а не токен из
ScriptApp.getOAuthToken.
Проекты Apps Script, которые не вызывают MCP-серверы Google Workspace, не будут затронуты.
Повторяющиеся ежечасные запросы на вход в аккаунт
Если вам приходится входить в аккаунт примерно каждый час, значит клиент MCP не получает или не использует токен обновления. Обычно это происходит в следующих ситуациях:
- Отсутствие офлайн-доступа у клиента OAuth веб-приложения. В отличие от клиентов OAuth компьютерных приложений, у клиентов OAuth веб-приложений по умолчанию есть только онлайн-доступ. Чтобы запросить токен обновления, включите
access_type=offlineили область действия OpenID Connect (OIDC)offline_accessвместе по крайней мере с одной областью действия API и не задавайтеaccess_type=online. - Повторная авторизация приложения, которому уже предоставлен доступ. Сервер OAuth 2.0 Google выдает токен обновления, когда пользователь впервые предоставляет доступ в офлайн-режиме. Если пользователь уже авторизовал ваш клиент OAuth без офлайн-режима или если ваш клиент MCP потерял сохраненный токен обновления, последующие входы могут не возвращать новый токен обновления. Добавьте
prompt=consentв запрос на авторизацию или закройте приложению доступ в разделе Связанные приложения и сервисы в аккаунте Google и войдите снова. - Статический токен на предъявителя. Если вы передаете необработанный токен доступа в заголовке
Authorization, например выходные данные изgcloud auth print-access-token, срок действия токена истекает через час, если ваш клиент не обновит его.
Подробнее о том, как обновить токен доступа…
Справочник по инструментам
Для сервера MCP Документов доступны следующие инструменты. Схемы входных и выходных данных приведены в документации по MCP для Документов.
Важная информация о безопасности: косвенное внедрение запроса
Когда вы предоставляете языковой модели доступ к ненадежным данным, возникает риск атаки с косвенным внедрением запроса. Поскольку у ИИ-приложений, таких как Google Antigravity, есть доступ к мощным инструментам и API через MCP-сервер Документов, они могут читать, изменять и удалять данные в вашем аккаунте Google.
Чтобы снизить эти риски, необходимо проверять запросы и ответы на наличие вредоносного контента или атак с внедрением запросов. Вы можете использовать Model Armor от Google или собственное решение, если вы задокументируете его, чтобы пользователи могли принять этот риск. Модель Инструкции приведены в статье Как настроить безопасность для MCP-серверов Google Workspace.
Следуйте этим рекомендациям:
- Используйте только надежные инструменты. Никогда не подключайте MCP-сервер Документов к ненадежным или непроверенным приложениям.
- Будьте осторожны с ненадежными входными данными. Не просите ИИ-приложение обрабатывать документы или другие ресурсы из непроверенных источников. Эти входные данные могут содержать скрытые инструкции, которые могут перехватить ваш сеанс и позволить злоумышленнику изменить, украсть или удалить ваши данные.
- Проверьте все действия. Всегда внимательно проверяйте действия, которые ИИ-приложение выполняет от вашего имени, чтобы убедиться, что они точны и соответствуют вашим намерениям.