# NetBox MCP-Server via ToolMesh + DADL

> NetBox 4.x als MCP-Server via ToolMesh + dem NetBox-DADL — Geräte, IPAM, Standorte, Racks, VLANs als Tools für Claude oder ChatGPT. Mit Setup und Prompts.

Canonical: https://www.toolmesh.io/de/integrations/netbox/

Nutze [NetBox](https://netbox.dev/) 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](https://docs.netbox.dev/en/stable/integrations/rest-api/) (Geräte, IPAM, Standorte, Racks, Prefixes, IP-Adressen, Mandanten, VLANs, Interfaces, Cables) als Tools bereit, die KI-Agenten über ToolMesh aufrufen.

## Warum nicht einen eigenen MCP-Server schreiben?

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](/de/blog/why-mcp-gateways-alone-dont-solve-the-real-problem/).

## Was enthalten ist

- 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](https://dadl.ai/d/netbox)**.

## Drei Schritte zum NetBox-MCP-Server

1. Trage `netbox.dadl` in deine ToolMesh-`backends.yaml` ein:

   ```yaml
   - name: netbox
     transport: rest
     dadl: /app/dadl/netbox.dadl
     url: "https://netbox.example.com"
   ```

2. Setze die Credential als Umgebungsvariable:

   ```bash
   CREDENTIAL_NETBOX_TOKEN=dein-netbox-api-token
   ```

3. Verbinde deinen Agenten — [Claude verbinden](/de/setup-claude/) oder [ChatGPT verbinden](/de/setup-openai/). ToolMesh stellt die NetBox-Tools automatisch per MCP bereit.

## Was du den Agenten fragen kannst

- *„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.

## End-to-End-Tutorial

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](/de/blog/populating-netbox-from-real-infrastructure/)**.

## Verwandte Integrationen

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

- [Hetzner Cloud DADL](https://dadl.ai/d/hetzner-cloud) — Server- und Netzwerk-Inventar.
- [Linode DADL](https://dadl.ai/d/linode) — Instance- und IP-Inventar.
- [Xen Orchestra DADL](https://dadl.ai/d/xen-orchestra) — VM- und Storage-Inventar.
- [Tailscale DADL](https://dadl.ai/d/tailscale) — Node-zu-Gerät-Synchronisation.
- [Mikrotik DADL](https://dadl.ai/d/mikrotik) — Switch- und Router-Zustand.

Alle 22+ einsatzfertigen Integrationen auf [der Integrationen-Übersicht](/de/integrations/) oder im vollständigen Registry unter [dadl.ai/browse](https://dadl.ai/browse).