Эта страница переведена с помощью Cloud Translation API.

Настройте сервер Calendar MCP.

Google Календарь предоставляет удаленный сервер протокола контекста модели (MCP) , который позволяет агентам искусственного интеллекта безопасно взаимодействовать с данными Google Календаря. Настроив сервер MCP Google Календаря, вы позволяете приложениям ИИ, таким как Gemini CLI, Claude или IDE, выполнять действия в Google Календаре.

Сервер Google Calendar MCP предоставляет стандартизированный способ для агентов искусственного интеллекта:

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

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

Проект Google Cloud. Чтобы создать проект, см. раздел «Создание проекта» .
Клиент MCP, например Gemini CLI .
Для выполнения команд, описанных на этой странице, настройте интерфейс командной строки gcloud в локальной среде разработки, выполнив следующие действия:
1. Установите Google Cloud CLI . Если вы ранее устанавливали gcloud CLI, убедитесь, что у вас установлена последняя версия, выполнив команду gcloud components update .
2. Если вы используете внешнего поставщика идентификации (IdP), войдите в CLI gcloud, используя свою федеративную идентификацию. Для получения дополнительной информации см. раздел «Вход в CLI gcloud с использованием вашей федеративной идентификации» .
3. Инициализируйте интерфейс командной строки gcloud .

Настройте сервер Google Календа MCP.

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

Включите API

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

API календаря Google

CLI

gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID

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

Консоль

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

Включите API

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

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

Google Календарь MCP API

CLI

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

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

Консоль

Включите сервисы MCP в консоли Google Cloud:

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

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

В консоли Google Cloud перейдите в раздел Google Auth Platform > Брендинг .
Перейти к разделу «Брендинг»
Если вы уже настроили платформу аутентификации Google , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение о том, что платформа аутентификации Google еще не настроена , нажмите «Начать» :
1. В разделе «Информация о приложении» в поле «Название приложения» введите Calendar MCP Server .
2. В разделе «Электронная почта службы поддержки пользователей» выберите свой адрес электронной почты или соответствующую группу Google.
3. Нажмите «Далее» .
4. В разделе «Аудитория» выберите «Внутренняя» . Если выбрать «Внутренняя» невозможно, выберите «Внешняя» .
5. Нажмите «Далее» .
6. В поле «Контактная информация» укажите адрес электронной почты , на который вы сможете получать уведомления об изменениях в вашем проекте.
7. Нажмите «Далее» .
8. В разделе «Завершить» ознакомьтесь с Политикой использования пользовательских данных сервисов Google API и, если вы согласны, выберите «Я согласен с Политикой использования пользовательских данных сервисов Google API» .
9. Нажмите «Продолжить» .
10. Нажмите «Создать» .
11. Если для типа пользователя выбран «Внешний» , добавьте тестовых пользователей:
  1. Нажмите «Аудитория» .
  2. В разделе «Проверка пользователей» нажмите «Добавить пользователей» .
  3. Введите свой адрес электронной почты и имена других авторизованных пользователей, участвующих в тестировании, затем нажмите «Сохранить» .
Нажмите «Доступ к данным» > «Добавить или удалить области действия ». Откроется панель со списком областей действия для каждого API, который вы включили в своем проекте Google Cloud.
1. В разделе «Добавить области действия вручную» вставьте области действия для сервера Google Calendar MCP:
  - https://www.googleapis.com/auth/calendar.calendarlist.readonly
  - https://www.googleapis.com/auth/calendar.events.freebusy
  - https://www.googleapis.com/auth/calendar.events.readonly
2. Нажмите «Добавить в таблицу» .
3. Нажмите «Обновить» .
4. После выбора областей доступа, необходимых для вашего приложения, на странице «Доступ к данным» нажмите «Сохранить» .

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

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

Gemini CLI

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

Создайте идентификатор клиента и секретный ключ OAuth 2.0:
1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент
  Перейдите в раздел «Создать клиента».
2. Выберите «Настольное приложение» в качестве типа приложения.
3. Введите имя .
4. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .
Откройте или создайте конфигурационный файл ~/.gemini/settings.json .

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

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    }
  }
}

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

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

Сохраните settings.json .
Запустите Gemini CLI:
```
gemini
```
В Gemini CLI выполните аутентификацию на сервере MCP, выполнив следующую команду:
```
/mcp auth calendar
```
1. При появлении запроса нажмите 1 , чтобы открыть страницу аутентификации в браузере. Если вы работаете по SSH, следуйте инструкциям в командной строке.
2. Войдите в свой аккаунт Google.
3. Проверьте запрошенные области действия OAuth и нажмите «Разрешить» .
4. Появляется сообщение, подтверждающее успешную аутентификацию.
В командной строке Gemini выполните команду /mcp list , чтобы просмотреть настроенные серверы MCP и используемые ими инструменты.
Ответ будет примерно таким:
```
🟢 calendar - Ready (8 tools)
  Tools:
  - create_event
  - delete_event
  - get_event
  - list_calendars
  - list_events
  - respond_to_event
  - suggest_time
  - update_event
```

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

Клод

Для использования удаленного сервера Google Calendar MCP с Claude.ai или Claude Desktop вам необходим тарифный план Claude Enterprise, Pro, Max или Team.

Чтобы добавить удаленный сервер Google Calendar MCP в Claude, настройте пользовательский коннектор с идентификатором клиента OAuth и секретным ключом.

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

Другие

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

Имя сервера : calendar
URL сервера : https://calendarmcp.googleapis.com/mcp/v1
Транспорт : HTTP
Аутентификация : Удаленный сервер Google Calendar MCP использует OAuth 2.0. Подробнее см. раздел «Информация об аутентификации и авторизации» .

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

Проверьте работу сервера Google Календаря MCP.

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

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

«Когда состоится моя следующая встреча с Ариэлем?»
Клиент проверяет ваше расписание с помощью calendar.list_events и указывает подробности вашей следующей встречи с Ариэлем.

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

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

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

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

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

create_event
delete_event
get_event
list_calendars
list_events
respond_to_event
suggest_time
update_event

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

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

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

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

Настройте сервер Calendar MCP. Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Настройте сервер Google Календа MCP.

Включите API

CLI

Консоль

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

CLI

Консоль

Настройте экран согласия OAuth.

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

Gemini CLI

Клод

Другие

Проверьте работу сервера Google Календаря MCP.

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

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

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

Раздел по теме

Настройте сервер Calendar MCP.