Hilfe
Verbindungsfehler gezielt eingrenzen
Erreichbarkeit, Anmeldung, Hostschlüssel und Dateizugriff Schritt für Schritt unterscheiden.
Zuerst die Fehlerphase bestimmen
Bei einem Verbindungsproblem hilft die Frage, wie weit der Aufbau gekommen ist. Ein Timeout vor der Anmeldung, ein abgelehntes Passwort und ein geänderter Hostschlüssel sind unterschiedliche Probleme. Notiere den Zeitpunkt, die betroffene Funktion und die genaue Fehlermeldung, ohne Zugangsdaten oder vertrauliche Terminalausgaben zu kopieren.
Ändere möglichst nur einen Punkt gleichzeitig. Wenn du Adresse, Port, Schlüssel und Vertrauenseinträge gemeinsam ersetzt, lässt sich ein späterer Erfolg kaum noch zuordnen. Erhalte einen vorhandenen funktionierenden Zugang, bis der neue Weg nachvollziehbar geprüft ist.
Timeout oder nicht erreichbarer Server
Prüfe die Felder Host und Port, deine Netzwerkverbindung und ein gegebenenfalls erforderliches VPN. Ein interner Servername kann nur im passenden Netz auflösbar sein. Kontrolliere bei einem Sprungserver auch dessen Erreichbarkeit und den weiteren Weg zum Ziel.
Ein einzelner erfolgreicher Versuch beweist keine dauerhaft stabile Verbindung. Wiederholen sich Timeouts, halte fest, ob sie bereits vor der Anmeldung auftreten und ob andere Ziele betroffen sind. Ordne die Ursache nicht ohne Beleg pauschal der App oder der Firewall zu.
Anmeldung oder Schlüssel abgelehnt
Prüfe User und die gewählte Credential-Methode. Bei einer Schlüsseldatei kontrollierst du die Auswahl und eine gegebenenfalls erforderliche Passphrase. Unterstützte Schlüsselformate unterscheiden sich zwischen interaktivem Terminal, SFTP und begrenzten MCP-Aufträgen. Ein funktionierender Terminal-Login kann deshalb neben einem SFTP-Formatfehler auftreten.
Version 1.1 (Vorschau) unterstützt in ihren begrenzten Befehlsaufträgen weder SSH-Agent noch interaktive Passwortabfragen. Verwende dafür eine geeignete gespeicherte Zugangsmethode. Erzeuge oder installiere keine neuen Schlüssel allein wegen einer unklaren Fehlermeldung.
Vertrauen, Vault und Remote-Dateien
Bei einer Warnung zu einem geänderten Hostschlüssel klärst du den Fingerabdruck unabhängig mit der Serververwaltung. Bei Vault Unavailable stellst du den Zugriff auf den macOS-Anmeldeschlüsselbund wieder her; die vorhandenen Daten sollten erhalten bleiben.
Ein SFTP-Berechtigungsfehler betrifft dagegen häufig den gewählten Remote-Pfad oder die Rechte des angemeldeten Benutzers. Prüfe zuerst lesend das Verzeichnis. Pauschales Freigeben aller Dateirechte ist kein angemessener Reparaturschritt.
Eine hilfreiche Supportanfrage vorbereiten
Nenne App-Version, macOS-Version, betroffene Funktion und die Schritte bis zum Fehler. Beschreibe, ob alle Hosts oder nur ein bestimmter Verbindungsweg betroffen sind. Ersetze reale Zielnamen bei Bedarf durch server.example.com und entferne Tokens, Passwörter, private Schlüssel sowie vertrauliche Ausgaben aus Bildern und Text.
Für MCP-Probleme hilft zusätzlich das Ergebnis von Test Connection. Ein erfolgreicher API-Test grenzt die Ursache ein, bestätigt aber noch nicht die vollständige Einrichtung des externen MCP-Clients.