Настройте сервер People API MCP.

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

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

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

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

Настройте сервер People API MCP.

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

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

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

  • API для работы с людьми

CLI 

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

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

Консоль

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

Включите API

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

  1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Брендинг .

    Перейти к разделу «Брендинг»

  2. Если вы уже настроили платформу аутентификации Google , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение о том, что платформа аутентификации Google еще не настроена , нажмите «Начать» :

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

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

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

      • 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, следуйте инструкциям для вашего клиента.

Антигравитация

Чтобы добавить удаленный 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. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

  2. Откройте или создайте конфигурационный файл ~/.gemini/antigravity/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 в списке, нажмите «Аутентифицировать» , войдите в свой аккаунт Google, скопируйте код авторизации, вставьте его в диалоговое окно ввода и нажмите «Отправить» .

    • Для интерфейса командной строки Antigravity:

      1. Запуск интерфейса командной строки Antigravity:

        agy

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

        /mcp

      3. Используйте клавиши со стрелками, чтобы выбрать people , перейдите к действию «Аутентификация» и нажмите Enter . Завершите процесс входа в систему в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Enter .

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

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

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

Клод

Для использования удаленного сервера 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. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

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

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

Другие

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

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

Протестируйте сервер People API MCP.

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

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

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

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

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

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

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

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

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

  • get_user_profile
  • search_contacts
  • search_directory_people

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

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

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

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