Интеграция Google Workspace с ИИ-агентами, такими как Claude Code CLI или OpenClaw, — задача, которая может занять часы, даже если вы опытный разработчик. Автор статьи на Habr, руководитель ИИ-функции с десятилетним стажем, поделился опытом подключения календаря и почты к агенту. Главный вывод: Google Cloud не рассчитан на одиночных пользователей, и это создает неожиданные препятствия.
Существует три способа подключения: коннектор провайдера (например, Claude или ChatGPT), MCP-сервер или API. Коннектор — самый простой вариант, работает по кнопке connect, но ограничен: Claude Code CLI, запускаемый в терминале, не видит коннекторы claude.ai. Для пользователей, которые работают только через UI, коннектор — лучший выбор, и остальные сложности им не нужны.
Google выпустил официальные MCP-серверы, но они имеют ограниченный набор методов. Например, календарь не имеет доступа к контактам (People API), а MCP Drive у автора не заработал. Существуют сторонние MCP и CLI-инструменты, но они могут содержать баги и засорять контекст лишними методами. Автор в итоге попросил агента написать собственный CLI-клиент под свои требования, что оказалось быстрее и надежнее.
Официальные MCP-серверы Google имеют ограниченный набор методов, например, календарь не имеет доступа к контактам.
Ключевая сложность — авторизация. Google Cloud не поддерживает Personal Access Token (PAT), в отличие от многих других сервисов. Вместо этого нужно создать проект, в нем приложение, затем клиент, и проходить через OAuth-процесс. OAuth работает так: клиент создает ссылку на accounts.google.com, пользователь открывает ее в браузере, предоставляет права, после чего Google перенаправляет на callback-ссылку (обычно локальный адрес, где клиент поднял веб-сервер). В ссылке приходит одноразовый код, который клиент обменивает на токены прямым запросом. Если агент работает на сервере, для обработки callback необходимо настроить SSH-туннель на localhost.
В Google Cloud также есть API Key и Service Account, но они не подходят для личного использования: API Key не идентифицирует пользователя, а Service Account работает только через администратора организации в корпоративной версии. Понимание сущностей Google Cloud — Project, Google Auth Platform, Client и Scopes — помогает разобраться в процессе. Проект — это контейнер для API и настроек, Auth Platform — интерфейс приложения, Client — учетные данные для конкретной платформы, а Scopes — набор разрешений.
Таким образом, подключение Google-сервисов к ИИ-агенту требует не только технических навыков, но и понимания корпоративной модели Google. Для тех, кто готов писать собственный код, API с самописной CLI-оберткой — наиболее гибкий и контролируемый путь, хотя и требует времени на настройку.
