Google Drive MCP Server

Что умеет сервер

Google Drive предлагает удалённый MCP-сервер по адресу drivemcp.googleapis.com. Через него ИИ-агент может искать файлы, получать метаданные и читать содержимое, а также создавать файлы и скачивать их. Документация перечисляет восемь инструментов: search_files, list_recent_files, get_file_metadata, get_file_permissions, read_file_content, download_file_content, create_file и copy_file.

Сервер наследует права и политики доступа самого пользователя: агент видит только то, что открыто этой учётной записи. Для авторизации используется OAuth 2.0, а в консенте запрашиваются два права: drive.readonly и drive.file.

Когда использовать

Сервер подходит, когда ассистенту нужно работать с документами в вашем Google Drive: найти файл по названию и пересказать его, посмотреть последние изменённые файлы, выяснить, кто имеет доступ к документу, или сохранить результат работы в новый файл. В документации в качестве проверки приведён запрос «Summarize the file Marketing Plan», на который клиент отвечает связкой поиска и чтения содержимого.

Прежний эталонный сервер Google Drive из репозитория modelcontextprotocol/servers перенесён в архивный репозиторий. Google теперь предлагает собственный удалённый сервер, поэтому для новых подключений ориентируйтесь на него.

Ограничения и безопасность

Это Developer Preview: чтобы подключиться, нужно состоять в программе Google Workspace Developer Preview Program и иметь проект в Google Cloud. Вам придётся включить Drive API и Drive MCP API в проекте, настроить экран согласия OAuth и создать собственный OAuth-клиент с пометкой «использовать для ИИ-агента». Для Claude.ai и Claude Desktop, как сказано в документации, нужен тариф Claude Enterprise, Pro, Max или Team.

Google отдельно предупреждает о косвенной prompt injection: документ с недоверенным содержимым может содержать скрытые инструкции для модели. Рекомендации такие: подключать сервер только к доверенным приложениям, не обрабатывать файлы из непроверенных источников и проверять действия клиента. Для фильтрации запросов и ответов Google предлагает свой сервис Model Armor.

Если клиент просит войти заново примерно каждый час, он не получает refresh-токен: в запрос авторизации нужно добавить параметр access_type=offline.

Подготовка проекта Google Cloud

Включите Google Drive API и Google Drive MCP API, подставив идентификатор своего проекта вместо PROJECT_ID:

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

На экране согласия OAuth в разделе Data Access добавьте вручную два права:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.file

Claude

Нужен тариф Claude Enterprise, Pro, Max или Team. В Google Cloud console откройте Google Auth Platform, затем Clients и Create Client. Выберите тип Web application, в Authorized redirect URIs добавьте https://claude.ai/api/mcp/auth_callback, отметьте «Use this client for an AI-powered agent» и сохраните Client ID и Client Secret.

Затем в Claude.ai или Claude Desktop откройте Settings (или Admin settings), раздел Connectors, нажмите Add custom connector и введите:

Server name: Google Drive
Remote MCP server URL: https://drivemcp.googleapis.com/mcp/v1

В Advanced settings впишите OAuth client ID и OAuth client secret и нажмите Add.

Google Antigravity

Создайте OAuth-клиент так же, но с адресом перенаправления https://antigravity.google/oauth-callback. Затем добавьте в файл ~/.gemini/config/mcp_config.json:

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

Подставьте свои ID и секрет клиента, сохраните файл и пройдите аутентификацию в настройках Antigravity (Customizations, Installed MCP Servers, Authenticate) или в консольном клиенте командой /mcp.

Другие клиенты

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

Server name: drive
Server URL: https://drivemcp.googleapis.com/mcp/v1
Transport: Streamable HTTP
Authentication: OAuth 2.0