MCP-Server-Konfiguration

Was ist MCP?

MCP (Model Context Protocol) ist ein Standard, der deiner OpenClaw-Instanz ermöglicht, sich mit externen Tools und Datenquellen zu verbinden. Ein MCP-Server stellt bestimmte Fähigkeiten bereit — wie Dateizugriff, Datenbankabfragen oder API-Integrationen — die das LLM beim Beantworten von Nachrichten nutzen kann.

Wenn ein MCP-Server verbunden ist, erhält das LLM Zugriff auf die Tools, die dieser Server bereitstellt. Zum Beispiel ermöglicht ein Dateisystem-MCP-Server dem LLM, Dateien auf der Instanz zu lesen und zu schreiben. Ein Websuche-MCP-Server lässt es Informationen online nachschlagen.

Wie MCP auf ClawHosters funktioniert

Deine OpenClaw-Instanz fungiert als MCP-Client. Sie verbindet sich mit MCP-Servern, die entweder laufen:

• Im Container — Eingebaute Server, die mit OpenClaw geliefert werden
• Auf demselben Host — Server, die du per SSH installierst
• Remote — Externe Server, die über das Netzwerk erreichbar sind

Die Instanz erkennt verfügbare MCP-Server aus ihrer Konfiguration und verbindet sich beim Start mit ihnen. Das LLM sieht dann die Tools, die diese Server bereitstellen, und kann sie während Konversationen nutzen.

Eingebaute MCP-Server

OpenClaw enthält mehrere MCP-Server standardmäßig:

Diese Server sind auf allen Tiers verfügbar. Der Browser-Server benötigt das vorinstallierte Playwright Chromium aus dem Base-Snapshot.

MCP-Server konfigurieren

Die MCP-Server-Konfiguration wird über die OpenClaw-Gateway-Einstellungen verwaltet. Du kannst Server auf zwei Arten konfigurieren:

Über die Web-UI

1. Öffne die Web-UI deiner Instanz (die Gateway-URL)
2. Navigiere zu Einstellungen
3. Finde den Abschnitt MCP-Server
4. Server hinzufügen, bearbeiten oder entfernen

Über openclaw.json

Für fortgeschrittene Nutzer, die sich per SSH verbinden, können MCP-Server direkt in der OpenClaw-Konfiguration konfiguriert werden:

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": ["/app/mcp-servers/filesystem/dist/index.js"],
      "env": {}
    },
    "custom-server": {
      "command": "npx",
      "args": ["-y", "@some-org/mcp-server"],
      "env": {
        "API_KEY": "dein-schlüssel"
      }
    }
  }
}

Jeder MCP-Server-Eintrag braucht:

Eigene MCP-Server installieren

Du kannst zusätzliche MCP-Server per SSH installieren:

1. Verbinde dich per SSH mit deiner Instanz
2. Installiere das MCP-Server-Paket (üblicherweise via npm)
3. Füge die Server-Konfiguration zu deinen OpenClaw-Einstellungen hinzu
4. Starte die Konfiguration neu oder lade sie neu

Beispiel — einen eigenen MCP-Server installieren:

# SSH-Verbindung zu deiner Instanz
ssh -i ~/.ssh/openclaw-master root@deine-instanz-ip

# Im Container installieren
docker exec -it openclaw-<id> npm install -g @some-org/mcp-server

# Dann Server-Konfiguration über Web-UI oder openclaw.json hinzufügen

Beachte:

• Eigene MCP-Server bleiben über Container-Neustarts erhalten (wenn im Daten-Volume installiert)
• Ein Rebuild löscht eigene Installationen — nach Rebuild neu installieren
• MCP-Server laufen mit denselben Berechtigungen wie der Container (root)
• Fehlerhafte MCP-Server können die Instanz zum Hängen bringen oder übermäßig Ressourcen verbrauchen

Ressourcen-Auswirkung

MCP-Server laufen als Kindprozesse des OpenClaw-Gateways. Jeder Server verbraucht etwas Arbeitsspeicher und CPU:

Auf dem Budget-Tier (1 GB Docker-Speicherlimit) kann das Ausführen vieler MCP-Server den verfügbaren Speicher erschöpfen. Überwache deinen Speicherverbrauch, wenn du eigene Server hinzufügst.

Fehlerbehebung

MCP-Server verbindet sich nicht

• Prüfe, ob der Server-Befehl existiert (ist das Paket installiert?)
• Überprüfe, ob die Argumente korrekt sind
• Prüfe Container-Logs auf Startfehler: docker logs openclaw-<id>

Tools erscheinen nicht für das LLM

• Das LLM sieht nur Tools von verbundenen MCP-Servern
• Überprüfe, ob der Server läuft: prüfe den Gateway-Status in der Web-UI
• Einige Tools erfordern ein aktives LLM-Add-on

Browser-MCP-Server-Probleme

• Playwright Chromium ist im Base-Snapshot vorinstalliert
• Wenn Browser-Tools fehlschlagen, könnte die Chromium-Installation beschädigt sein
• Ein Rebuild stellt die saubere Browser-Installation wieder her

Verwandte Dokumentation

• OpenClaw-Konfigurationsreferenz — Vollständige Konfigurationsdatei-Referenz
• Skills und Plugins — Wie Skills deine Instanz erweitern
• SSH-Zugang — Verbindung zu deiner Instanz
• Ressourcenlimits — Arbeitsspeicher und CPU nach Tier