Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

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

Проект Google Cloud. Чтобы создать проект, см. раздел «Создание проекта» .
Клиент MCP, например Gemini CLI .
Для выполнения команд, описанных на этой странице, настройте интерфейс командной строки gcloud в локальной среде разработки, выполнив следующие действия:
1. Установите Google Cloud CLI . Если вы ранее устанавливали gcloud CLI, убедитесь, что у вас установлена последняя версия, выполнив команду gcloud components update .
2. Если вы используете внешнего поставщика идентификации (IdP), войдите в CLI gcloud, используя свою федеративную идентификацию. Для получения дополнительной информации см. раздел «Вход в CLI gcloud с использованием вашей федеративной идентификации» .
3. Инициализируйте интерфейс командной строки gcloud .

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

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

Включите API

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

API Google Drive

CLI

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

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

Консоль

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

Включите API

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

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

API Google Drive MCP

CLI

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

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

Консоль

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

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

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

В консоли Google Cloud перейдите в раздел Google Auth Platform > Брендинг .
Перейти к разделу «Брендинг»
Если вы уже настроили платформу аутентификации Google , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение о том, что платформа аутентификации Google еще не настроена , нажмите «Начать» :
1. В разделе «Информация о приложении» в поле «Название приложения» введите Drive MCP Server .
2. В разделе «Электронная почта службы поддержки пользователей» выберите свой адрес электронной почты или соответствующую группу Google.
3. Нажмите «Далее» .
4. В разделе «Аудитория» выберите «Внутренняя» . Если выбрать «Внутренняя» невозможно, выберите «Внешняя» .
5. Нажмите «Далее» .
6. В поле «Контактная информация» укажите адрес электронной почты , на который вы сможете получать уведомления об изменениях в вашем проекте.
7. Нажмите «Далее» .
8. В разделе «Завершить » ознакомьтесь с Политикой использования пользовательских данных сервисов Google API и, если вы согласны, выберите «Я согласен с Политикой использования пользовательских данных сервисов Google API» .
9. Нажмите «Продолжить» .
10. Нажмите «Создать» .
11. Если для типа пользователя выбран «Внешний» , добавьте тестовых пользователей:
  1. Нажмите «Аудитория» .
  2. В разделе «Проверка пользователей» нажмите «Добавить пользователей» .
  3. Введите свой адрес электронной почты и имена других авторизованных пользователей, участвующих в тестировании, затем нажмите «Сохранить» .
Нажмите «Доступ к данным» > «Добавить или удалить области действия ». Откроется панель со списком областей действия для каждого API, который вы включили в своем проекте Google Cloud.
1. В разделе «Добавить области действия вручную» вставьте области действия для сервера Google Drive MCP:
  - https://www.googleapis.com/auth/drive.readonly
  - https://www.googleapis.com/auth/drive.file
2. Нажмите «Добавить в таблицу» .
3. Нажмите «Обновить» .
4. После выбора областей доступа, необходимых для вашего приложения, на странице «Доступ к данным» нажмите «Сохранить» .

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

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

Gemini CLI

Чтобы добавить удаленный сервер Google Drive MCP в Gemini CLI, добавьте конфигурацию сервера в файл settings.json .

Создайте идентификатор клиента и секретный ключ OAuth 2.0:
1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент
  Перейдите в раздел «Создать клиента».
2. Выберите «Настольное приложение» в качестве типа приложения.
3. Введите имя .
4. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .
Откройте или создайте конфигурационный файл ~/.gemini/settings.json .

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

{
  "mcpServers": {
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    }
  }
}

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

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

Сохраните settings.json .
Запустите Gemini CLI:
```
gemini
```
В Gemini CLI выполните аутентификацию на сервере MCP, выполнив следующую команду:
```
/mcp auth drive
```
1. При появлении запроса нажмите 1 , чтобы открыть страницу аутентификации в браузере. Если вы работаете по SSH, следуйте инструкциям в командной строке.
2. Войдите в свой аккаунт Google.
3. Проверьте запрошенные области действия OAuth и нажмите «Разрешить» .
4. Появляется сообщение, подтверждающее успешную аутентификацию.
В командной строке Gemini выполните команду /mcp list , чтобы просмотреть настроенные серверы MCP и используемые ими инструменты.
Ответ будет примерно таким:
```
🟢 drive - Ready (7 tools)
  Tools:
  - create_file
  - download_file_content
  - get_file_metadata
  - get_file_permissions
  - list_recent_files
  - read_file_content
  - search_files
```

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

Клод

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

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

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

Другие

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

Имя сервера : drive
URL сервера : https://drivemcp.googleapis.com/mcp/v1
Транспорт : HTTP
Аутентификация : Удаленный сервер Google Drive MCP использует OAuth 2.0. Подробнее см. раздел «Информация об аутентификации и авторизации» .

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

Протестируйте сервер Google Drive MCP.

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

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

«Кратко изложите содержание документа «Маркетинговый план».»
Клиент вызывает drive.search_files для поиска файла "Маркетинговый план", а затем использует drive.read_file_content для извлечения и обобщения его содержимого.

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

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

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

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

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

create_file
download_file_content
get_file_metadata
get_file_permissions
list_recent_files
read_file_content
search_files

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

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

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

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

Настройте сервер Drive MCP. Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Включите API

CLI

Консоль

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

CLI

Консоль

Настройте экран согласия OAuth.

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

Gemini CLI

Клод

Другие

Протестируйте сервер Google Drive MCP.

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

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

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

Раздел по теме

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