Was ist MCP? Den ersten MCP-Server Schritt für Schritt einrichten

Was ist MCP? MCP (Model Context Protocol) ist ein offener Standard, über den sich eine KI-App wie Claude, ChatGPT oder Cursor mit externen Systemen verbindet: Dateien, Datenbanken, Kalender, Notion oder GitHub. Die Macher vergleichen ihn in der offiziellen Dokumentation mit einem USB-C-Anschluss: ein Stecker, der zu vielen Geräten passt.

In dieser Anleitung erkläre ich, wie MCP im Inneren funktioniert, und dann binden wir den ersten MCP-Server in Claude Code (remote und lokal) sowie in der Claude-App an. Die Befehle stammen aus der Dokumentation von Claude Code und dem Repository der MCP-Referenzserver.

Was ist MCP in der Praxis?

Ein Sprachmodell sieht von sich aus weder deine Dateien noch deinen Kalender. Damit ein KI-Agent in der Welt etwas tun kann, braucht er Werkzeuge (was ein Agent überhaupt ist, habe ich in Was ist ein KI-Agent erklärt). Ohne gemeinsamen Standard müsste jede App jedes Tool auf eigene Weise anbinden.

MCP ändert das: Jemand schreibt einmal einen MCP-Server für einen Dienst, und danach nutzt ihn jede App, die das Protokoll unterstützt. Die Dokumentation nennt Beispiele dafür, was das möglich macht:

1. ein Agent mit Zugriff auf deinen Google Kalender und Notion,
2. Claude Code, das eine komplette Web-App aus einem Figma-Entwurf baut,
3. ein Firmen-Chatbot, der an mehrere Datenbanken gleichzeitig angebunden ist,
4. ein Modell, das ein 3D-Objekt in Blender entwirft und an den Drucker schickt.

Woher kommt MCP?

Anthropic hat MCP am 25. November 2024 als Open Source veröffentlicht. Ein Jahr später, am 9. Dezember 2025, übergab das Unternehmen das Protokoll an die Agentic AI Foundation, einen Fonds unter dem Dach der Linux Foundation, den auch OpenAI und Block mitgegründet haben. Damit gehört MCP keiner einzelnen Firma mehr.

Heute unterstützen unter anderem Claude, ChatGPT, Visual Studio Code und Cursor das Protokoll. Ein einmal geschriebener Server läuft also an vielen Stellen.

Wie funktioniert MCP im Inneren?

Laut der Architekturbeschreibung gibt es in MCP drei Rollen:

1. Host, also die KI-App, die du nutzt (zum Beispiel Claude Code oder Claude Desktop),
2. Client, eine Komponente im Host. Der Host erstellt für jeden Server einen eigenen Client,
3. Server, das Programm, das Daten und Tools bereitstellt.

Ein Server kann lokal laufen (auf deinem Rechner, Kommunikation über Standardein- und -ausgabe, kurz „stdio“) oder remote (im Internet, über „Streamable HTTP“). Die Nachrichten nutzen das Format JSON-RPC 2.0.

Ein Server stellt drei Arten von Dingen bereit:

1. Tools, also Funktionen, die das Modell aufrufen kann, etwa eine Datenbankabfrage oder das Schreiben einer Datei,
2. Ressourcen (resources), also Daten für den Kontext, etwa der Inhalt einer Datei oder ein Datenbankschema,
3. Prompts, also fertige Vorlagen für die Interaktion mit dem Modell.

Der Ablauf ist einfach: Der Client fragt den Server nach der Liste seiner Tools (tools/list), das Modell wählt eins aus, und der Client ruft es auf (tools/call) und gibt das Ergebnis an das Modell zurück. Spannend finde ich: In der aktuellen Version der Spezifikation (2026-07-28) ist das Protokoll zustandslos. Jede Anfrage enthält also alles, was der Server braucht, um sie zu bearbeiten.

Schritt 1: Wie binde ich einen Remote-MCP-Server an Claude Code an?

Ich gehe davon aus, dass Claude Code schon installiert ist (falls nicht, fang mit meiner Claude Code Anleitung an). Ein Remote-HTTP-Server ist laut Dokumentation die empfohlene Option. Die Grundsyntax sieht so aus:

claude mcp add --transport http <name> <url>

Das Beispiel aus der Dokumentation, die Anbindung von Notion:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Die meisten Remote-Server verlangen eine Anmeldung. Dann tippst du in der Claude-Code-Sitzung /mcp ein und meldest dich im Browser an. Derselbe Befehl zeigt auch den Status aller angebundenen Server.

Nutzt der Server statt einer Anmeldung ein Token, fügst du einen Header hinzu:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Schritt 2: Wie starte ich einen lokalen MCP-Server?

Ein lokaler Server läuft auf deinem Rechner als ganz normaler Prozess. Ein gutes erstes Beispiel ist der Referenz-Dateisystem-Server, der dem Modell nur Zugriff auf die angegebenen Verzeichnisse gibt. Du brauchst Node.js (für npx).

