connectwise-asio-mcp

ConnectWise Asio MCP-сервер — предоставляет API-интерфейсы платформы ConnectWise (текущий API на базе ConnectWise Asio, ранее SolarWinds MSP/N-central-совместимого RMM) в виде инструментов MCP.

Примечание о названии: приложение app.mspbots.ai называет эту интеграцию «ConnectWise Asio» (sys_integration.subject_code = CWASIO). Это отдельный продукт от ConnectWise Command (Continuum), ConnectWise Manage (PSA) и ConnectWise Automate — у каждого из них есть свой MCP-сервер в этой группе. Базовый API официально называется «ConnectWise Platform APIs» в его спецификации OpenAPI (developer.connectwise.com — документация «REST API» в разделе Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks).

Обзор

Этот сервер реализует Model Context Protocol (транспорт Streamable HTTP/SSE) и оборачивает API-интерфейсы платформы ConnectWise — 25 инструментов в 5 категориях (devices, companies_contacts, custom_fields, patching, automation), сокращённых до фактически настроенных 23 конечных точек MSPbots плюс базовые операции CRUD (см. список инструментов ниже; изначально это была сборка полного API из 107 операций в 24 категориях тегов). Он следует стандарту Vendor MCP Service SOP MSPbots: без сохранения состояния, без хранения учётных данных, аутентификация по заголовкам для каждого запроса.

Базовый API аутентифицируется через OAuth2 Client Credentials. Этот сервер не выполняет обмен токенами сам — он получает уже полученный bearer-токен доступа для каждого запроса (как и другие интеграции с OAuth-потоком, например Microsoft Graph, обрабатываются в этой группе MCP MSPbots: шлюз создаёт/обновляет токен из client_id/client_secret/scope, и до этого сервера доходит только итоговый токен).

Related MCP server: mcp-connectwise-psa

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

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

docker compose up --build

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

Локально (uv)

uv sync
python -m connectwise_asio_mcp

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

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

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

Параметры аутентификации

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

Если заголовок X-ConnectWise-Asio-Token отсутствует, возвращается 401 Unauthorized.

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

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

POST http://localhost:8080/mcp

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

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

• Заголовки: X-ConnectWise-Asio-Token: <access_token> (обязательно), X-ConnectWise-Asio-Base-Url: <base_url> (необязательно)

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

25 инструментов, сокращённых из первоначальной сборки полного API на 104 инструмента (2026-08-04). Конфигурация интеграции этого поставщика, хранящаяся в MSPbots, вызывает 23 конечные точки в 6 базовых категориях ресурсов (устройства/конечные точки, компании, сайты, настраиваемые поля, патчинг, автоматизация) — каждая из этих 23 настроенных конечных точек (включая отдельные варианты путей v1/v2, которые сводятся к одному инструменту) соответствует инструменту, сохранённому ниже, и помечается именем соответствующей конечной точки. Всё остальное из первоначальной сборки на 104 инструмента (Tickets — самая крупная категория из 24 инструментов, Policy/Policy Group/Package, Mapping, Alerting & Incidents, Backup Dashboard, Misc — 6 категорий, ~79 инструментов) было удалено как неиспользуемое MSPbots. Если позже понадобится удалённая категория, точные операции по-прежнему описаны в спецификации OpenAPI поставщика (ссылка ниже), и их можно добавить тем же способом, которым были созданы сохранённые инструменты.

Известный пробел, перенесённый из первоначальной сборки: MSPbots настроил две конечные точки — «ConnectWise Asio Suspension» (GET /v2/alerting/suspensions) и «ConnectWise Asio Suspension Details» (GET /v2/alerting/suspensions/{ruleid}) — для которых нет соответствующего инструмента в этом сервере (в первоначальной сборке на 104 инструмента категория alerting реализовывала только операции create/update/delete/post-incident, но никогда не read-запрос GET-suspension). Этот пробел существовал до сокращения и не был им вызван; он отмечен здесь, поскольку теперь более заметен при меньшем количестве инструментов. См. раздел «Известные пробелы» ниже.

Компании и контакты (6)

Настраиваемые поля (6)

Устройства и конечные точки (9)

Патчи (3)

Автоматизация (1)

Тестовый пример (Test Example)

Получите список компаний, а затем их площадки:

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

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

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-ConnectWise-Asio-Token: <access_token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "connectwise_asio_get_companies", "arguments": {} }
  }'

Параметризованный вызов:

{
  "method": "tools/call",
  "params": {
    "name": "connectwise_asio_get_endpoint_cpu_usage",
    "arguments": { "endpoint_id": "abc-123" }
  }
}

Справочник по API

• Официальная документация (ConnectWise Developer Network — требуется вход в систему): Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks > REST API

• Базовые URL: NA https://openapi.service.itsupport247.net, EU https://openapi.service.euplatform.connectwise.com, AU https://openapi.service.auplatform.connectwise.com

Известные пробелы / Пока не проверено

• Сокращено со 104 до 25 инструментов 2026-08-04. Первоначальная сборка охватывала полную спецификацию ConnectWise Platform APIs в соответствии с ранее принятым решением об объёме. Более позднее решение об объёме сократило её до категорий, которые фактически использует MSPbots, — см. раздел «Список инструментов» выше: там точное сопоставление endpoint→tool и полный список 6 удалённых категорий (~79 инструментов, включая категорию tickets из 24 инструментов — самую крупную в исходной сборке). Если удалённая категория понадобится позже, OpenAPI-спецификация вендора (ссылка ниже) по-прежнему описывает её точные операции, и их можно добавить повторно тем же способом, которым были сгенерированы сохранённые инструменты.

• У настроенных в MSPbots конечных точек «Suspension»/«Suspension Details» нет соответствующего инструмента — этот пробел существовал ещё до сокращения (в исходной сборке из 104 инструментов категория alerting никогда не реализовывала операцию чтения GET-suspension, только create/update/delete/post-incident) и не был вызван этим сокращением. Если данные о приостановках действительно нужны, это потребуется добавить из OpenAPI-спецификации вендора.

• Пока не проверено на реальном аккаунте ConnectWise Asio — выполнена только проверка на уровне протокола (health check, 401 при отсутствии токена, tools/list возвращает все 25 инструментов).

• connectwise_asio_update_company_custom_fields и connectwise_asio_create_company принимают обобщённый параметр body: dict вместо полностью развёрнутых именованных аргументов — в docstring перечислены обязательные поля верхнего уровня, но структуру вложенных объектов следует сверять с реальным API при первом использовании.