⏰ TimeZest MCP Server

Передавайте данные планирования TimeZest напрямую в Claude через Model Context Protocol (MCP). Выполняйте поиск встреч в реальном времени, получайте сводки по инженерам и управляйте расписанием по тикетам — всё на естественном языке.

Registry ID: io.github.sagarkalra-tech/timezest-mcp

🌟 Зачем нужен TimeZest MCP?

Если вы управляете командой, которая использует TimeZest вместе с ConnectWise, вы знаете эту боль: переключение между вкладками, ручная проверка того, кто занят, поиск незабронированных запросов на планирование и сверка с номерами тикетов.

Этот MCP-сервер превращает Claude в ассистента по планированию, который умеет:

• 🗓️ Предоставлять утреннюю сводку сегодняшних подтверждённых встреч, сгруппированных по инженерам

• 🔍 Находить встречи по номеру тикета — просто скажите «найди встречи для тикета #964400»

• ⏳ Показывать стареющие незабронированные запросы, требующие внимания

• 📊 Формировать сводную статистику по планированию по всей команде

• 🕐 Обеспечивать отчётность с точным учётом часовых поясов для глобальных MSP-команд — actually let me correct that: "Обеспечивать отчётность с точным учётом часовых поясов для глобальных MSP-команд" — no, need to be careful. I meant to write correctly. Let me now produce a clean final version.

Actually I need to output final. In my previous attempt I started to write a final but with some hesitation. I should just output the clean translation. Let me reset and provide final answer.# TimeZest MCP Server

[ [ []

Передавайте данные планирования TimeZest напрямую в Claude через Model Context Protocol (MCP). Выполняйте поиск встреч в реальном времени, получайте сводки по инженерам и управляйте расписанием по тикетам — всё на естественном язые.

Registry ID: io.github.sagarkalra-tech/timezest-mcp

Related MCP server: AutotaskMCP

🌟 Зачем нужен TimeZest MCP?

Если вы управяете команой, которая использует TimeZest вместе с ConnectWise, вы знаете эту боль: переключение межд вкладками, ручная проверка того, кто занят, поиск незабронированных запросов на планирование и сверка с номерами тикетов.

Этот MCP-сервер превращает Claude в ассистента по планированию, который умеет:

• ️ Преоставлять утреннюю сводку сегодняшних подтверждённых встреч, сгруппированных по инженерам

• 🔍 Находить встречи по номеру тикета — просто скажите «найди встречи для тикета #964400»

• ⏳ Показывать стареющие незабронированные запросы, требующие внимания

• 📊 Формировать сводную статистику по планированию по всей команде

• 🕐 Обеспечивать отчётность с точным учётом часовых поясов для глобальных MSP-команд

🚀 Начало работы за 30 секунд

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

• Node.js 20+ — Скачать здесь

• API-ключ TimeZest — находится в TimeZest → Settings → API

Вариант 1: Claude Desktop (рекомендуется)

Добавьте это в файл конфигурации Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "timezest": {
      "command": "npx",
      "args": ["-y", "timezest-mcp@latest"],
      "env": {
        "TIMEZEST_API_KEY": "your-timezest-api-key-here"
      }
    }
  }
}

Перезапустите Claude Desktop. Готово.

Вариант 2: Claude Code CLI

claude mcp add-json timezest-mcp '{
  "command": "npx",
  "args": ["-y", "timezest-mcp@latest"],
  "env": {
    "TIMEZEST_API_KEY": "your-timezest-api-key-here"
  }
}'

Вариант 3: VS Code (Copilot)

Добавьте в ваш .vscode/settings.json или в пользовательские настройки:

{
  "mcp": {
    "servers": {
      "timezest": {
        "command": "npx",
        "args": ["-y", "timezest-mcp@latest"],
        "env": {
          "TIMEZEST_API_KEY": "your-timezest-api-key-here"
        }
      }
    }
  }
}

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

Сервер предоставляет 8 специализированных инструментов, которые Claude может вызывать:

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

После подключения просто общайтесь с Claude естественно:

