Svens Homelab

Claude kennt dein Homelab – MCP auf dem Mac einrichten

Claude ist schon sehr praktisch. Aber weißt du, was noch praktischer ist? Wenn Claude nicht nur über deine Dienste reden kann – sondern sie auch gleich bedient, repariert und optimiert. Genau das macht das Model Context Protocol, kurz MCP.

MCP ist eine offene Schnittstelle, über die Claude Desktop mit externen Tools und Diensten kommuniziert. Lokal. Ohne Cloud-Umweg. Klingt technisch? Ist es ein bisschen. Aber der Komfortgewinn ist enorm.

Was ist MCP eigentlich?

Stell dir MCP wie eine Steckerleiste vor. Claude ist das Gerät, das du einsteckst. Die einzelnen Buchsen sind deine Dienste: Home Assistant, n8n, Paperless, dein WordPress-Blog. Jeder Dienst bekommt seinen eigenen „MCP-Server“ – ein kleines Programm, das Claude erklärt, was es kann und wie man es anspricht.

Das Schöne daran: Du musst Claude nichts erklären. Du fragst einfach: „Schalte das Licht im Wohnzimmer aus“ – und Claude weiß dank des Home-Assistant-MCP-Servers, wie das geht. Sofort. Ohne Umweg über die Oberfläche.

Warum das wirklich nützlich ist – am eigenen Beispiel

Der eigentliche Vorteil zeigt sich nicht beim Steuern von Geräten. Den zeigt er beim Debuggen. Und beim Weiterentwickeln. Denn Claude sieht durch MCP nicht nur den aktuellen Zustand eines Systems – er sieht die gesamte Konfiguration dahinter.

Ein konkretes Beispiel aus meinem Setup: Ich habe im Schlafzimmer eine Automation, die je nach Tageszeit unterschiedlich reagiert. Tagsüber: Deckenlampe umschalten. Nachts beim Einschalten: Nachttisch-Gruppe togglen. Nachts beim Ausschalten: alle Schlafzimmerlampen aus, falls noch etwas brennt – inklusive der Zigbee-Lichtgruppe an der Decke.

Das klingt einfach. Ist es aber nicht. Denn die Logik hängt an Sonnenstand, Trigger-IDs, mehreren Lichtgruppen und einem Zigbee-Gerät, das sich intern anders verhält als ein normaler Schalter. Als eine Bedingung nicht mehr korrekt griff, musste ich nicht stundenlang YAML debuggen. Ich habe Claude einfach gefragt:

„Die Schlafzimmer-Automation schaltet nachts beim Drücken nicht die richtige Gruppe. Schau dir die Konfiguration an und erkläre mir, was falsch ist.“

Claude hat die komplette Automation aus Home Assistant gelesen, die Trigger-Logik analysiert und sofort gesehen, dass eine choose-Bedingung in der falschen Reihenfolge stand. Fix in zwei Minuten. Ohne die Home-Assistant-Oberfläche auch nur einmal aufzumachen.

Automationen optimieren statt nur reparieren

Das Gleiche gilt für die Weiterentwicklung. Ich wollte die Zigbee-Lichtschalter im Wohnzimmer um eine Helligkeitsstufe für abends erweitern – abhängig davon, ob die Sonne schon untergegangen ist. Klassischerweise hätte ich das selbst in YAML gebaut, getestet, nachgebessert.

Mit MCP habe ich Claude stattdessen gebeten, die bestehende Automation zu lesen und einen Vorschlag zu machen, wie man eine zweite Helligkeitsstufe für den Abend ergänzt. Claude hat die vorhandene Logik verstanden, die Zigbee-Entitäten im Kontext gesehen und eine fertige Erweiterung vorgeschlagen – die dann auch direkt funktioniert hat.

Das ist der Unterschied. Ohne MCP erkläre ich Claude, wie mein System ungefähr aufgebaut ist. Mit MCP sieht Claude es.

Was du brauchst

  • Claude Desktop für macOS (Download)
  • Node.js oder Python – je nach MCP-Server
  • Die MCP-Server deiner Wahl (dazu gleich mehr)

Node.js installierst du am schnellsten über Homebrew:

brew install node

Die Konfigurationsdatei

Claude Desktop liest alle MCP-Server aus einer einzigen JSON-Datei. Die liegt auf dem Mac hier:

~/Library/Application Support/Claude/claude_desktop_config.json

Falls die Datei noch nicht existiert, einfach anlegen. Der grundsätzliche Aufbau sieht so aus:

{
  "mcpServers": {
    "mein-dienst": {
      "command": "node",
      "args": ["/pfad/zum/mcp-server/index.js"],
      "env": {
        "MEIN_API_KEY": "..."
      }
    }
  }
}

Jeder Eintrag unter mcpServers ist ein eigener Dienst. Der Name links (z.B. mein-dienst) ist frei wählbar – Claude zeigt ihn dir später in der Oberfläche an.

Home Assistant einbinden

Home Assistant bekommt seinen eigenen MCP-Server über das offizielle Add-on. Nach der Installation im Add-on-Store trägst du Folgendes in die Konfigurationsdatei ein:

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": [
        "-y",
        "homeassistant-mcp"
      ],
      "env": {
        "HA_BASE_URL": "http://IP-DEINES-SERVERS:8123",
        "HA_TOKEN": "DEIN_LONG_LIVED_ACCESS_TOKEN"
      }
    }
  }
}

