MCP-Server mit Claude Desktop verbinden

Entfernte Server: einen benutzerdefinierten Connector hinzufügen

Öffnen Sie Claude Desktop, gehen Sie zu Einstellungen, dann Connectors, und klicken Sie auf Benutzerdefinierten Connector hinzufügen. Geben Sie ihm einen Namen, fügen Sie die Server-URL ein und bestätigen Sie. Benutzerdefinierte Connectors mit entferntem MCP stehen in den Plänen Free, Pro, Max, Team und Enterprise zur Verfügung; ein Free-Konto ist auf einen benutzerdefinierten Connector begrenzt. Bei Team- und Enterprise-Plänen fügt zunächst ein Organisationsinhaber den Connector in den Organisationseinstellungen hinzu, danach aktivieren Mitglieder ihn auf ihrer eigenen Connectors-Seite.

Server, die OAuth unterstützen, bitten Sie beim ersten Aufruf im Browser um Anmeldung und Zustimmung zu den Berechtigungen; mehr ist nicht nötig. Ein optionaler Abschnitt Erweiterte Einstellungen nimmt eine OAuth-Client-ID und ein Client-Secret für Server entgegen, die einen vorab registrierten Client verlangen, was die meisten öffentlichen Server nicht tun. Für den Server von HostTracker lautet die URL https://mcp.host-tracker.com/mcp; er verwendet OAuth mit dynamischer Client-Registrierung, sodass der Connector nur die von Ihnen genehmigten Berechtigungen hält und es keinen Schlüssel zum Einfügen gibt.

Connectors laufen auf der Seite von Anthropic statt auf Ihrem Rechner, können also keinen Server in Ihrem lokalen Netzwerk erreichen, und sie sind derselbe Mechanismus, den claude.ai und Cowork nutzen. Die im Folgenden beschriebene Konfigurationsdatei ist das lokale Gegenstück.

Lokale Server: claude_desktop_config.json bearbeiten

Öffnen Sie Einstellungen, wählen Sie den Tab Entwickler und klicken Sie auf Konfiguration bearbeiten. Das öffnet die Konfigurationsdatei in Ihrem Editor und legt sie an, falls sie noch nicht existiert. Die Datei liegt unter ~/Library/Application Support/Claude/claude_desktop_config.json auf macOS und unter %APPDATA%\Claude\claude_desktop_config.json unter Windows; in der Linux-Beta nutzen Sie die Schaltfläche Konfiguration bearbeiten, statt einen Pfad zu erraten. Jeder Server ist ein Eintrag unter mcpServers mit dem zu startenden Befehl und seinen Argumenten:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Speichern Sie die Datei, beenden Sie Claude Desktop dann vollständig und starten Sie es erneut; ein Schließen des Fensters reicht nicht aus, denn die Server werden beim Start der App gestartet. Unter Windows muss die Laufzeitumgebung, auf die der Befehl angewiesen ist, etwa Node.js für npx, installiert und im PATH sein, den die Desktop-App sieht, sodass ein Server, der im Terminal, aber nicht aus der App heraus läuft, meist an einem PATH-Unterschied liegt.

Um zu sehen, ob ein Server geladen wurde, klicken Sie auf das Symbol "Dateien, Connectors und mehr hinzufügen" unten links im Nachrichtenfeld, bewegen Sie den Mauszeiger auf Connectors und öffnen Sie Connectors verwalten; der Server wird dort mit seinen Tools aufgeführt. Ältere Dokumentation nennt dies das Hammer-Symbol, und die Seite zur Fehlerbehebung verwendet diesen Namen noch in einer Überschrift.

Erweiterungen aus dem Verzeichnis

Einstellungen, dann Erweiterungen, dann Erweiterungen durchsuchen zeigt ein kuratiertes Verzeichnis lokaler Server, die als Erweiterungen paketiert sind, sich mit einem einzigen Klick installieren lassen und sich selbst aktualisieren. Ein heruntergeladenes Paket wird über Erweiterung installieren durch Auswahl der Datei installiert; diese Pakete verwenden das Format .mcpb, das den früheren Namen .dxt abgelöst hat, und können Node.js-, Python- oder Binärserver umschließen. Privat verteilte Pakete aktualisieren sich nicht automatisch und müssen nach einer Änderung von Hand neu installiert werden.

Wo die Protokolle liegen, wenn nichts erscheint

Claude Desktop schreibt ein allgemeines Verbindungsprotokoll und eines pro Server. Auf macOS liegen sie unter ~/Library/Logs/Claude/ als mcp.log und mcp-server-NAME.log; unter Windows unter %APPDATA%\Claude\logs. Die serverspezifische Datei enthält die eigene Fehlerausgabe des Servers, in der ein fehlendes Modul, ein falscher Pfad oder eine abgelehnte Anmeldeinformation genau benannt wird. Ist die Datei leer, hat die App den Befehl nie starten können, was wieder auf den PATH oder auf einen JSON-Syntaxfehler in der Konfigurationsdatei hindeutet.

Eine App, zwei Oberflächen

Claude Desktop enthält inzwischen neben dem Chat-Tab einen Code-Tab, der Claude Code innerhalb der Anwendung ausführt. In claude_desktop_config.json deklarierte Server stehen sowohl in der Chat-Oberfläche als auch in lokalen Code-Tab-Sitzungen zur Verfügung, neben denen aus ~/.claude.json und der .mcp.json eines Projekts; existiert derselbe Name an beiden Stellen, übernimmt der Code-Tab die Definition aus der Desktop-Datei. Das eigenständige Kommandozeilen-Claude-Code liest die Desktop-Datei nicht. Haben Sie Server zuerst in der Desktop-App eingerichtet und möchten sie im Terminal nutzen, importiert claude mcp add-from-claude-desktop sie unter macOS und dem Windows-Subsystem für Linux, wie in MCP-Server zu Claude Code hinzufügen beschrieben.

Ein entfernter Monitoring-Server als erster Connector

Ein entfernter Server ist der schnellste Weg, um zu bestätigen, dass der Connector-Ablauf funktioniert, denn es gibt nichts zu installieren und die Antwort lässt sich überprüfen. Fügen Sie den Server von HostTracker als benutzerdefinierten Connector hinzu, melden Sie sich bei Aufforderung an und fragen Sie Claude, ob eine Ihnen bekannte Website erreichbar ist; die Antwort sollte sich auf eine von den Prüfpunkten von HostTracker an benannten Standorten ausgeführte Prüfung berufen statt zu raten. Die MCP-Server-Seite listet alle 65 Tools und die jeweils benötigten Berechtigungen auf, von Sofortprüfungen bis zu Statusseiten-Aktualisierungen.