connectwise-command-mcp

ConnectWise Command MCP-сервер — предоставляет API отчетности ConnectWise Command (Continuum) ITSupport247 в виде MCP-инструментов.

Примечание о названии: app.mspbots.ai называет эту интеграцию "ConnectWise Command (continuum)" (sys_integration.subject_code = CONTINUUM). ConnectWise приобрела Continuum и переименовала свой RMM-продукт в "ConnectWise Command"; базовый API по-прежнему размещается на устаревшем домене ITSupport247 (itsupport247.net) и документирован как "Reporting API". Этот сервер оборачивает только этот Reporting API — он не связан с ConnectWise Manage (PSA) или ConnectWise Automate.

Обзор

Этот сервер реализует Model Context Protocol (транспорт Streamable HTTP/SSE) и оборачивает каждый ресурс из официального справочника "Reporting API REST Resources" для ConnectWise Command / Continuum. Он следует Vendor MCP Service SOP от MSPbots: без сохранения состояния, без хранения учетных данных, аутентификация через заголовок при каждом запросе.

Базовый API аутентифицируется через HTTP Basic Auth (пустое имя пользователя, ключ API в качестве пароля) и возвращает JSON. Этот сервер никогда не хранит ключ — вызывающий передает его при каждом запросе через заголовок. Все имена полей запросов/ответов ниже приведены дословно из официального справочного документа, а не угаданы.

Related MCP server: nable-rmm-mcp

Быстрый старт

Docker (рекомендуется)

docker compose up --build

Сервер запускается на http://localhost:8080.

Локально (uv)

uv sync
python -m connectwise_command_mcp

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

curl http://localhost:8080/health
# {"status": "ok"}

Для конечной точки проверки работоспособности токен не требуется.

Параметры авторизации (Аутентификация)

Каждый запрос к /mcp должен включать следующий HTTP-заголовок:

Внутри сервер кодирует ключ следующим образом:

Authorization: Basic base64(":" + api_key)

В отличие от некоторых других RMM-вендоров (например, N-able), хосты Reporting API ConnectWise Command — это фиксированные публичные конечные точки, а не отдельные для каждого клиента — здесь нет поля/заголовка "URL" для настройки, что соответствует единственному полю "API Key" в форме интеграции app.mspbots.ai. Отсутствие X-ConnectWise-Command-Api-Key возвращает 401 Unauthorized.

Переменные окружения

Конечная точка MCP

POST http://localhost:8080/mcp

Подключите ваш MCP-клиент:

• Транспорт: http (Streamable HTTP / SSE)

• Заголовок: X-ConnectWise-Command-Api-Key: <api_key>

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

21 инструмент, сокращенный из исходной сборки полного API из 41 инструмента (2026-08-04). Собственная сохраненная конфигурация интеграции MSPbots для этого вендора вызывает 19 конечных точек (подтверждено через web/int/sys/integration/api/list для идентификатора интеграции 1424565871921713153), охватывающих Antivirus (7 из 7 сохранены — каждый инструмент антивируса действительно используется), Patches (4 из 4 сохранены — то же самое), Warranty (3 из 3 сохранены — то же самое), Sites/Devices (2 из 3 реально используются, сохранены все 3, так как категория небольшая), Agent/System/Software (3 из 3 сохранены — то же самое), плюс один отдельный инструмент Misc (get_score_summary, единственная конечная точка Misc, которая реально используется). Все остальное из исходной сборки из 41 инструмента — Performance (7), Availability (3), Recover for Continuity/Backup (4) и остальные 6 инструментов Misc (несоответствующие мобильные устройства, сводка по ОС, запросы на обслуживание по месяцам/неделям, SNMP-устройства, сводка по работам) — было удалено как неиспользуемое MSPbots. Если удаленный инструмент понадобится позже, официальный документ "Reporting API REST Resources" (ссылка ниже) по-прежнему его документирует, и его можно добавить заново тем же способом, которым были созданы сохраненные инструменты.

Большинство сохраненных инструментов принимают site_code (получите его сначала через connectwise_command_get_sites) плюс month/year (int); некоторые также принимают resource_type ("desktop" или "server", ограничения по ресурсам отмечены там, где документ фиксирует одно значение).

Sites, Devices & Summary

Agent / System / Software

Antivirus

Patches

Warranty

Misc

Пример тестирования

Перечислите все сайты, затем получите устройства для одного из них:

{
  "method": "tools/call",
  "params": { "name": "connectwise_command_get_sites", "arguments": {} }
}

Эквивалентный curl для запущенного сервера (конечная точка MCP со streamable HTTP):

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-ConnectWise-Command-Api-Key: <api_key>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "connectwise_command_get_sites", "arguments": {} }
  }'

Ресурс на основе месяца/года:

{
  "method": "tools/call",
  "params": {
    "name": "connectwise_command_get_cpu_utilization",
    "arguments": { "site_code": "AGTSolutions", "month": 4, "year": 2015 }
  }
}

Справочник API

• Официальная документация (портал ITSupport247, Admin > Integration > Reporting API):

  • "Getting Started with the Reporting API"

  • "Reporting API REST Resources" (полные схемы запросов/ответов по каждому ресурсу — источник всех имен полей в этом сервере)

Примечания по реализации

• Сокращено с 41 до 21 инструмента 2026-08-04. Исходная сборка охватывала каждый ресурс из официальной документации Reporting API. Более позднее решение по объему сократило ее до реально настроенных 19 конечных точек MSPbots плюс небольшие всегда сохраняемые категории Sites/Devices/Agent/System — см. раздел "Список инструментов" выше для точного обоснования и полного списка удаленных инструментов (Performance, Availability, Recover for Continuity/Backup и 6 из 7 инструментов Misc — всего 17 инструментов). Если удаленный инструмент понадобится позже, официальная документация Reporting API (ссылка ниже) по-прежнему его документирует, и его можно добавить заново тем же способом, которым были созданы сохраненные инструменты.

• Форма ошибок зависит от ресурса — некоторые ответы используют "Error" (с заглавной буквы, например, Agent Details), большинство используют "error" (со строчной буквы, например, Antivirus Summary), и позиция в ответе различается (вверху, внизу или вложено в каждый элемент). ContinuumClient._parse проверяет оба варианта написания.

• GET-ресурсы (Sites, Devices) возвращают простой JSON-массив, а не объект с ключом error.

• Имя поля запроса MachineID (используется в теле запроса для Antivirus Version Summary, Installed Software, System Information) отличается по регистру от поля ответа MachineId — оба подтверждены дословно из официальной документации.

• Функциональность, эквивалентная get_site_installation_package, для этого API не существует; здесь она неприменима (в отличие от N-able RMM).