Den Token bekommst du in Home Assistant unter Profil → Sicherheit → Langfristige Zugriffstoken. Danach kann Claude Geräte steuern, Automationen lesen und debuggen, Zigbee-Gruppen direkt ansprechen und Konfigurationen live analysieren.

n8n einbinden

Für n8n gibt es einen Community-MCP-Server. Der erlaubt Claude, Workflows zu suchen, Details abzurufen und – mit dem richtigen Trigger – auch direkt auszuführen. Das ist besonders nützlich, wenn ein Workflow nicht wie erwartet läuft. Claude kann die Knotenstruktur lesen, Logikfehler erkennen und Verbesserungen direkt vorschlagen – ohne dass du den visuellen Editor aufmachen musst.

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "-y",
        "@illuminaresolutions/n8n-mcp-server"
      ],
      "env": {
        "N8N_HOST": "http://IP-DEINES-SERVERS:5678",
        "N8N_API_KEY": "DEIN_N8N_API_KEY"
      }
    }
  }
}

Den API-Key erzeugst du in n8n unter Einstellungen → API. Ich nutze das z.B. um zu fragen: „Welche Workflows werden durch einen Webhook getriggert?“ oder „Zeig mir alle Automationen, die SSH verwenden.“ Claude durchsucht dann alle Workflows und gibt eine übersichtliche Antwort – in Sekunden.

Paperless-ngx einbinden

Paperless bekommt ebenfalls einen eigenen MCP-Server. Claude kann damit Dokumente durchsuchen, Metadaten lesen und sogar neue Dokumente hochladen. Der Vorteil: Statt in der Oberfläche zu suchen, fragst du einfach. „Zeig mir alle Rechnungen von letztem Monat“ oder „Welche Dokumente sind noch ohne Kategorie?“ – Claude findet sie.

{
  "mcpServers": {
    "paperless": {
      "command": "npx",
      "args": [
        "-y",
        "paperless-mcp"
      ],
      "env": {
        "PAPERLESS_URL": "http://IP-DEINES-SERVERS:8000",
        "PAPERLESS_TOKEN": "DEIN_PAPERLESS_API_TOKEN"
      }
    }
  }
}

Den Token findest du in Paperless unter Einstellungen → API-Token.

WordPress einbinden

Ja, auch das klappt. Dieser Beitrag hier ist zum Beispiel direkt über MCP entstanden. Ich habe Claude gebeten, den Entwurf zu schreiben und in meinem WordPress-Blog als Entwurf zu speichern – ohne die WordPress-Oberfläche zu öffnen. Beiträge lesen, erstellen, bearbeiten, kategorisieren: alles geht im Gespräch.

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": [
        "-y",
        "wordpress-mcp"
      ],
      "env": {
        "WORDPRESS_SITE_URL": "https://deine-seite.de",
        "WORDPRESS_USERNAME": "dein-benutzername",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Das App-Passwort erzeugst du in WordPress unter Profil → Anwendungspasswörter. Wichtig: Das ist kein normales Passwort, sondern ein speziell generiertes Token für API-Zugriffe.

Alles zusammen – die vollständige Config

So sieht eine claude_desktop_config.json mit allen vier Diensten aus:

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "homeassistant-mcp"],
      "env": {
        "HA_BASE_URL": "http://IP-DEINES-SERVERS:8123",
        "HA_TOKEN": "DEIN_TOKEN"
      }
    },
    "n8n": {
      "command": "npx",
      "args": ["-y", "@illuminaresolutions/n8n-mcp-server"],
      "env": {
        "N8N_HOST": "http://IP-DEINES-SERVERS:5678",
        "N8N_API_KEY": "DEIN_API_KEY"
      }
    },
    "paperless": {
      "command": "npx",
      "args": ["-y", "paperless-mcp"],
      "env": {
        "PAPERLESS_URL": "http://IP-DEINES-SERVERS:8000",
        "PAPERLESS_TOKEN": "DEIN_TOKEN"
      }
    },
    "wordpress": {
      "command": "npx",
      "args": ["-y", "wordpress-mcp"],
      "env": {
        "WORDPRESS_SITE_URL": "https://deine-seite.de",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Claude neu starten

Nach jeder Änderung an der Konfigurationsdatei muss Claude Desktop neu gestartet werden. Einfach schließen und wieder öffnen. In der linken Seitenleiste siehst du dann ein kleines Stecker-Symbol – ein Klick zeigt dir, welche Tools aktiv sind.

Wenn ein Server nicht startet, hilft ein Blick in die Logs:

~/Library/Logs/Claude/

Der eigentliche Gewinn

Wer MCP einmal benutzt hat, will nicht mehr zurück. Nicht wegen des Wow-Effekts beim ersten Mal. Sondern wegen des kleinen, täglichen Komforts: keine Oberfläche öffnen, kein manuelles Suchen, kein Copy-Paste aus Konfigurationsdateien in eine Chatbox.

Claude sieht dein System. Nicht als Text, den du ihm beschreibst. Als echte, aktuelle Daten – direkt aus der Quelle. Und das macht beim Debuggen, Erweitern und Verstehen einen riesigen Unterschied.

Viel Spaß beim Ausprobieren!