"Who are my top engineers today and what are they booked for?"

"Find any TimeZest requests for ticket #964400."

"Give me a morning briefing of today's confirmed vs. unbooked requests."

"Show me all pending scheduling requests older than 48 hours."

"What's the scheduling volume breakdown for the last two weeks?"

"Pull up Sarah's schedule for the next 5 days."

"List all cancelled appointments from last week — any we should rebook?"

⚙️ Конфигурация

🏗️ Архитектура

┌─────────────────────────────────────────────────────────────────┐
│                        MCP CLIENT (Claude)                      │
│        Desktop App  •  Claude Code CLI  •  IDE Plugin           │
└──────────────────────────┬──────────────────────────────────────┘
                           │ Stdio (JSON-RPC)
┌──────────────────────────▼──────────────────────────────────────┐
│                     TIMEZEST MCP SERVER                         │
│                                                                 │
│  ┌──────────────┐  ┌──────────────┐                             │
│  │ Tool Handler │  │  MCP SDK     │  (index.ts)                 │
│  │ (8 Tools)    │  │  Registry    │                             │
│  └──────┬───────┘  └──────────────┘                             │
│         │                                                       │
│  ┌──────▼────────────────────────────────────────────────────┐  │
│  │                 TIMEZEST API CLIENT                        │  │
│  │  Pagination • Retry Logic • Rate Limit Management         │  │
│  └──────────────────────┬────────────────────────────────────┘  │
│                         │ (client.ts)                            │
│  ┌──────────────────────▼────────────────────────────────────┐  │
│  │               DATA TRANSFORMATION LAYER                    │  │
│  │  Timezone Math • Engineer Mapping • Ticket Linking         │  │
│  └────────────────────────────────────────────────────────────┘  │
│                         │ (utils/)                               │
└─────────────────────────┼────────────────────────────────────────┘
                          │ HTTPS / REST
┌─────────────────────────▼──────────────────────────────────────┐
│                      TIMEZEST API (v1)                          │
│       Scheduling Requests • Appointment Types • Resources       │
└─────────────────────────────────────────────────────────────────┘

Ключевые архитектурные решения

• Только чтение: намеренно реализован режим только для чтения — никаких изменений ваших данных планирования

• Отказоустойчивый клиент: экспоненциальная задержка с автоматической поддержкой заголовка Retry-After для ошибок 429/5xx

• Глубокая пагинация: рекурсивно обходит все страницы (порциями по 50 элементов) для формирования полных наборов данных

• Точность часовых поясов: преобразует Unix-метки времени в строгий ISO с локализованными строками отображения на основе идентификаторов часовых поясов IANA

• Определение инженера: использует поиск с «наивысшей уверенностью» — сначала проверяет scheduled_agents, затем обращается к resources

• Тёплый кэш: типы встреч кэшируются после первого запроса для снижения нагрузки на API

🧪 Тестирование

Сервер поставляется с комплексным набором тестов Vitest — 22 теста в 3 файлах:

Все тесты используют имитированные ответы API — без реальных вызовов API, секреты не нужны.

npm test            # Single run
npm run test:watch  # Re-runs on file save

🔒 Безопасность и доверие

• Происхождение NPM-пакетов: каждый релиз криптографически подписывается через GitHub Actions OIDC

• Конвейер CI/CD: автоматическая сборка → тестирование → публикация по тегам релизов (без ручного npm publish)

• Никаких секретов в CI: тесты не требуют API-ключей — полностью детерминированы благодаря имитированным ответам

• Матрица Node.js: протестировано на Node 20 (LTS) и 22 (Current)

📦 Распространение

🤝 Участие в разработке

1. Сделайте форк репозитория

2. Создайте ветку функции (git checkout -b feat/my-feature)

3. Внесите изменения и убедитесь, что тесты проходят (npm test)

4. Отправьте pull request

Подробное описание потоков данных, архитектуры компонентов и логики преобразования см. в ARCHITECTURE.md.

📄 Лицензия

MIT © 2026 Sagar Kalra