connectwise-command-mcp

ConnectWise Command MCP-Server — stellt die ConnectWise Command (Continuum) ITSupport247 Reporting API als MCP-Tools bereit.

Hinweis zur Benennung: app.mspbots.ai nennt diese Integration "ConnectWise Command (continuum)" (sys_integration.subject_code = CONTINUUM). ConnectWise hat Continuum übernommen und sein RMM-Produkt in "ConnectWise Command" umbenannt; die zugrunde liegende API wird weiterhin auf der Legacy-Domain ITSupport247 (itsupport247.net) gehostet und als "Reporting API" dokumentiert. Dieser Server kapselt nur diese Reporting API – er hat nichts mit ConnectWise Manage (PSA) oder ConnectWise Automate zu tun.

Übersicht

Dieser Server implementiert das Model Context Protocol (Streamable HTTP/SSE-Transport) und kapselt jede Ressource in der offiziellen "Reporting API REST Resources"-Referenz für ConnectWise Command / Continuum. Er folgt der Vendor MCP Service SOP von MSPbots: zustandslos, keine gespeicherten Anmeldeinformationen, Header-Authentifizierung pro Anfrage.

Die zugrunde liegende API authentifiziert über HTTP Basic Auth (leerer Benutzername, API-Schlüssel als Passwort) und gibt JSON zurück. Dieser Server speichert den Schlüssel nie – der Aufrufer übergibt ihn pro Anfrage über einen Header. Alle unten aufgeführten Anfrage-/Antwortfeldnamen sind wörtlich aus der offiziellen Referenzdokumentation übernommen, nicht geraten.

Related MCP server: nable-rmm-mcp

Schnellstart

Docker (empfohlen)

docker compose up --build

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

Lokal (uv)

uv sync
python -m connectwise_command_mcp

Gesundheitscheck

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

Für den Gesundheitsendpunkt ist kein Token erforderlich.

Authentifizierungsparameter (Authentication)

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

Intern kodiert dieser Server den Schlüssel wie folgt:

Authorization: Basic base64(":" + api_key)

Im Gegensatz zu einigen anderen RMM-Anbietern (z. B. N-able) sind die Hosts der Reporting API von ConnectWise Command feste öffentliche Endpunkte, nicht pro Mandant – es gibt kein "URL"-Feld bzw. keinen Header zu konfigurieren, was dem einzelnen "API Key"-Feld im Integrationsformular von app.mspbots.ai entspricht. Fehlt X-ConnectWise-Command-Api-Key, wird 401 Unauthorized zurückgegeben.

Umgebungsvariablen

MCP-Endpunkt

POST http://localhost:8080/mcp

Verbinden Sie Ihren MCP-Client mit:

• Transport: http (Streamable HTTP / SSE)

• Header: X-ConnectWise-Command-Api-Key: <api_key>

Tool-Liste

21 Tools, reduziert von einem ursprünglichen 41-Tool-Voll-API-Build (2026-08-04). Die gespeicherte Integrationskonfiguration von MSPbots für diesen Anbieter ruft 19 Endpunkte auf (bestätigt über web/int/sys/integration/api/list gegen Integrations-ID 1424565871921713153), die sich über Antivirus (7 von 7 behalten – jedes Antivirus-Tool wird tatsächlich verwendet), Patches (4 von 4 behalten – ebenso), Garantie (3 von 3 behalten – ebenso), Sites/Devices (2 von 3 tatsächlich verwendet, alle 3 behalten, da die Kategorie klein ist), Agent/System/Software (3 von 3 behalten – ebenso) sowie ein einzelnes Misc-Tool (get_score_summary, der einzige tatsächlich verwendete Misc-Endpunkt) erstrecken. Alles andere aus dem ursprünglichen 41-Tool-Build – Performance (7), Availability (3), Recover for Continuity/Backup (4) und die anderen 6 Misc-Tools (nicht konforme mobile Geräte, OS-Zusammenfassung, Serviceanfragen nach Monat/Woche, SNMP-Geräte, Arbeitszusammenfassung) – wurde als von MSPbots ungenutzt entfernt. Falls ein entferntes Tool später benötigt wird, ist es in der offiziellen "Reporting API REST Resources"-Dokumentation (unten verlinkt) weiterhin dokumentiert und kann auf die gleiche Weise wie die behaltenen Tools wieder hinzugefügt werden.

Die meisten behaltenen Tools akzeptieren site_code (zuerst von connectwise_command_get_sites abrufen) plus month/year (int); einige akzeptieren auch resource_type ("desktop" oder "server", wobei ressourcenspezifische Einschränkungen dort vermerkt sind, wo die Dokumentation es auf einen Wert festlegt).

Sites, Devices & Zusammenfassung

Agent / System / Software

Antivirus

Patches

Garantie

Sonstiges

Testbeispiel (Test Example)

Alle Standorte auflisten, dann Geräte für einen abrufen:

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

Äquivalentes curl gegen den laufenden Server (Streamable HTTP MCP-Endpunkt):

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

Eine Ressource basierend auf Monat/Jahr:

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

API-Referenz

• Offizielle Dokumentation (ITSupport247-Portal, Admin > Integration > Reporting API):

  • "Getting Started with the Reporting API"

  • "Reporting API REST Resources" (vollständige Anfrage-/Antwortschemata pro Ressource – Quelle jedes Feldnamens in diesem Server)

Implementierungshinweise

• Am 2026-08-04 von 41 auf 21 Tools reduziert. Der ursprüngliche Build deckte jede Ressource in der offiziellen Reporting-API-Dokumentation ab. Eine spätere Entscheidung zum Umfang reduzierte dies auf die tatsächlich konfigurierten 19 Endpunkte von MSPbots plus die kleinen, immer beibehaltenen Kategorien Sites/Devices/Agent/System – siehe den Abschnitt Tool-Liste oben für die genaue Begründung und die vollständige Liste der entfernten Tools (Performance, Availability, Recover for Continuity/Backup und 6 von 7 Misc-Tools – insgesamt 17 Tools). Falls ein entferntes Tool später benötigt wird, ist es in der offiziellen Reporting-API-Dokumentation (unten verlinkt) weiterhin dokumentiert und kann auf die gleiche Weise wie die beibehaltenen Tools wieder hinzugefügt werden.

• Die Fehlerstruktur variiert je nach Ressource – einige Antworten verwenden "Error" (großgeschrieben, z. B. Agent Details), die meisten verwenden "error" (kleingeschrieben, z. B. Antivirus Summary), und die Position in der Antwort variiert (oben, unten oder verschachtelt pro Element). ContinuumClient._parse prüft beide Schreibweisen.

• GET-Ressourcen (Sites, Devices) geben ein reines JSON-Array zurück, kein Objekt mit einem error-Schlüssel.

• Der Anfragefeldname MachineID (im Anfragetext für Antivirus Version Summary, Installed Software, System Information verwendet) unterscheidet sich in der Groß-/Kleinschreibung vom Antwortfeld MachineId – beide wurden wörtlich aus der offiziellen Dokumentation bestätigt.

• Eine get_site_installation_package-äquivalente Funktionalität existiert für diese API nicht; hier nicht anwendbar (anders als bei N-able RMM).