Niccolounmolested73/chrome-mcp-windows-survival-guide

Was macht chrome-mcp-windows-survival-guide?

Behebt häufige Fehler beim Ausführen des chrome-mcp-Servers unter Windows 11, um Ihren aktiven Chrome-Browser und Cookies mit Claude Code und anderen MCP-Clients zu verbinden.

Voraussetzungen

• Betriebssystem: Windows 11 (64-Bit)
• Installierte Software:
  • Node.js (v18 oder höher)
  • Chrome-Browser (aktuellste Version)
  • Claude Code oder ein anderer MCP-Client

Häufige Fehler und Lösungen

1. Pfadfehler: "chrome.exe nicht gefunden"

Problem: Der chrome-mcp-Server findet die Chrome-Executable nicht.

Lösung: Setzen Sie die Umgebungsvariable CHROME_PATH auf den vollständigen Pfad zu Chrome.

set CHROME_PATH=C:\Program Files\Google\Chrome\Application\chrome.exe

Oder fügen Sie diesen Pfad dauerhaft zu Ihren Systemvariablen hinzu.

2. Portkonflikte: "Port 8080 bereits belegt"

Problem: Ein anderer Dienst verwendet den Standardport.

Lösung: Starten Sie den Server mit einem anderen Port:

npx @anthropic/chrome-mcp --port 9090

Passen Sie Ihren MCP-Client entsprechend an.

3. Berechtigungsfehler: "Zugriff verweigert"

Problem: Fehlende Berechtigungen für Dateien oder Prozesse.

Lösung: Führen Sie Ihr Terminal (CMD, PowerShell) als Administrator aus.

# Als Administrator ausführen
npx @anthropic/chrome-mcp

4. Cookie-Synchronisation funktioniert nicht

Problem: Cookies werden nicht zwischen Chrome und dem MCP-Client geteilt.

Lösung: Stellen Sie sicher, dass Chrome nicht im Inkognito-Modus läuft und dass Sie die --remote-debugging-port Option verwenden.

# Chrome mit Remote-Debugging starten
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

Verbinden Sie dann den chrome-mcp-Server mit diesem Port.

Konfiguration für verschiedene MCP-Clients

Claude Code

Fügen Sie in Ihrer claude_code.json folgende Konfiguration hinzu:

{
  "mcpServers": {
    "chrome-mcp": {
      "command": "npx",
      "args": ["@anthropic/chrome-mcp", "--port", "9090"],
      "env": {
        "CHROME_PATH": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
      }
    }
  }
}

Andere MCP-Clients

Überprüfen Sie die Dokumentation Ihres Clients zur Konfiguration von MCP-Servern. Stellen Sie sicher, dass die command und args wie oben angegeben gesetzt sind.

Troubleshooting-Skript

Führen Sie dieses Skript aus, um die häufigsten Probleme automatisch zu diagnostizieren:

# Troubleshooting-Skript für chrome-mcp unter Windows
Write-Host "Prüfe Chrome-Pfad..."
if (Test-Path "$env:ProgramFiles\Google\Chrome\Application\chrome.exe") {
    Write-Host "OK: Chrome gefunden."
} else {
    Write-Host "FEHLER: Chrome nicht gefunden. Setzen Sie CHROME_PATH."
}

Write-Host "Prüfe Node.js..."
if (Get-Command node -ErrorAction SilentlyContinue) {
    Write-Host "OK: Node.js installiert."
} else {
    Write-Host "FEHLER: Node.js nicht gefunden."
}

Write-Host "Prüfe Port 9222..."
$portCheck = netstat -an | Select-String "LISTENING.*9222"
if ($portCheck) {
    Write-Host "OK: Port 9222 wird verwendet (Chrome Debugging)."
} else {
    Write-Host "WARNUNG: Port 9222 nicht aktiv. Starten Sie Chrome mit --remote-debugging-port=9222."
}

Unterstützung

Bei weiteren Problemen besuchen Sie die GitHub-Seite oder öffnen Sie ein Issue.