nable-rmm-mcp
nable-rmm-mcp
N-able RMM MCP-Server — stellt die N-able RMM Data Extraction API als MCP-Tools bereit.
Hinweis zur Benennung: Diese Integration heißt in app.mspbots.ai "N-able RMM" (
sys_integration.subject_code = SOLARWIND— ursprünglich war es SolarWinds RMM). N-ables eigene öffentliche Entwicklerdokumentation nennt dasselbe Produkt "N-sight" (https://developer.n-able.com/n-sight/docs/...). Dies ist ein anderes Produkt als N-able N-Central, das in app.mspbots.ai eine separate Integration mit eigener API ist. Dieser Server kapselt ausschließlich N-sight/N-able RMM.
Überblick
Dieser Server implementiert das Model Context Protocol (Streamable HTTP/SSE-Transport) und kapselt die N-sight API (die API hinter der Integration "N-able RMM"). Er folgt der MSPbots Vendor MCP Service SOP: zustandslos, keine gespeicherten Anmeldedaten, Header-Authentifizierung pro Anfrage.
Die zugrunde liegende API authentifiziert sich selbst über einen apikey-Query-Parameter und gibt XML zurück. Dieser Server speichert diesen Schlüssel nie — der Aufrufer übergibt ihn pro Anfrage über einen Header, und jede Tool-Antwort ist das zur besseren Lesbarkeit in JSON konvertierte XML.
Related MCP server: Datto RMM MCP Server
Schnellstart
Docker (empfohlen)
docker compose up --buildDer Server startet auf http://localhost:8080.
Lokal (uv)
uv sync
python -m nable_rmm_mcpHealth Check
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. Die Benennung der Header spiegelt die Felder des bestehenden Integrationsformulars "N-able RMM" in app.mspbots.ai wider (API Token / URL).
Header | Typ | Erforderlich | Standardwert | Enum-Werte | Feldbeschreibung | Beispiel |
| string | Erforderlich | Keiner | Keiner (Freitext) | N-able-RMM-API-Key, erzeugt unter Settings > General Settings > API > Generate. Wenn der Key auf eine Kundengruppe beschränkt ist, liefert der Aufruf nur Daten der Kunden dieser Gruppe zurück. |
|
| string | Optional |
| Siehe Liste der 11 Regionsserver unten | N-able RMM ist je nach Region des Kontos auf 11 unabhängige Server verteilt. Ohne diesen Header wird der Standardwert der Umgebungsvariable verwendet; wenn das Gateway gleichzeitig Mandanten aus mehreren Regionen bedient, wird er pro Anfrage überschrieben. |
|
Die 11 Enum-Werte von X-Nable-Server (Region → Base URL):
Region | Base URL |
Americas (default) |
|
Asia |
|
Australia |
|
Europe |
|
France |
|
France1 |
|
Germany |
|
Ireland |
|
Poland |
|
United Kingdom |
|
United States |
|
Fehlt X-Nable-Api-Token, wird 401 Unauthorized zurückgegeben. N-able RMM begrenzt automatisierte Aufrufe außerdem auf 60 Anfragen/Minute pro Schlüssel — dieser Server drosselt nicht für Sie, also planen Sie Massenaufrufe entsprechend.
Umgebungsvariablen
Variable | Standardwert | Beschreibung |
|
| Lauschender Port |
|
| Lauschender Host |
|
| Standard-Regionsserver; pro Anfrage mit |
MCP-Endpunkt
POST http://localhost:8080/mcpVerbinden Sie Ihren MCP-Client wie folgt:
Transport:
http(Streamable HTTP / SSE)Header:
X-Nable-Api-Token: <api_key>(erforderlich),X-Nable-Server: <base_url>(optional)
Tool-Liste
16 Tools, die die gesamte öffentliche N-sight-API-Referenz abdecken, plus die 4 Endpunkte, die in der Integration "N-able RMM" von app.mspbots.ai bereits in Produktion sind (Device Monitoring Details, Drive Space History, Patch, Performance History).
Kunden & Standorte
Tool | Funktion | Parameter |
| Listet alle Kunden auf, die für diesen API-Key sichtbar sind |
|
| Listet alle Standorte eines Kunden auf |
|
| Neuen Kunden erstellen (Schreiboperation) |
|
| Neuen Standort unter einem Kunden erstellen (Schreiboperation) |
|
Geräte
Tool | Funktion | Parameter |
| Listet Geräte aller Standorte eines Kunden nach Gerätetyp auf |
|
| Listet Servergeräte eines Standorts sowie Online-/Prüfstatus auf |
|
| Listet Workstation-Geräte eines Standorts sowie Online-/Prüfstatus auf |
|
| Listet agentenlose (per Scan erkannte) Assets eines Standorts auf (N-able hat diese Funktion als veraltet markiert) |
|
| Ruft detaillierte Überwachungsinformationen für ein einzelnes Gerät ab |
|
Checks, Patch & Performance
Tool | Funktion | Parameter |
| Listet aktuell fehlgeschlagene Prüfungen auf |
|
| Listet alle auf einem Gerät konfigurierten Prüfungen auf |
|
| Ruft die detaillierte Konfiguration einer einzelnen Prüfung ab (Struktur variiert je nach Prüfungstyp/Betriebssystem) |
|
| Listet Ausfallaufzeichnungen eines Geräts auf (offen oder in den letzten 61 Tagen geschlossen) |
|
| Verlauf der Festplattenspeicher-Prüfungen (basiert auf list_checks, gefiltert nach check_type 1003/1004; N-sight hat keinen separaten Dienst) |
|
| Listet alle Patches auf einem Gerät samt Status/Schweregrad auf |
|
| Historische Leistungskennzahlen eines Geräts (Bandbreite/Festplatte/CPU/Arbeitsspeicher/Netzwerkkarte) |
|
Testbeispiel (Test Example)
Alle Server an einem Standort auflisten:
{
"method": "tools/call",
"params": {
"name": "nable_rmm_get_servers",
"arguments": { "siteid": 12345 }
}
}Entsprechender curl-Aufruf gegen den laufenden Server (Streamable-HTTP-MCP-Endpunkt):
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-H "X-Nable-Api-Token: <api_key>" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nable_rmm_get_servers",
"arguments": { "siteid": 12345 }
}
}'Erwartete Form eines erfolgreichen Ergebnisses (die zugrunde liegende XML-Antwort, in JSON konvertiert; Felder gekürzt):
{
"content": [
{
"type": "text",
"text": "{\n \"created\": \"2026-03-15T10:00:00+00:00\",\n \"host\": \"...\",\n \"status\": \"OK\",\n \"items\": {\n \"server\": [ { \"serverid\": \"9001\", \"name\": \"DC01\", \"online\": \"1\", \"status_247\": \"5\", \"os\": \"Windows Server 2022\" } ]\n }\n}"
}
]
}API-Referenz
Gegen ein Live-Konto verifiziert
Alle 14 Lese-Tools wurden Ende-zu-Ende gegen ein echtes N-able-RMM-Konto (Region USA) getestet und lieferten echte Daten zurück, einschließlich Randfällen, die N-ables öffentliche Dokumentation offenließ:
Der Parameter
intervalvonnable_rmm_get_performance_historyist erforderlich (nicht optional, wie das Beispiel in der Dokumentation vermuten ließ) und akzeptiert nur15oder60— bestätigt durch den eigenen Validierungsfehler der API (Invalid "interval": must be 15 or 60 (minutes)).nable_rmm_get_agentless_assetsliefert bei diesem Konto leereitemszurück, konsistent mit N-ables Hinweis, dass die Funktion veraltet ist.
Die beiden Schreib-Tools (nable_rmm_create_client, nable_rmm_create_site) wurden nicht gegen das Live-Konto getestet, um zu vermeiden, echte Daten in einem N-able-RMM-Mandanten eines Produktionskunden anzulegen — verifizieren Sie sie vor der Verwendung gegen ein Wegwerf-Testkonto.
Bekannte Lücken / Nicht implementiert
get_site_installation_package— liefert einen binären Installer-Download statt strukturierter Daten; als MCP-Tool nicht praktikabel.
This server cannot be deployed
Maintenance
Related MCP Connectors
- ScopableOAuthio.scopable
Scopable MSP API: clients, quotes, assessments, compliance, QBRs. OAuth 2.1, read-only or read-write
Manage Accelo companies, contacts, jobs, tasks, tickets and time.
Read NodePing checks, uptime, results and events; mute checks, manage maintenance and schedules.
Check devices, alerts and tickets in Atera, and open tickets, comment or resolve alerts.
Related MCP Servers
- AlicenseAqualityAmaintenanceExposes N-able N-central REST API as MCP tools for managing devices, organizations, users, and more, with support for read-only, write, and full write modes.125MIT
- AlicenseBqualityDmaintenanceComprehensive read/write access to the Datto RMM API v2, enabling management of devices, sites, alerts, audits, jobs, variables, filters, and activity logs through 46 tools.46MIT
- AlicenseNot gradedqualityBmaintenanceExposes the ConnectWise Command (Continuum) ITSupport247 Reporting API as MCP tools, enabling querying of sites, devices, patches, antivirus, performance, and more.Apache 2.0
- AlicenseAqualityCmaintenanceEnables interaction with the SuperOps.ai PSA/RMM platform via its GraphQL API, providing tools for managing clients, tickets, assets, technicians, and custom queries.21Apache 2.0