MCP — управление бронированиями через AI-ассистента

planerka-api MCP — это MCP-сервер (Model Context Protocol) поверх API Планёрки. Он позволяет AI-ассистентам — Claude Code, Claude Desktop, Cursor и любым другим MCP-клиентам — работать с бронированиями напрямую: смотреть типы встреч, находить свободные слоты, создавать и отменять брони. Обычным человеческим языком, без ручных запросов к REST API.

Все операции выполняются от имени владельца API-ключа: ассистент видит и меняет только то, что доступно этому аккаунту.

Как подключиться

Адрес сервера https://planerka.utka.top/_mcp временный — он работает на период BETA тестирования и позже изменится на продуктовый. Следите за обновлениями этой статьи.

1. Получите API-ключ. Откройте в личном кабинете страницу «API-ключи» и создайте новый ключ. Он выглядит как cal_….

2. Добавьте сервер в свой MCP-клиент.

Claude Code — одной командой:

claude mcp add --transport http planerka-api https://planerka.utka.top/_mcp \
  --header "Authorization: Bearer cal_ВАШ_КЛЮЧ"

Универсальный JSON (Cursor, Claude Desktop и другие):

{
  "mcpServers": {
    "planerka-api": {
      "type": "http",
      "url": "https://planerka.utka.top/_mcp",
      "headers": {
        "Authorization": "Bearer cal_ВАШ_КЛЮЧ"
      }
    }
  }
}

3. Проверьте подключение. В Claude Code команда /mcp должна показать planerka-api ✔ connected, а в списке инструментов появятся 6 инструментов.

Какие инструменты доступны

Инструмент	Что делает
list_event_types	Список ваших типов встреч (id, slug, название, длительность)
get_available_slots	Свободные слоты в окне дат — нужны start, end и eventTypeId (или eventTypeSlug + username), таймзона в формате IANA
create_booking	Создать бронь — start (ISO-8601), имя участника, его таймзона и email или телефон
list_bookings	Список броней с фильтрами: upcoming / past / cancelled / unconfirmed
get_booking	Детали брони по её uid
cancel_booking	Отменить бронь по uid, можно с причиной

Типовой сценарий

Пользователь просто пишет ассистенту, например:

«Найди свободный слот на консультацию на этой неделе и запиши Ивана Петрова, ivan@example.com, таймзона Москва»

Ассистент сам выстроит цепочку: list_event_types → get_available_slots → create_booking — и вернёт подтверждение с датой и ссылкой на встречу.

Ссылка на встречу создаётся асинхронно. Сразу после create_booking поле meetingUrl может быть ещё пустым — ссылка появляется через секунду-другую. Если она нужна немедленно, запросите бронь повторно через get_booking: к этому моменту ссылка уже будет на месте.