Model Context Protocol (MCP): Was es ist und wie man es konfiguriert

Für den größten Teil der kurzen Geschichte der KI bedeutete das Verbinden eines Sprachmodells mit einem externen Tool, für jedes einzelne Tool benutzerdefinierten Integrationscode zu schreiben. Das Modell soll eine Datei lesen? Eine Funktion schreiben. Eine Datenbank abfragen? Eine andere Funktion schreiben, in einem anderen Format, für jedes Modell, das man unterstützen möchte. Das Ergebnis war ein fragmentiertes Ökosystem, in dem jede KI-Anwendung dieselbe Infrastruktur von Grund auf neu erfand.

Model Context Protocol (MCP) ist Anthropics Antwort auf dieses Problem: ein offener Standard, der KI-Modellen eine einheitliche, konsistente Schnittstelle zu Tools, Dateien, Datenbanken und Diensten gibt. Mit dem BrowseryTools MCP-Konfigurations-Generator – kostenlos, keine Anmeldung, alles bleibt im Browser – können MCP-Konfigurationsdateien erstellt und validiert werden, ohne JSON von Hand zu schreiben.

Was ist MCP und warum gibt es es?

MCP steht für Model Context Protocol. Es ist ein offenes Protokoll – Ende 2024 von Anthropic veröffentlicht und unter modelcontextprotocol.io verfügbar –, das standardisiert, wie KI-Modelle mit externen Datenquellen und Tools kommunizieren. Man kann es sich als universellen Adapter vorstellen: Statt dass ein Modell ein benutzerdefiniertes Plugin für GitHub, ein anderes für das Dateisystem und noch ein anderes für die Datenbank benötigt, bietet MCP eine einzige Schnittstelle, die jeder konforme Client und Server sprechen kann.

Die Analogie, die Anthropic verwendet, ist USB-C: Vor USB-C brauchte man für jedes Gerät ein anderes Kabel. MCP möchte dieser universelle Stecker für KI-Tool-Nutzung sein. Ein Tool, das einmal als MCP-Server gebaut wurde, funktioniert mit jedem MCP-kompatiblen Client – Claude Desktop, Claude Code und jedem anderen Host, der das Protokoll implementiert.

MCP-Architektur: Clients, Hosts und Server

MCP hat drei Komponenten, die zusammenarbeiten:

• Host – Die KI-Anwendung, die auf dem Gerät des Nutzers läuft (z. B. Claude Desktop, eine IDE-Erweiterung). Der Host verwaltet Verbindungen zu einem oder mehreren MCP-Servern und injiziert ihre Fähigkeiten in den KI-Kontext.
• Client – Ein Protokoll-Client, der im Host eingebettet ist und eine 1:1-Verbindung mit einem einzelnen MCP-Server aufrechterhält. Der Host erstellt einen Client pro Server.
• Server – Ein leichtgewichtiges Programm, das Fähigkeiten (Tools, Ressourcen, Prompts) über das MCP-Protokoll exponiert. Server können lokale Prozesse (auf dem eigenen Gerät) oder entfernte Dienste, die über HTTP erreichbar sind, sein.

Wenn man Claude bittet, „die README in meinem Projekt zu lesen", sendet der MCP-Client des Hosts eine Anfrage an den Dateisystem-MCP-Server, der die Datei liest und den Inhalt zurückgibt. Claude berührt das Dateisystem nie direkt – der Server tut es und meldet über das Protokoll zurück.

Was MCP-Server exponieren können

MCP-Server können drei Arten von Fähigkeiten exponieren:

• Tools – Funktionen, die das Modell aufrufen kann. Beispiele: Datenbank durchsuchen, ein GitHub-Issue erstellen, einen Terminal-Befehl ausführen, eine URL abrufen.
• Ressourcen – Daten, die das Modell lesen kann. Beispiele: Dateien, Datenbankzeilen, API-Antworten, Dokumentationsseiten. Ressourcen sind wie schreibgeschützte Kontextquellen.
• Prompts – Vorgefertigte Prompt-Vorlagen, die Nutzer namentlich aufrufen können. Nützlich für das Exponieren standardisierter Workflows.

Bekannte MCP-Server im Überblick

• filesystem – Liest und schreibt Dateien auf dem lokalen Gerät innerhalb eines angegebenen Verzeichnisses. Der am häufigsten verwendete Server. Erforderlich für Claude Code, um die Codebasis zu lesen.
• github – Durchsucht Repositories, liest Dateien, erstellt Issues und Pull Requests, ruft den Commit-Verlauf ab. Verwendet die GitHub-API mit einem persönlichen Access-Token.
• postgres / sqlite – Führt SQL-Abfragen gegen eine Datenbank aus. Standardmäßig in den meisten Implementierungen schreibgeschützt.
• brave-search / fetch – Ruft URLs ab oder führt Web-Suchanfragen durch, wodurch das Modell Zugang zu aktuellen Informationen jenseits seines Trainings erhält.
• memory – Dauerhafter Key-Value-Speicher, der zwischen Sitzungen erhalten bleibt. Gibt dem Modell eine Speicherschicht, auf die es schreiben und aus der es lesen kann.
• puppeteer / playwright – Steuert einen Headless-Browser. Ermöglicht dem Modell, durch Webseiten zu navigieren, Formulare auszufüllen und Inhalte von JavaScript-gerenderten Seiten zu extrahieren.

