So verbindest du MCP-Server mit Claude, ChatGPT und Cursor
Von der Kitbay-Redaktion ·
Um einen MCP-Server zu verbinden, gibst du deinem KI-Client entweder einen Befehl, der den Server auf deinem Rechner startet (lokaler Server), oder die URL eines online gehosteten Servers (Remote-Server). Jeder Client speichert das an einer eigenen Stelle: Claude Code und Codex per Terminalbefehl, Claude Desktop, Cursor und VS Code in einer JSON-Datei und ChatGPT in einem Einstellungsdialog.
Diese Anleitung zeigt, wo jeder Client diese Einstellung ablegt. Grundlagen findest du unter Was ist ein MCP-Server?.
Lokal oder remote: zuerst entscheiden
| Lokaler Server | Remote-Server | |
|---|---|---|
| Läuft auf | Deinem Rechner, gestartet vom Client | Der Infrastruktur des Anbieters |
| Transport | stdio (Standardein- und -ausgabe) | Streamable HTTP |
| Du gibst an | Einen Befehl, seine Argumente und gegebenenfalls Umgebungsvariablen | Eine URL, meist gefolgt von einer Anmeldung |
| Zugriff | Deine Dateien und Programme, mit den Rechten deines Benutzerkontos | Alles, was das Konto erlaubt, mit dem du dich anmeldest |
Laut MCP-Dokumentation bedient ein lokaler stdio-Server in der Regel einen einzigen Client, ein Remote-Server dagegen meist viele. Im README des Projekts steht, in welcher Form ein Server angeboten wird. Der Config-Generator von Kitbay erzeugt aus einem Satz Angaben das passende Snippet für mehrere Clients.
Claude Code
Claude Code fügt Server über das Terminal hinzu.
# remote server
claude mcp add --transport http notion https://mcp.notion.com/mcp
# local server; everything after -- is the server's own command
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server
Jeder Server hat einen Scope:
- local (Standard): nur du, nur dieses Projekt; gespeichert in
~/.claude.json. - project: geteilt über die Datei
.mcp.jsonim Stammverzeichnis des Projekts, die du mit committest. Claude Code fragt nach deiner Zustimmung, bevor es Server aus dieser Datei nutzt. - user: nur du, in jedem Projekt; gespeichert in
~/.claude.json.
Mit --scope project oder --scope user änderst du ihn. Innerhalb einer Sitzung zeigt /mcp den Status an und startet die OAuth-Anmeldung für Remote-Server, die eine brauchen. Mit claude mcp list und claude mcp remove <name> verwaltest du die Liste.
Claude Desktop
Claude Desktop verwaltet lokale und Remote-Server an unterschiedlichen Stellen.
Lokale Server trägst du in die Datei claude_desktop_config.json ein. Du öffnest sie über die Einstellungen (Settings), dort den Tab „Developer“ und dann Edit Config:
| System | Pfad |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
}
}
}
Beende die App nach dem Speichern vollständig und starte sie neu. Verwende absolute Pfade. Wenn ein Server nicht erscheint, sieh in die Logs: mcp.log und mcp-server-NAME.log liegen unter macOS in ~/Library/Logs/Claude, unter Windows und Linux im Ordner logs neben der Config-Datei.
Remote-Server fügst du als benutzerdefinierte Connectors hinzu: Öffne die Einstellungen, dann Connectors und Add custom connector, füge die URL ein und schließe die Anmeldung ab. Im selben Dialog kannst du einzelne Tools ein- und ausschalten.
ChatGPT
ChatGPT verbindet sich nur mit Servern, die es über das Netzwerk erreichen kann. Die Dokumentation von OpenAI beschreibt diesen Ablauf in ChatGPT im Web:
- Öffne die Seite „Plugins“, wähle das Plus-Symbol und dann Add custom MCP server.
- Gib einen Namen und die Server-URL ein oder wähle für einen privaten Server einen Tunnel.
- Wähle die Authentifizierung: OAuth, keine oder OAuth mit Fallback ohne Anmeldung.
- Lies die Risikowarnung, erstelle das Plugin und installiere es.
- Erwähne den Server in einem Chat mit
@, um ihn zu nutzen.
Unterstützt werden die Transporte SSE und Streaming-HTTP. ChatGPT lässt dich Schreibaktionen standardmäßig bestätigen und behandelt jedes Tool als Schreibaktion, solange der Server es nicht als schreibgeschützt markiert. Es gelten die Berechtigungen des Workspace, und die Verfügbarkeit kann von deinem Tarif abhängen. Sieh in deinen Kontoeinstellungen nach: Die aktuelle Liste der Tarife konnten wir auf den Seiten von OpenAI nicht bestätigen.
Cursor
Cursor liest zwei JSON-Dateien:
.cursor/mcp.jsonin einem Projekt, nur für dieses Projekt;~/.cursor/mcp.jsonin deinem Home-Verzeichnis, für alle Projekte.
{
"mcpServers": {
"local-example": { "command": "npx", "args": ["-y", "some-mcp-server"], "env": { "API_KEY": "${env:API_KEY}" } },
"remote-example": { "url": "https://example.com/mcp" }
}
}
Cursor unterstützt stdio, SSE und Streamable HTTP sowie OAuth für Remote-Server. Standardmäßig fragt Cursor nach, bevor es ein MCP-Tool ausführt, und du kannst die Abfrage aufklappen, um die Argumente zu sehen.
VS Code
In VS Code führst du in der Befehlspalette MCP: Add Server aus, wählst HTTP oder einen stdio-Befehl und legst fest, wo der Eintrag gespeichert wird. Die Dateien unterscheiden sich in ihrem Hauptschlüssel:
| Datei | Hauptschlüssel |
|---|---|
.vscode/mcp.json (Workspace) oder die mcp.json des Profils |
servers |
.mcp.json im Stammverzeichnis des Workspace |
mcpServers |
~/.copilot/mcp-config.json (Benutzer) |
mcpServers |
Laut der VS-Code-Referenz dienen die vom Editor verwalteten servers-Dateien einer älteren Agent-Architektur (Harness); für neue Copilot-Setups verweist sie auf die mcpServers-Dateien. Nutze die Funktion inputs (in servers-Dateien), um Secrets abzufragen, statt sie in geteilte Dateien zu schreiben. Unter macOS und Linux lassen sich stdio-Server mit "sandboxEnabled": true in einer Sandbox ausführen.
Codex
Codex speichert Server in ~/.codex/config.toml oder in .codex/config.toml innerhalb eines vertrauenswürdigen Projekts.
codex mcp add context7 -- npx -y @upstash/context7-mcp
[mcp_servers.example]
url = "https://example.com/mcp"
codex mcp login <name> startet OAuth, und /mcp in der Terminal-Oberfläche listet die aktiven Server auf. Die ChatGPT-Desktop-App, Codex CLI und die IDE-Erweiterung nutzen diese Konfiguration gemeinsam.
Andere Clients
Gemini CLI nutzt einen mcpServers-Block in ~/.gemini/settings.json oder .gemini/settings.json und bietet dazu den Befehl gemini mcp add. Die Option trust: true überspringt jede Bestätigung; verwende sie also nur für Server, die du selbst kontrollierst. Windsurf, Cline und Zed haben eigene Einstellungen; Details findest du auf ihren Client-Seiten.
Sicherheitshinweis
Ein lokaler Server läuft mit den Rechten deines Benutzerkontos und kann mit deinen Dateien alles tun, was du auch kannst. Ein Remote-Server handelt mit den Berechtigungen des Kontos, mit dem du dich anmeldest. Installiere nur Server, deren Quellcode du geprüft hast, bewahre Keys in Umgebungsvariablen statt in geteilten Dateien auf und lies vorher unsere Sicherheitsfragen zu MCP.
Server nach Client finden
Jeder MCP-Server-Eintrag auf Kitbay vermerkt, welche Clients die Dokumentation des Servers selbst abdeckt. Wenn du einen eigenen Server bauen willst, lies So baust du einen MCP-Server.
Fragen
- Wie füge ich einen MCP-Server zu Claude Desktop hinzu?
- Für einen lokalen Server öffnest du die Einstellungen, dann Developer und Edit Config, trägst den Server unter mcpServers in claude_desktop_config.json ein und startest die App neu. Für einen Remote-Server gehst du in den Einstellungen zu Connectors und fügst einen benutzerdefinierten Connector mit der URL des Servers hinzu.
- Kann ChatGPT lokale MCP-Server nutzen?
- Die Dokumentation von OpenAI beschreibt, wie du einen Server per URL oder über einen Secure MCP Tunnel hinzufügst. Ein Server, der nur auf deinem Rechner läuft, braucht also einen Tunnel oder eine öffentliche HTTPS-Adresse. ChatGPT im Web liest keine lokale Codex-Konfiguration.
- Wo liegt die MCP-Config-Datei von Cursor?
- Cursor liest .cursor/mcp.json in einem Projekt für die Server dieses Projekts und ~/.cursor/mcp.json in deinem Home-Verzeichnis für Server, die überall verfügbar sein sollen.
- Nutzen Codex CLI und die Codex-IDE-Erweiterung dieselben MCP-Einstellungen?
- Ja. Laut der Dokumentation von OpenAI teilen sich die ChatGPT-Desktop-App, Codex CLI und die IDE-Erweiterung dieselbe MCP-Konfiguration, die standardmäßig in ~/.codex/config.toml liegt.
Quellen
- Connect Claude Code to tools via MCP (Claude Code docs)geprüft am 14. Nov. 2026
- Connect to local MCP servers (MCP docs)geprüft am 14. Nov. 2026
- Connect to remote MCP servers (MCP docs)geprüft am 14. Nov. 2026
- Developer mode and custom MCP servers in ChatGPT (OpenAI docs)geprüft am 14. Nov. 2026
- Model Context Protocol (Cursor docs)geprüft am 14. Nov. 2026
- Add and manage MCP servers in VS Codegeprüft am 14. Nov. 2026
- MCP configuration reference (VS Code docs)geprüft am 14. Nov. 2026
- MCP in Codex (OpenAI docs)geprüft am 14. Nov. 2026
- MCP servers with Gemini CLIgeprüft am 14. Nov. 2026
- MCP architecture overviewgeprüft am 14. Nov. 2026
Weitere Anleitungen
- So baust du einen MCP-Server
- So erstellst du eigene Skills für Claude Code
- MCP-Sicherheit: Was du vor der Installation eines Servers oder Skills prüfen solltest
- MCP vs. API: Was ist der Unterschied?
- MCP vs. Skills: So unterscheiden sich MCP-Server und Agent Skills
- Was ist ein Claude Skill?
- Was ist ein MCP-Server?