Zum Inhalt springen
Kitbay

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.json im 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:

  1. Öffne die Seite „Plugins“, wähle das Plus-Symbol und dann Add custom MCP server.
  2. Gib einen Namen und die Server-URL ein oder wähle für einen privaten Server einen Tunnel.
  3. Wähle die Authentifizierung: OAuth, keine oder OAuth mit Fallback ohne Anmeldung.
  4. Lies die Risikowarnung, erstelle das Plugin und installiere es.
  5. 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.json in einem Projekt, nur für dieses Projekt;
  • ~/.cursor/mcp.json in 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

Weitere Anleitungen