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

API People предоставляет удаленный сервер протокола контекста модели (MCP) , который позволяет агентам ИИ безопасно взаимодействовать с данными профилей и контактов Google Workspace. Настроив сервер MCP API People, вы позволяете приложениям ИИ, таким как Gemini CLI, Claude или IDE, выполнять действия с использованием 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, следуйте инструкциям для вашего клиента.

Gemini CLI

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

  1. Создайте идентификатор клиента и секретный ключ OAuth 2.0:

    1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент

      Перейдите в раздел «Создать клиента».

    2. Выберите «Настольное приложение» в качестве типа приложения.

    3. Введите имя .

    4. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

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

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

    {
  "mcpServers": {
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

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

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

  4. Сохраните settings.json .

  5. Запустите Gemini CLI:

    gemini

  6. В Gemini CLI выполните аутентификацию на сервере MCP, выполнив следующую команду:

    /mcp auth people
    1. При появлении запроса нажмите 1 , чтобы открыть страницу аутентификации в браузере. Если вы работаете по SSH, следуйте инструкциям в командной строке.
    2. Войдите в свой аккаунт Google.
    3. Проверьте запрошенные области действия OAuth и нажмите «Разрешить» .
    4. Появляется сообщение, подтверждающее успешную аутентификацию.

  7. В командной строке Gemini выполните команду /mcp list , чтобы просмотреть настроенные серверы MCP и используемые ими инструменты.

    Ответ будет примерно таким:

    🟢 people - Ready (3 tools)
  Tools:
  - get_user_profile
  - search_contacts
  - search_directory_people

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

Клод

Для использования удаленного сервера 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, такие как Gemini CLI, имеют доступ к мощным инструментам и API через сервер People API MCP, они могут считывать данные из вашей учетной записи Google.

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

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