Den Befehl des Servers schreibst du nach --, und alles nach diesem Zeichen geht unverändert an den Server:

claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/notizen

Das letzte Argument ist das Verzeichnis, auf das der Server zugreifen darf (du kannst mehrere angeben). Der Server bietet unter anderem die Tools read_text_file, write_file, edit_file, list_directory und search_files. Jetzt kannst du Claude Code zum Beispiel bitten: „Finde in meinen Notizen alles zu MCP und mach daraus eine Liste“.

Braucht der Server einen API-Schlüssel, übergibst du ihn mit --env. Ein Beispiel aus der Dokumentation:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Schritt 3: Wie verwalte ich MCP-Server?

Für die Verwaltung reichen drei einfache Befehle:

claude mcp list          # Server auflisten
claude mcp get notion    # Details zu einem Server
claude mcp remove notion # Server entfernen

Wichtig ist auch der Geltungsbereich (scope), also wo der Server gespeichert wird:

Scope	Wo er gilt	Teilt das Team ihn?	Wo er gespeichert ist
local (Standard)	nur im aktuellen Projekt	nein	~/.claude.json
project	nur im aktuellen Projekt	ja, über das Repository	.mcp.json im Projektverzeichnis
user	in all deinen Projekten	nein	~/.claude.json

Den Scope wählst du mit dem Flag --scope, etwa --scope user. Beim Scope project gehören API-Schlüssel in Umgebungsvariablen (${VAR} in der Datei .mcp.json), damit sie nicht im Repository landen.

Schritt 4: Wie füge ich einen MCP-Server in der Claude-App hinzu?

In der Claude-App (Web und Desktop) heißen MCP-Server Konnektoren. Fertige findest du im Konnektor-Verzeichnis, einen eigenen Remote-Server fügst du als „custom connector“ hinzu. Laut dem Claude-Hilfecenter:

1. öffne Customize > Connectors,
2. klicke auf „+ Add“ und dann auf „Add custom connector“,
3. gib einen Namen und die URL des Remote-MCP-Servers ein,
4. prüfe die Anmeldeeinstellungen und klicke auf „Add“.

Konnektoren funktionieren in allen Plänen, im kostenlosen Plan kannst du aber nur einen eigenen Konnektor hinzufügen. Achtung: Claude verbindet sich aus der Cloud von Anthropic mit dem Server, der Server muss also aus dem Internet erreichbar sein. Auch andere Claude-Funktionen nutzen die Konnektoren, zum Beispiel der Agent Claude Duet.

Worauf solltest du achten?

Erstens darauf, wem du vertraust. Ein MCP-Server gibt dem Modell echte Handlungsmöglichkeiten, und die Dokumentation von Claude Code warnt ausdrücklich, dass Server, die Inhalte von außen abrufen, dich für Prompt Injection angreifbar machen. Das Hilfecenter ergänzt, dass bösartige Server versteckte Anweisungen enthalten können, die Claude zu unbeabsichtigten Aktionen verleiten wollen. Binde nur Server von Firmen und Entwicklern an, denen du vertraust.

Zweitens auf die Berechtigungen. Klick „Allow always“ nur bei Tools, denen du genug vertraust, um sie unbeaufsichtigt laufen zu lassen. Die gute Nachricht: Ein geklontes Repository kann seine Server aus .mcp.json nicht selbst freigeben, Claude Code fragt dich zuerst um Erlaubnis.

Drittens auf den Zugriffsumfang. Gib dem Dateisystem-Server nur ein bestimmtes Verzeichnis, nicht die ganze Festplatte. Mehr zur Absicherung von Schlüsseln und Agenten steht in meinem Beitrag KI-Agenten-Sicherheit.

FAQ

Was ist MCP in einfachen Worten?

Ein gemeinsamer Standard, über den KI-Apps sich mit Tools und Daten verbinden. Ein einmal geschriebener MCP-Server funktioniert in vielen Apps, so wie ein USB-C-Gerät mit vielen Computern funktioniert.

Funktioniert MCP nur mit Claude?

Nein. Das Protokoll stammt von Anthropic, heute entwickelt es aber die Agentic AI Foundation unter dem Dach der Linux Foundation weiter, und unterstützt wird es unter anderem von ChatGPT, Visual Studio Code und Cursor.

Was unterscheidet einen lokalen von einem Remote-MCP-Server?

Ein lokaler Server läuft auf deinem Rechner und kommuniziert über stdio, meist mit einer einzigen App. Ein Remote-Server läuft im Internet (Streamable HTTP) und bedient meist viele Clients gleichzeitig. Für die Anmeldung empfiehlt die Spezifikation OAuth.

Ist MCP kostenlos?

Das Protokoll selbst ist offen und kostenlos. Du bezahlst für die KI-App, die du nutzt, und eventuell für den Dienst, mit dem sich der Server verbindet.