Eine einfache MCP-Konfigurations-JSON schreiben

Die MCP-Konfiguration liegt in einer JSON-Datei, die die Host-Anwendung beim Start liest. Für Claude Desktop auf macOS befindet sich diese Datei unter ~/Library/Application Support/Claude/claude_desktop_config.json. Die Struktur ist konsistent, unabhängig davon, welche Server hinzugefügt werden:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents",
        "/Users/yourname/Projects"
      ]
    }
  }
}

Jeder Schlüssel innerhalb von mcpServers ist der Name, den man dem Server gibt – das ist das Label, das in der Claude-UI erscheint. Die Felder command und args definieren, wie der Server-Prozess gestartet wird. Die meisten offiziellen Server sind npm-Pakete, daher lädt npx -y sie beim ersten Einsatz herunter und führt sie aus, ohne einen separaten Installationsschritt.

Mehrere Server hinzufügen

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

Das Feld env übergibt Umgebungsvariablen an den Server-Prozess. Sensible Werte wie API-Schlüssel und Datenbank-Anmeldedaten gehören hierher, nicht hartcodiert in args, damit sie separat verwaltet werden können und ein versehentliches Committen in die Versionskontrolle vermieden wird.

MCP in Claude Code konfigurieren

Claude Code (das CLI-Tool) verwendet einen leicht anderen Konfigurationsmechanismus. MCP-Server werden mit dem Befehl claude mcp add hinzugefügt:

# Lokalen stdio-Server hinzufügen
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# Entfernten HTTP-Server hinzufügen
claude mcp add my-server --transport http http://localhost:8080/mcp

# Mit Umgebungsvariablen hinzufügen
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_... -- npx -y @modelcontextprotocol/server-github

# Alle konfigurierten Server auflisten
claude mcp list

Claude Code speichert Server-Konfigurationen standardmäßig in ~/.claude/(Nutzerbereich) oder in .mcp.json im Projektstamm (Projektbereich). Projektbezogene Konfigurationen sind nützlich für Team-Repositories – die .mcp.json committen und jeder im Team erhält automatisch dieselbe Server-Konfiguration.

Häufige Konfigurationsfehler

• Falsches Pfadtrennzeichen – Windows verwendet Backslashes, aber JSON-Strings erfordern Forward-Slashes oder escaped Backslashes. In MCP-Konfigurationen immer Forward-Slashes verwenden, auch unter Windows.
• Fehlende Verzeichnisberechtigungen – Der Dateisystem-Server kann nur auf Verzeichnisse zugreifen, die explizit in seinen Args aufgelistet sind. Wenn Claude sagt, es kann eine Datei nicht finden, prüfen, ob das übergeordnete Verzeichnis der Datei in der erlaubten Liste steht.
• Veralteter Server-Prozess – Wenn ein Server abstürzt, startet der Host ihn möglicherweise nicht automatisch neu. Claude Desktop neu starten oder claude mcp restart <name> in Claude Code ausführen, um eine neue Verbindung herzustellen.
• Versionsunverträglichkeiten – MCP wird aktiv entwickelt. Wenn sich ein Server unerwartet verhält, prüfen, ob die neueste Version mit npx -y @modelcontextprotocol/server-name@latest ausgeführt wird.

Konfiguration mit BrowseryTools generieren

MCP-JSON von Hand zu schreiben ist mühsam und leicht fehleranfällig – ein fehlendes Komma oder ein falsch quoted Pfad lässt die gesamte Konfiguration stillschweigend scheitern. Der BrowseryTools MCP-Konfigurations-Generator ermöglicht es, Server auszuwählen, die erforderlichen Parameter auszufüllen und eine gültige, formatierte JSON-Konfiguration zu erhalten, die in die Claude-Desktop-Konfigurationsdatei oder .mcp.json eingefügt werden kann. Alles läuft im Browser und keine Zugangsdaten werden gespeichert.

Zusammenfassung

MCP ist die Infrastrukturschicht, die ein eigenständiges Chat-Modell in einen vernetzten Agenten mit Zugang zu den eigenen tatsächlichen Dateien, Code, Datenbanken und Diensten verwandelt. Das Protokoll ist offen, die Server sind modular und das Konfigurationsformat ist unkompliziertes JSON. Ist die MCP-Konfiguration eingerichtet, erhält man einen dramatisch fähigeren KI-Assistenten, ohne die Art der Interaktion zu ändern – die Tools sind einfach da, bereit zur Verwendung.