Как подключить Cal.com к Microsoft Copilot через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Cal.com, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Cal.com + Microsoft Copilot

Читайте аккаунт планирования Cal.com из Claude, ChatGPT или Copilot: типы событий, бронирования с участниками, записи и расшифровки Cal Video, свободные слоты, расписания доступности и подключённые календари. Создание, перенос и отмена бронирований есть, но при установке отключены.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

CALCOM_API_HOST, CALCOM_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт Cal.com (любой тариф), чтобы создать личный API-ключ. Ключ действует от имени пользователя, который его создал.

1. Войдите в Cal.com и откройте Settings → Developer → API Keys (на app.cal.com или на app.cal.eu, если ваш аккаунт находится в европейском регионе Cal.com).
2. Нажмите New, задайте ключу имя (например, AnythingMCP) и срок действия и скопируйте его. Ключ начинается с cal_live_ (или cal_test_ в тестовом режиме) и показывается только один раз.
3. Вставьте только сам ключ, без слова Bearer, в CALCOM_API_KEY.
4. Укажите в CALCOM_API_HOST значение https://api.cal.com, если вы входите через app.cal.com, или https://api.cal.eu, если через app.cal.eu. Без /v2, пути и косой черты в конце: /v2 коннектор добавляет сам. Ключ работает только в своём регионе.
5. Установите коннектор и запустите calcom_get_me: он покажет пользователя, которому принадлежит ключ, с часовым поясом и расписанием по умолчанию, и подтвердит, что ключ и хост подходят друг к другу.

Чьи данные видны: типы событий, бронирования и расписания владельца ключа, а также командные бронирования, где этот пользователь хост или администратор. Все, кто пользуется коннектором, работают с этим одним аккаунтом, поэтому берите ключ того человека (или администратора команды), чьи встречи должен видеть ИИ.

Что он читает: ваши типы событий (шаблоны встреч, которые можно забронировать) с длительностью, местами проведения, полями формы бронирования, буферами, минимальным сроком до встречи и ссылкой на бронирование; бронирования со статусом, временем, ссылкой на встречу, хостами, участниками с email и часовым поясом, гостями и ответами на вопросы формы; записи и расшифровки Cal Video по бронированию; свободные слоты типа события; ваши расписания доступности с рабочими часами по дням недели и исключениями по датам; и подключённые календари (Google, Outlook, Apple, CalDAV), включая те, что проверяются на пересечения, и тот, в который записываются новые бронирования.

uid бронирования, а не id: инструменты бронирований принимают uid, строку, которую ИИ берёт из calcom_list_bookings, а не числовой id. uid повторяющегося бронирования возвращает все его повторы. Бронирования фильтруются по статусу (upcoming, past, cancelled, unconfirmed), участнику, типу события, команде или датам и приходят постранично.

Часовые пояса: свободные слоты возвращаются в том часовом поясе, в котором вы мыслите и который ИИ передаёт в calcom_get_available_slots, а время начала бронирования уходит в Cal.com в UTC. В слотах уже учтены ваши календари, буферы, минимальный срок до встречи и лимиты.

Записи и расшифровки: они есть только у встреч в Cal Video, и читать их могут только организатор, администратор команды или администратор организации. У встреч в Zoom, Google Meet или Teams их здесь нет. Расшифровка появляется, если кто-то нажал Transcribe во время звонка, а ссылка на её скачивание действует один час, поэтому при необходимости ИИ запрашивает новую.

Отключено при установке: calcom_create_booking, calcom_reschedule_booking и calcom_cancel_booking. Они отправляют письма реальным участникам и меняют реальные календари: новое бронирование рассылает подтверждения и приглашения (платные типы событий могут попросить участника оплатить), перенос отменяет старое бронирование и создаёт новое с новым uid, а отмену нельзя откатить (у повторяющегося бронирования отменяются все повторы). Администратор может включать их по одному.

Спрашивает перед каждым изменением: когда инструмент записи включён, ИИ сначала проверяет время через calcom_get_available_slots, затем показывает тип события, время в вашем часовом поясе, участника и гостей или причину и ждёт вашего согласия.

Ограничения: Cal.com допускает около 120 запросов в минуту на один API-ключ. После ответа 429 ИИ ждёт минуту и пробует снова.

Частые ошибки: 401 Invalid API Key означает, что ключ неверный, истёк, удалён или относится к другому региону. 403 означает, что ключ работает, но этот пользователь не видит это бронирование, тип события или команду: используйте ключ организатора или администратора команды. 404 обычно значит, что вместо uid бронирования передан числовой id. При 400 Cal.com называет поле, которое не принял, чаще всего это время начала, не совпадающее со свободным слотом.

Коннектор не меняет типы событий, расписания доступности и подключённые календари, не принимает и не возвращает платежи.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Microsoft Copilot

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Cal.com.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Какие встречи у меня завтра и кто участвует в каждой?»
• «Найди на следующей неделе три свободных слота для моего типа события Знакомство по московскому времени, чтобы предложить их клиенту.»
• «Возьми расшифровку вчерашнего звонка с ООО Вектор и выпиши задачи, о которых мы договорились.»
• «Какие бронирования в этом месяце отменили или перенесли и какие причины указали?»
• «Какие у меня рабочие часы в расписании по умолчанию и какие календари Cal.com проверяет на пересечения?»

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse