Как настроить MCP-сервер People API

People API предлагает удаленный сервер Model Context Protocol (MCP), который позволяет ИИ-агентам безопасно взаимодействовать с профилем Google Workspace и данными контактов. Настроив сервер MCP People API, вы разрешите приложениям на основе ИИ, таким как Google Antigravity и Claude, выполнять действия с помощью People API.

MCP-сервер People API предоставляет ИИ-агентам стандартизированный способ:

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

Требования

Как настроить MCP-сервер People API

Чтобы использовать MCP-сервер People API, включите его в своем облачном проекте Google Cloud, а затем настройте MCP-клиент для подключения к нему.

Как включить API и сервис MCP

Чтобы использовать MCP-сервер People API, включите в своем облачном проекте Google Cloud следующий сервис:

  • People API

ИКС

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

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

Консоль

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

Как включить API

Для аутентификации и авторизации MCP-сервер People API использует OAuth 2.0. Прежде чем создавать идентификатор клиента OAuth, необходимо настроить окно запроса доступа OAuth.

  1. В консоли Google Cloud выберите Google Auth Platform (Платформа Google Auth) > Branding (Брендинг).

    Перейти к брендингу

  2. Если вы уже настроили Google Auth Platform, то можете задать следующие настройки окна запроса доступа OAuth: Брендинг, Аудитория и Доступ к данным. Если вы видите сообщение Google Auth Platform not configured yet (Платформа аутентификации Google ещё не настроена), нажмите Начать:

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

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

    1. В разделе Добавить области действия вручную вставьте области действия для MCP-сервера People API:

      • https://www.googleapis.com/auth/directory.readonly
      • https://www.googleapis.com/auth/userinfo.profile
      • https://www.googleapis.com/auth/contacts.readonly

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

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

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

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

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

Antigravity

Чтобы добавить удаленный MCP-сервер People API в 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. Выберите Использовать этого клиента для агента на основе искусственного интеллекта.

    6. Нажмите Create (Создать) и скопируйте значения Client ID (Идентификатор клиента) и Client Secret (Секретный код клиента).

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

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

    {
  "mcpServers": {
    "people": {
      "serverUrl": "https://people.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. Найдите в списке people, нажмите Authenticate (Аутентификация), войдите в аккаунт Google, скопируйте код авторизации, вставьте его в диалоговое окно и нажмите Submit (Отправить).

    • Для Antigravity CLI:

      1. Запустите Antigravity CLI:

        agy

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

        /mcp

      3. С помощью клавиш со стрелками выберите people, перейдите к действию Аутентификация и нажмите Ввод. Выполните вход в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Ввод.

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

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

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

Claude

Чтобы использовать удаленный MCP-сервер People API с Claude.ai или Claude Desktop, у вас должен быть тарифный план Claude Enterprise, Pro, Max или Team.

Чтобы добавить удаленный MCP-сервер People API в 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. Выберите Использовать этого клиента для агента на основе искусственного интеллекта.

    6. Нажмите Создать и скопируйте идентификатор клиента и секретный код клиента.

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

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

Другое

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

Подробнее о подключении клиентов разных типов рассказывается в статье Как настроить MCP в ИИ-приложении.

Как протестировать MCP-сервер People API

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

Задайте клиенту MCP следующие вопросы:

  • "Как меня зовут согласно профилю Google?"

    Клиент использует people.get_user_profile для получения информации профиля Google Workspace.

Если инструменты выполняются успешно и вы получаете нужные ответы, значит MCP-сервер People API настроен правильно.

Устранение неполадок

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

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

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

  • get_user_profile
  • search_contacts
  • search_directory_people

Важная информация о безопасности: косвенное внедрение запроса

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

Чтобы снизить эти риски, необходимо проверять запросы и ответы на наличие вредоносного контента или атак с внедрением запросов. Вы можете использовать Model Armor от Google или собственное решение, если вы задокументируете его, чтобы пользователи могли принять этот риск. Подробнее о том, как настроить безопасность для MCP-серверов Google Workspace…

Следуйте этим рекомендациям:

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