Zum Inhalt springen

NetBox MCP-Server via ToolMesh + DADL

Nutze NetBox als MCP-Server für Claude, GPT und jeden MCP-kompatiblen KI-Agenten — ohne eigenen MCP-Server-Code zu schreiben oder zu pflegen. Das NetBox-DADL stellt die NetBox-4.x REST-API (Geräte, IPAM, Standorte, Racks, Prefixes, IP-Adressen, Mandanten, VLANs, Interfaces, Cables) als Tools bereit, die KI-Agenten über ToolMesh aufrufen.

Ein selbst geschriebener NetBox-MCP-Server bedeutet einen weiteren Python-Service, den du deployen, absichern und bei jeder NetBox-API-Änderung aktualisieren musst. Das NetBox-DADL ist eine einzige YAML-Datei, die ToolMesh zur Laufzeit liest: kein separater Prozess, kein Klebe-Code, kein Versions-Drift. Autorisierung, Credential-Injection und Audit-Logging kommen aus ToolMesh, nicht aus jedem einzelnen Connector. Längere Begründung: Warum MCP-Gateways allein das Problem nicht lösen.

  • Alle wichtigen NetBox-4.x-Endpunkte — DCIM (Geräte, Racks, Standorte, Cables), IPAM (Prefixes, IPs, VLANs, VRFs), Tenancy, Virtualization.
  • Authentifizierung per NetBox-API-Token, zur Laufzeit aus CREDENTIAL_NETBOX_TOKEN injiziert — niemals an den Agenten oder dessen Prompt exponiert.
  • Pagination, Filter und Feldauswahl je Endpunkt, einmal im DADL deklariert.
  • Vollständige maschinenlesbare Definition mit Tool-Liste und Coverage: dadl.ai/d/netbox.
  1. Trage netbox.dadl in deine ToolMesh-backends.yaml ein:

    - name: netbox
    transport: rest
    dadl: /app/dadl/netbox.dadl
    url: "https://netbox.example.com"
  2. Setze die Credential als Umgebungsvariable:

    Terminal-Fenster
    CREDENTIAL_NETBOX_TOKEN=dein-netbox-api-token
  3. Verbinde deinen Agenten — Claude verbinden oder ChatGPT verbinden. ToolMesh stellt die NetBox-Tools automatisch per MCP bereit.

  • „Zeig mir alle Geräte in Rack R12 in Frankfurt.”
  • „Finde jedes IP-Prefix in 10.0.0.0/8, dessen Beschreibung ‘kubernetes’ enthält.”
  • „Lege ein neues Gerät web-fra-01 vom Typ cx22 in Standort fsn1 an.”
  • „Außer-Betrieb-Setzung von legacy-bastion-01 und markiere dessen IPs als deprecated.”

Jeder Prompt wird zu einem oder mehreren NetBox-Tool-Aufrufen. Jeder Aufruf landet im ToolMesh-Audit-Log — du kannst exakt nachvollziehen, was der Agent gemacht hat, wann und in wessen Auftrag.

Den kompletten Workflow — inklusive Live-Import aus Hetzner Cloud, Linode und Xen Orchestra in ein leeres NetBox mit einem vierstufigen Vertrauensaufbau — gibt es im Tutorial Populating NetBox from Real Infrastructure with ToolMesh.

Häufig zusammen mit NetBox eingesetzt für Infrastruktur-Inventarisierung:

Alle 22+ einsatzfertigen Integrationen auf der Integrationen-Übersicht oder im vollständigen Registry unter dadl.ai/browse.