connectwise-asio-mcp

ConnectWise Asio-MCP-Server – stellt die ConnectWise-Platform-APIs (die „Current API“ hinter ConnectWise Asio, früher SolarWinds MSP/N-central-nahes RMM) als MCP-Tools bereit.

Hinweis zur Benennung: app.mspbots.ai nennt diese Integration „ConnectWise Asio“ (sys_integration.subject_code = CWASIO). Es ist ein eigenständiges Produkt, getrennt von ConnectWise Command (Continuum), ConnectWise Manage (PSA) und ConnectWise Automate – jedes hat seinen eigenen MCP-Server in dieser Flotte. Die zugrunde liegende API heißt offiziell „ConnectWise Platform APIs“ in ihrer OpenAPI-Spezifikation (developer.connectwise.com – Dokument „REST API“ unter Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks).

Übersicht

Dieser Server implementiert das Model Context Protocol (Streamable-HTTP/SSE-Transport) und kapselt die ConnectWise-Platform-APIs – 25 Tools in 5 Kategorien (devices, companies_contacts, custom_fields, patching, automation), reduziert auf die tatsächlich konfigurierten 23 Endpunkte von MSPbots sowie minimales Kern-CRUD (siehe Tool-Liste unten; ursprünglich ein Voll-API-Build mit 107 Operationen in 24 Tag-Kategorien). Er folgt der MSPbots-SOP für Vendor-MCP-Services: zustandslos, keine gespeicherten Anmeldedaten, Authentifizierung über Header pro Anfrage.

Die zugrunde liegende API authentifiziert über OAuth2-Client-Anmeldedaten. Dieser Server führt den Token-Austausch nicht selbst durch – er erhält pro Anfrage ein bereits erlangtes Bearer-Zugriffstoken (entsprechend der Behandlung anderer OAuth-Integrationen, z. B. Microsoft Graph, in dieser MSPbots-MCP-Flotte: Das Gateway erstellt/aktualisiert das Token aus client_id/client_secret/scope, und nur das resultierende Token erreicht diesen Server).

Related MCP server: mcp-connectwise-psa

Schnellstart

Docker (empfohlen)

docker compose up --build

Der Server startet auf http://localhost:8080.

Lokal (uv)

uv sync
python -m connectwise_asio_mcp

Gesundheitscheck

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

Für den Health-Endpunkt ist kein Token erforderlich.

Authentifizierungsparameter (Authentication)

Jede Anfrage an /mcp muss die folgenden HTTP-Header enthalten:

Fehlt X-ConnectWise-Asio-Token, wird 401 Unauthorized zurückgegeben.

Umgebungsvariablen

MCP-Endpunkt

POST http://localhost:8080/mcp

Verbinden Sie Ihren MCP-Client wie folgt:

• Transport: http (Streamable HTTP / SSE)

• Header: X-ConnectWise-Asio-Token: <access_token> (erforderlich), X-ConnectWise-Asio-Base-Url: <base_url> (optional)

Tool-Liste

25 Tools, reduziert gegenüber einem ursprünglichen Voll-API-Build mit 104 Tools (2026-08-04). Die von MSPbots gespeicherte Integrationskonfiguration für diesen Anbieter ruft 23 Endpunkte in 6 zugrunde liegenden Ressourcenkategorien auf (Geräte/Endpunkte, Firmen, Standorte, benutzerdefinierte Felder, Patchen, Automatisierung) – jeder dieser 23 konfigurierten Endpunkte (einschließlich separater v1/v2-Pfadvarianten, die hier auf dasselbe Tool abgebildet werden) ist einem unten aufgeführten Tool zugeordnet und mit dem entsprechenden Endpunktnamen markiert. Alles andere aus dem ursprünglichen 104-Tool-Build (Tickets – mit 24 Tools die mit Abstand größte Kategorie, Policy/Policy Group/Package, Mapping, Alerting & Incidents, Backup Dashboard, Sonstiges – 6 Kategorien, ~79 Tools) wurde entfernt, da es von MSPbots nicht verwendet wird. Falls eine entfernte Kategorie später benötigt wird, dokumentiert die OpenAPI-Spezifikation des Anbieters (unten verlinkt) weiterhin die genauen Operationen, und sie können auf demselben Weg wieder hinzugefügt werden, wie die beibehaltenen Tools erzeugt wurden.

