Lokale MCP-Server

Ein lokaler MCP-Server ist ein Programm, das auf Ihrem Rechner läuft und der KI Werkzeuge anbietet, etwa Zugriff auf einen Ordner, ein Git-Repository oder eine lokale Datenbank. Code und Cowork können diese Werkzeuge dann aufrufen.

Sie verwalten lokale Server unter Einstellungen, Integrationen. In Code und Cowork öffnet /mcp die Integrationen direkt, gefiltert auf MCP-Server.

Lokal oder remote

Die Liste unter Integrationen hat zwei Bereiche:

• Mit deinem Konto verbunden: die fertigen Integrationen, eigene Remote-MCP-Server und WebDAV. Ein Remote-MCP-Server läuft im Internet, und unser Server verbindet sich mit ihm. Er steht deshalb in jedem Produkt bereit, im Browser genauso wie in Chat, Code und Cowork.
• Auf diesem Gerät: Ihre lokalen MCP-Server mit dem Abzeichen Lokal, ihrem Zustand und dem Hinweis Nur in Code und Cowork. Darunter stehen unter Konfigurationsdateien die Dateien, die die App gefunden hat, mit ihren Servern, auch solchen, die Noch nicht freigegeben sind.

Die Filter Alle, MCP-Server und Lokal grenzen die Liste ein, die Suche findet Einträge aus beiden Bereichen.

Einen Server hinzufügen

Klicken Sie unter Integrationen auf Hinzufügen. Die App fragt zuerst, was Sie hinzufügen wollen: Remote-MCP-Server (eine Adresse), Lokaler MCP-Server (ein Befehl) oder WebDAV / Nextcloud. Über diesen drei Karten steht Konfiguration einfügen. Haben Sie eine Konfiguration mit mehreren Servern, nehmen Sie diesen Weg: Die App nimmt JSON mit mcpServers (oder servers wie in VS Code), einen einzelnen Servereintrag oder eine Befehlszeile an und sortiert jeden Eintrag selbst ein. Einträge mit Befehl werden lokale Server, Einträge mit URL werden Remote-MCP-Server.

Für einen lokalen Server gibt es vier Wege, und keiner startet etwas, bevor Sie gespeichert haben:

• Beliebte Server: Ein Klick legt einen fertigen Eintrag an, etwa Dateisystem, Git, SQLite, PostgreSQL, Web abrufen, Gedächtnis, Browser (Playwright) oder Obsidian. Sie wählen nur den Ordner, die Datei oder die Verbindungs-URL, die er braucht. Braucht der Server Node.js oder uv (Python) und findet die App es nicht, zeigt sie den Befehl zum Installieren.
• In anderen Apps gefunden: Server, die bereits in Claude Desktop, Claude Code, Cursor, VS Code oder Windsurf eingerichtet sind, bietet die App mit Übernehmen an. Einträge mit URL aus diesen Dateien bietet sie als Remote-MCP-Server an.
• Einfügen: Fügen Sie das JSON aus einer anderen App (mit mcpServers) oder einen Befehl aus einer Anleitung ein, etwa npx -y @modelcontextprotocol/server-filesystem ~/Dokumente. Ein Eintrag mit URL öffnet das Formular für einen Remote-MCP-Server, und die eingefügte Liste ist noch da, wenn Sie zurückkehren.
• Manuell hinzufügen: Geben Sie Name, Befehl, seine Argumente (eines pro Zeile), Umgebungsvariablen, ein optionales Arbeitsverzeichnis und ein Zeitlimit pro Aufruf (Sekunden) ein. Testen prüft, ob der Server antwortet und wie viele Werkzeuge er anbietet.

Das Menü Weitere Optionen (⋯) neben Einfügen und Manuell hinzufügen hat zwei weitere Einträge: Konfigurationsdatei öffnen zeigt die Datei, in der die App Ihre lokalen Server speichert, und Exportieren kopiert sie als JSON mit mcpServers, ohne die Werte der Variablen.

Der Name wird zum Präfix der Werkzeuge des Servers: Kleinbuchstaben, Ziffern und Bindestriche, höchstens 24 Zeichen. Der Befehl wird direkt gestartet, ohne Shell.

Server verwalten

Jeder lokale Server zeigt in der Liste seinen Zustand: Läuft, Gestoppt, Startet… oder Fehler. Ein Klick öffnet seine Detailansicht. Dort schalten Sie den Server ein oder aus, starten oder stoppen ihn und bieten über einen eigenen Schalter je Werkzeug nur die Werkzeuge an, die Sie brauchen. nur lesend kennzeichnet Werkzeuge, die angeben, nichts zu verändern. Protokoll zeigt, was der Server ausgegeben hat, Bearbeiten ändert seine Einstellungen und Entfernen löscht ihn.

Der KI werden über alle Server hinweg höchstens 40 Werkzeuge gleichzeitig angeboten. Die App warnt, wenn Sie mehr eingeschaltet haben.

Server aus einer Konfigurationsdatei

Wie in Claude Code können Sie Server auch in einer Datei eintragen. .deutschlandgpt/mcp.json oder .mcp.json in einem Projektordner gilt für dieses Projekt, ~/.deutschlandgpt/mcp.json für alle Projekte. Ein Server aus einer solchen Datei startet erst, wenn Sie seinen Befehl geprüft und freigegeben haben. Ändert sich der Eintrag, fragt die App erneut.

Wo die Einstellungen liegen

Lokale Server und ihre Einstellungen bleiben auf diesem Gerät und werden nie mit unserem Server synchronisiert. Werte von Umgebungsvariablen liegen im Schlüsselspeicher Ihres Betriebssystems und werden nach dem Speichern nicht wieder angezeigt. Entfernen Sie einen Server, werden auch seine gespeicherten Werte gelöscht.

Freigaben

Ein Aufruf eines lokalen Werkzeugs durchläuft dieselben Freigaben wie alles andere in Code und Cowork:

• Im Plan-Modus dürfen nur Werkzeuge laufen, die als nur lesend gekennzeichnet sind.
• Im Modus Auto laufen Werkzeuge ohne Rückfrage. Ein Unteragent fragt trotzdem.
• Sonst fragt die App, bevor ein Werkzeug läuft. Erlauben Sie es dauerhaft, gilt das für dieses Werkzeug mit genau dieser Serverkonfiguration. Ändern Sie Befehl oder Argumente, fragt die App erneut.

Aufrufe von Werkzeugen, die etwas verändern können, landen im Audit-Protokoll Ihrer Organisation, mit Servername, Werkzeugname und Ergebnis. Argumente, Werte und Ausgaben werden nie aufgezeichnet.

Für Administratoren

Der Schalter Lokale MCP-Server erlauben unter Werkzeug-Richtlinien legt fest, ob Mitglieder in Code und Cowork lokale MCP-Server hinzufügen dürfen. Jeder Aufruf läuft mit den Rechten des Mitglieds auf seinem Gerät, die Ergebnisse gehen an das gewählte KI-Modell. Schalten Sie die Option aus, stoppt die Desktop-App alle lokalen Server bei ihrer nächsten Synchronisierung.

Wenn lokale Server nicht verfügbar sind

Meldung	Bedeutung
Noch nicht freigeschaltet.	Lokale MCP-Server sind für Ihr Konto nicht freigeschaltet
Von deiner Organisation deaktiviert.	Die Administration hat Lokale MCP-Server erlauben für die Organisation ausgeschaltet. Laufende Server werden gestoppt