Snippet
MCP-Server einrichten – Model Context Protocol für Claude konfigurieren
Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten erlaubt, strukturiert auf externe Dienste, Dateisysteme und APIs zuzugreifen – ohne Umwege über kopierte Inhalte oder manuelle Zwischenschritte.
MCP markiert dabei einen kleinen, aber folgenreichen Schritt: Der Assistent bleibt nicht länger ein isoliertes Textfenster, sondern wird zur Schnittstelle zwischen Sprache, Daten und Handlung. Eine kleine JSON-Datei entscheidet darüber, ob ein KI-System nur antwortet oder tatsächlich mit der eigenen Arbeitsumgebung verbunden ist.
Die Konfiguration läuft über eine einzige JSON-Datei. Wer schon einmal einen Cronjob eingerichtet oder eine vhost.conf gepflegt hat, ist in wenigen Minuten fertig.
Voraussetzungen
Vor der Einrichtung des ersten MCP-Servers sollten drei Dinge geklärt sein:
- Claude Desktop ist installiert – die API allein reicht nicht, MCP läuft über den Desktop-Client
- Es ist klar, welcher MCP-Server eingebunden werden soll – entweder ein Referenzserver aus dem MCP-Projekt, ein Community-Server oder ein selbst entwickelter Server
- Die Laufzeitumgebung des Servers ist vorhanden – viele Node-basierte Server benötigen Node.js ≥ 18, Python-basierte Server uv oder pip . Die jeweilige Installationsanleitung des Servers ist maßgeblich.
Node.js prüfen (für Node-basierte Server):
node --version
npx --version
Falls Node.js fehlt:
# macOS (Homebrew)
brew install node
# Debian / Ubuntu
sudo apt install nodejs npm
Konfigurationsdatei öffnen
Die zentrale Datei für alle MCP-Server-Verbindungen ist claude_desktop_config.json. Sie liegt je nach Betriebssystem an unterschiedlichen Stellen:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Linux (je nach MCP-Client, nicht offiziell von Claude Desktop unterstützt):
~/.config/Claude/claude_desktop_config.json
Existiert die Datei noch nicht, einfach anlegen. Claude Desktop liest sie beim nächsten Start automatisch ein.
Datei im Terminal öffnen:
# macOS
open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Linux
nano ~/.config/Claude/claude_desktop_config.json
Ersten MCP-Server hinzufügen
Das Grundgerüst der Konfigurationsdatei sieht so aus:
{
"mcpServers": {
"servername": {
"command": "npx",
"args": ["-y", "@paketname/server", "/optionaler/pfad"]
}
}
}
Beispiel: Dateisystem-Zugriff (Node.js)
Der Filesystem-Referenzserver aus dem MCP-Projekt erlaubt Claude, Dateien in einem definierten Verzeichnis zu lesen und zu schreiben:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/name/Dokumente"
]
}
}
}
Den Pfad /Users/name/Dokumente durch das gewünschte Verzeichnis ersetzen. Claude hat dann ausschließlich Zugriff auf diesen Pfad – nicht auf das gesamte System.
Beispiel: Fetch-Server (Python/uv)
Der Fetch-Server ist Python-basiert und wird über uvx gestartet. Voraussetzung: uv ist installiert (pip install uv oder docs.astral.sh/uv):
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
Das Beispiel zeigt: MCP-Server sind nicht auf eine Laufzeitumgebung beschränkt. Node.js, Python, Docker und eigene Binaries sind möglich – der Aufruf im command -Feld ändert sich entsprechend.
Sicherheit
MCP-Server sind ein direkter Zugriffspfad auf Daten und Systeme. Ein paar Grundregeln:
- Filesystem: Nur konkrete Projekt- oder Arbeitsverzeichnisse freigeben, keine Home-Verzeichnisse pauschal, keine Systempfade
- Fetch: Der Server kann auch interne oder lokale Netzwerkadressen erreichen – im lokalen Netzwerk mit Vorsicht einsetzen
- API-Tokens gehören ausschließlich in das env -Objekt, nicht in args , Pfadnamen oder kopierte Konfigurationsbeispiele
- Unbekannte MCP-Server aus dem Internet grundsätzlich prüfen, bevor sie mit Dateizugriff oder Netzwerk konfiguriert werden
Mehrere Server gleichzeitig betreiben
Mehrere MCP-Server lassen sich parallel konfigurieren – einfach als weitere Einträge im mcpServers-Objekt:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/name/Projekte"
]
},
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
},
"sqlite": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sqlite",
"/Users/name/daten.db"
]
}
}
}
Die Schlüsselnamen (filesystem, fetch, sqlite) sind frei wählbar – sie erscheinen später im Tool-Menü von Claude Desktop.
Umgebungsvariablen übergeben
Manche MCP-Server benötigen API-Keys oder andere Zugangsdaten. Diese werden als env-Objekt übergeben – niemals direkt in die args schreiben:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Claude Desktop neu starten
Nach jeder Änderung an der Konfigurationsdatei muss Claude Desktop vollständig neu gestartet werden – ein einfaches Neu-Laden des Chatfensters reicht nicht.
macOS: Claude vollständig beenden (Cmd + Q), dann neu öffnen. Windows: Im Infobereich der Taskleiste rechtsklicken → Beenden, dann neu starten.
Verbindung prüfen
Nach dem Neustart zeigt Claude Desktop verbundene Tools im Tool- bzw. Connector-Menü der Eingabeleiste an. Die genaue Darstellung kann je nach Version variieren.
Ist das Menü leer oder fehlen erwartete Tools, liegt meistens ein Konfigurationsfehler vor – siehe Stolperfallen unten.
Claude direkt fragen, ob die Verbindung steht:
Welche Tools stehen dir aktuell zur Verfügung?
Die Antwort listet alle aktiven MCP-Tools mit Namen und kurzer Beschreibung auf.
Häufige Stolperfallen
Server erscheint nicht, kein Fehlerdialog? Claude Desktop zeigt bei Konfigurationsfehlern oft keine sichtbare Meldung. Zuerst die JSON-Syntax prüfen – ein fehlendes Komma oder eine falsche Klammer reicht, um den gesamten Server-Block zu deaktivieren. Lokal validieren:
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool
npx wird nicht gefunden?
Claude Desktop startet in einer minimalen Shell-Umgebung, in der PATH nicht vollständig gesetzt ist. Abhilfe: Den vollständigen Pfad zu npx angeben:
# Pfad ermitteln
which npx
{
"mcpServers": {
"filesystem": {
"command": "/usr/local/bin/npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/name/Dokumente"]
}
}
}
Zugriff auf Pfad wird verweigert?
Der angegebene Verzeichnispfad muss für den Benutzer lesbar (und ggf. schreibbar) sein. Berechtigungen prüfen:
ls -la /pfad/zum/verzeichnis
Server startet, aber Tools fehlen? Manche Server laden Tools verzögert oder nur bei bestimmten Berechtigungen. Claude neu starten und im Tool-Menü explizit nach dem Servernamen suchen.
Eigene MCP-Server entwickeln
Wer einen eigenen MCP-Server betreiben will – etwa für eine interne API oder ein eigenes Datenbanksystem – startet am einfachsten mit dem offiziellen TypeScript-SDK:
npm install @modelcontextprotocol/sdk
Ein minimaler Server, der ein einzelnes Tool bereitstellt:
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server(
{ name: "mein-server", version: "1.0.0" },
{ capabilities: { tools: {} } }
);
// Tools registrieren, Anfragen verarbeiten
// ...
const transport = new StdioServerTransport();
await server.connect(transport);
Der eigene Server wird dann wie jeder andere in claude_desktop_config.json eingetragen – nur mit node statt npx als Befehl:
{
"mcpServers": {
"mein-server": {
"command": "node",
"args": ["/pfad/zu/meinem/server/index.js"]
}
}
}
Kurzreferenz
| Bereich | macOS | Windows |
|---|---|---|
| Config-Datei | ~/Library/Application Support/Claude/ claude_desktop_config.json | %APPDATA%\Claude\ claude_desktop_config.json |
| Neustart | Cmd + Q, neu öffnen | Taskleiste → Beenden, neu starten |
| Logs | ~/Library/Logs/Claude/ | %APPDATA%\Claude\logs\ |
| JSON validieren | python3 -m json.tool | python -m json.tool |
MCP-Referenzserver: github.com/modelcontextprotocol/servers
MCP ist kein Claude-exklusives Konzept. Auch ChatGPT nutzt MCP inzwischen im Kontext von Apps und Connectors; der volle Funktionsumfang – insbesondere Schreib- und Änderungsaktionen – ist je nach Plan und Umgebung unterschiedlich verfügbar. Dazu erscheint demnächst ein eigener Artikel.
Häufige Fragen zu MCP
Eine API ist eine fest definierte Schnittstelle, die ein Entwickler explizit in seinen Code einbaut. MCP ist ein Protokoll, das KI-Assistenten erlaubt, Werkzeuge dynamisch zu entdecken und zu nutzen — ohne dass der Assistent vorab wissen muss, was ein Server anbietet. Der Server beschreibt seine Fähigkeiten selbst; der Client (Claude) entscheidet zur Laufzeit, welches Tool er aufruft.
Nein. MCP ist ein offener Standard, den prinzipiell jeder Client implementieren kann. Claude Desktop ist derzeit die verbreitetste Möglichkeit, MCP-Server lokal einzubinden. Daneben gibt es Claude Code, weitere MCP-fähige Clients aus der Community sowie eigene Implementierungen. Die Konfiguration unterscheidet sich je nach Client.
Der MCP-Client ist die Gegenseite zum Server: die Anwendung, die MCP-Server startet, ihre Fähigkeiten abfragt und Tools aufruft. Claude Desktop ist ein MCP-Client. Auch Claude Code und einige Drittanwendungen implementieren die Client-Seite des Protokolls.
Das Protokoll selbst ist offen und kostenlos. Die Referenzserver des MCP-Projekts sind ebenfalls frei verfügbar. Kosten entstehen gegebenenfalls durch die KI-Nutzung selbst (Claude-Abo oder API-Kosten) sowie durch externe Dienste, die ein MCP-Server anbindet.