Bekannte Lücke aus dem ursprünglichen Build übernommen: MSPbots hat zwei Endpunkte konfiguriert – „ConnectWise Asio Suspension“ (GET /v2/alerting/suspensions) und „ConnectWise Asio Suspension Details“ (GET /v2/alerting/suspensions/{ruleid}) – für die es in diesem Server überhaupt kein entsprechendes Tool gibt (die Kategorie alerting des ursprünglichen 104-Tool-Builds implementierte nur Create/Update/Delete/Post-Incident-Operationen, nie einen GET-Suspension-Read). Diese Lücke bestand bereits vor der Kürzung und wurde nicht durch sie verursacht; sie wird hier erwähnt, weil sie bei der kleineren Tool-Anzahl nun deutlicher sichtbar ist. Siehe Bekannte Lücken unten.

Firmen & Kontakte (6)

Benutzerdefinierte Felder (6)

Geräte & Endpunkte (9)

Patchverwaltung (3)

Automatisierung (1)

Testbeispiel (Test Example)

Rufen Sie eine Firmenliste und anschließend deren Standorte ab:

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

Entsprechender curl-Aufruf gegen den laufenden Server (streamfähiger HTTP-MCP-Endpunkt):

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": {} }
  }'

Ein parametrisierter Aufruf:

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

API-Referenz

• Offizielle Dokumentation (ConnectWise Developer Network — Anmeldung erforderlich): Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks > REST API

• Basis-URLs: NA https://openapi.service.itsupport247.net, EU https://openapi.service.euplatform.connectwise.com, AU https://openapi.service.auplatform.connectwise.com

Bekannte Lücken / Noch nicht verifiziert

• Am 04.08.2026 von 104 auf 25 Tools reduziert. Der ursprüngliche Build deckte die vollständige Spezifikation der ConnectWise-Platform-APIs gemäß einer früheren Scope-Entscheidung ab. Eine spätere Scope-Entscheidung reduzierte dies auf die tatsächlich von MSPbots verwendeten Kategorien — siehe den Abschnitt Tool-Liste oben für die genaue Endpunkt→Tool-Zuordnung und die vollständige Liste der 6 entfernten Kategorien (~79 Tools, einschließlich der 24-Tool-Kategorie tickets, der mit Abstand größten im ursprünglichen Build). Falls später eine entfernte Kategorie benötigt wird, dokumentiert die OpenAPI-Spezifikation des Anbieters (unten verlinkt) weiterhin deren exakte Operationen, und sie können auf dieselbe Weise wieder hinzugefügt werden, wie die beibehaltenen Tools erzeugt wurden.

• Die von MSPbots konfigurierten Endpunkte "Suspension"/"Suspension Details" haben kein entsprechendes Tool — diese Lücke bestand bereits vor der Kürzung (die alerting-Kategorie des ursprünglichen 104-Tool-Builds hat nie eine GET-Suspension-Leseoperation implementiert, sondern nur create/update/delete/post-incident) und wurde nicht durch sie verursacht. Falls Suspensionsdaten tatsächlich benötigt werden, müsste dies aus der OpenAPI-Spezifikation des Anbieters ergänzt werden.

• Noch nicht gegen ein Live-ConnectWise-Asio-Konto getestet — bisher wurde nur eine Verifizierung auf Protokollebene durchgeführt (Health-Check, 401 bei fehlendem Token, tools/list gibt alle 25 Tools zurück).

• connectwise_asio_update_company_custom_fields und connectwise_asio_create_company akzeptieren einen generischen Parameter body: dict anstelle von vollständig flachen benannten Argumenten — der Docstring listet die erforderlichen Top-Level-Felder auf, aber die Formen verschachtelter Objekte sollten bei der ersten Verwendung gegen die Live-API abgeglichen werden.