Praxisleitfäden
MCP-Server in Claude Code, Cursor und VS Code einrichten
Was das Model Context Protocol ist, wie Sie einen Server zu Claude Code, Cursor und VS Code hinzufügen, welche Referenzserver es gibt und welche Sicherheitsregeln gelten – laut offizieller Dokumentation.
Ein MCP-Server gibt einem Coding-Agenten Zugriff auf ein externes Tool: ein GitHub-Repository, eine Datenbank, einen Browser, die Dokumentation einer Bibliothek. Diese Anleitung erklärt das Protokoll und dann die Einrichtung in drei gängigen Clients. Befehle und Dateien stammen aus der offiziellen Dokumentation, geprüft am 20.10.2026.
Was ist MCP?
Das Model Context Protocol (MCP) ist ein Open-Source-Standard, um KI-Anwendungen mit externen Systemen zu verbinden: lokale Dateien, Datenbanken, Tools wie eine Suchmaschine oder Workflows. Seine Autoren vergleichen es mit einem USB-C-Anschluss für KI-Anwendungen (modelcontextprotocol.io). Siehe auch den Glossareintrag zu MCP.
- Was ein Server bereitstellt: Tools (Aktionen, die das Modell ausführen kann), Ressourcen (Kontextdaten) und Prompts (Anweisungsvorlagen) (MCP-Architektur).
- Zwei Transportarten: stdio, wenn der Client den Server als lokalen Prozess auf demselben Rechner startet; Streamable HTTP für einen entfernten Server, der Bearer-Tokens, API-Schlüssel und benutzerdefinierte Header unterstützt.
Einen Server zu Claude Code hinzufügen
Claude Code wird über die Kommandozeile konfiguriert (Anthropic). Ist der Agent noch nicht installiert, lesen Sie unseren Leitfaden Claude Code installieren und loslegen.
Entfernter Server (HTTP), die empfohlene Option für Online-Dienste:
# Grundsyntax
claude mcp add --transport http <name> <url>
# Konkretes Beispiel: mit Notion verbinden
claude mcp add --transport http notion https://mcp.notion.com/mcp
Lokaler Server (stdio): Alles nach -- ist der Befehl, der den Server startet.
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
-- npx -y airtable-mcp-server
Der SSE-Transport ist veraltet: Anthropic empfiehlt HTTP, wo der Server es unterstützt. So verwalten Sie Server:
# Alle konfigurierten Server auflisten
claude mcp list
# Details zu einem bestimmten Server abrufen
claude mcp get notion
# Einen Server entfernen
claude mcp remove notion
# (innerhalb von Claude Code) Serverstatus prüfen
/mcp
Drei Geltungsbereiche (Option --scope):
local(Standard): das aktuelle Projekt, nur für Sie, gespeichert in~/.claude.json;project: mit Ihrem Team geteilt über eine Datei.mcp.jsonim Stammverzeichnis des Repositorys, die eingecheckt wird;user: alle Ihre Projekte, gespeichert in~/.claude.json.
Ein geklontes Repository kann die Server in seiner .mcp.json nicht selbst freigeben: Sie bleiben ausstehend, bis Sie den Dialog zum Workspace-Vertrauen bestätigen. Offizielles Beispiel mit dem entfernten Server von GitHub, authentifiziert mit einem eng gefassten Personal Access Token:
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"
claude mcp add speichert die Konfiguration, ohne das Token zu validieren: Prüfen Sie die Verbindung mit /mcp.
Einen Server zu Cursor hinzufügen
Cursor bietet die Installation mit einem Klick aus seinem Marketplace (Seite Customize, Schaltfläche „Add to Cursor“, Anmeldung per OAuth) oder die manuelle Konfiguration in einer Datei mcp.json (Cursor):
.cursor/mcp.jsonim Projekt, für projektspezifische Tools;~/.cursor/mcp.jsonin Ihrem Home-Verzeichnis, für überall verfügbare Tools.
Ein mit Node.js gestarteter lokaler Server, wie in der Dokumentation von Cursor gezeigt:
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "mcp-server"],
"env": {
"API_KEY": "value"
}
}
}
}
Bei einem entfernten Server verwendet der Eintrag statt command einen Schlüssel url (und optional headers). Cursor unterstützt stdio, SSE und Streamable HTTP und löst die Syntax ${env:NAME} auf, sodass Sie ein Geheimnis aus einer Umgebungsvariablen lesen können, statt es im Klartext zu schreiben.
Einen Server zu VS Code hinzufügen
Öffnen Sie in VS Code die Befehlspalette (⇧⌘P auf dem Mac, Strg+Shift+P unter Windows und Linux) und führen Sie MCP: Add Server aus (Microsoft). Wählen Sie HTTP, wenn der Herausgeber des Servers eine URL angibt, und Command (stdio), wenn er einen Befehl angibt. Das Beispiel der Dokumentation, der Playwright-Server, benötigt Node.js 18 oder neuer:
node --version
npx --version
Wählen Sie Command (stdio) und geben Sie ein:
npx -y @playwright/mcp@latest
Vergeben Sie dem Server eine ID (zum Beispiel playwright) und wählen Sie dann den Speicherort:
- Global > Copilot Global:
~/.copilot/mcp-config.json, für alle Ihre Workspaces; - **
.mcp.jsonim Workspace-Stamm**: zum Teilen mit Ihrem Team (experimentelle Einstellungchat.mcp.workspaceRootConfig.enabled); - **
.vscode/mcp.jsonoder diemcp.jsondes Benutzerprofils**: weiterhin verfügbar, im geführten Ablauf aber als veraltet gekennzeichnet.
Achten Sie auf das Format: Portable Dateien verwenden den Schlüssel mcpServers, das VS-Code-Format verwendet servers. Die Server-Galerie (Preview) öffnet sich, wenn Sie in der Erweiterungsansicht @mcp eingeben. Microsoft empfiehlt außerdem zu prüfen, dass in Ihrer Sitzung tatsächlich ein Tool des Servers aufgerufen wurde: Eine hinzugefügte Konfiguration ist kein Beweis dafür, dass der Agent sie nutzt.
Referenzserver
Das MCP-Projekt pflegt Referenzserver, um das Protokoll auszuprobieren: Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking und Time (offizielle Beispiele). TypeScript-Server laufen mit npx, Python-Server mit uvx:
npx -y @modelcontextprotocol/server-memory
uvx mcp-server-git
Von Unternehmen für ihre eigenen Plattformen gepflegte Server sind im Repository modelcontextprotocol/servers aufgeführt.
Sicherheit: Regeln, die Sie beachten sollten
Ein lokaler MCP-Server ist kein Plugin in einer Sandbox: Er ist ein gewöhnlicher Prozess, der Ihre Umgebungsvariablen erbt, alles lesen kann, was Ihr Konto lesen kann (SSH-Schlüssel, Cloud-Zugangsdaten, Home-Verzeichnis), und Netzwerkverbindungen öffnen kann (modelcontextprotocol.io). Die offiziellen Empfehlungen:
- Bestandsaufnahme machen: Entfernen Sie Server, die Sie nicht mehr nutzen, und wissen Sie, woher jeder verbleibende stammt;
- Die entfernte Variante bevorzugen, wenn ein Server nichts von Ihrem Rechner braucht;
- Den Herausgeber prüfen und die Version festlegen statt
latest, mit bewusster Update-Gewohnheit. Das Playwright-Beispiel von VS Code verwendet@latest: Passen Sie es an Ihre eigene Richtlinie an; - Server von Drittanbietern isolieren (Container, Sandbox oder virtuelle Maschine);
- Zugriff begrenzen: Zugangsdaten pro Server, Dateisystemzugriff auf ein bestimmtes Verzeichnis beschränkt, wo möglich schreibgeschützt, eingeschränkter ausgehender Netzwerkverkehr;
- Tool-Beschreibungen lesen: Das Modell liest sie als Anweisungen, was Prompt-Injection Tür und Tor öffnet.
Anthropic bittet außerdem darum, vor dem Verbinden jedes Servers zu prüfen, ob man ihm vertraut, besonders bei Servern, die externe Inhalte abrufen (Anthropic). Cursor empfiehlt API-Schlüssel mit minimalen Berechtigungen und, bei kritischen Integrationen, die Prüfung des Quellcodes (Cursor).
Weiterführendes
- Die Tool-Seiten zeigen, welche Tools MCP unterstützen: Claude Code, Cursor, GitHub Copilot, Cline.
- Editoren vergleichen: Cursor, Devin Desktop oder Copilot.
- Die Risiken von generiertem Code: was Studien zur Sicherheit sagen.
Quellen
- Model Context Protocol: What is MCP?, geprüft am 20.10.2026
- Model Context Protocol: Architecture overview, geprüft am 20.10.2026
- Model Context Protocol: Example Servers, geprüft am 20.10.2026
- Model Context Protocol: Local Server Security, geprüft am 20.10.2026
- Claude Code Docs: Connect Claude Code to tools via MCP, geprüft am 20.10.2026
- Cursor Docs: Model Context Protocol, geprüft am 20.10.2026
- VS Code Docs: Add MCP servers in VS Code, geprüft am 20.10.2026
Fazit: Einen MCP-Server hinzuzufügen erfordert einen Befehl oder ein paar Zeilen JSON, aber ein lokaler Server läuft mit Ihren Berechtigungen: Installieren Sie nur Server von identifizierten Herausgebern, mit festgelegten Versionen und eingeschränktem Zugriff.
Einen Fehler in diesem Artikel entdeckt? Melden Sie ihn · Unsere Korrekturrichtlinie