einfachskills_

Praxis · 6 Min.

MCP-Server in Claude Code einrichten: Schritt für Schritt

Einen MCP-Server bindest du in Claude Code mit dem Befehl claude mcp add ein: Du gibst dem Server einen Namen und entweder einen Startbefehl (lokaler Server) oder eine URL (entfernter Server). Danach entscheidest du über den Geltungsbereich, wer den Server sieht: nur du, das Projekt oder alle deine Projekte.

Was heißt „einen MCP-Server einrichten"?

Ein MCP-Server ist ein Programm, das Claude Code über das Model Context Protocol Werkzeuge und Daten eines externen Systems bereitstellt — was das genau ist, erklärt Was ist ein MCP-Server. „Einrichten" heißt hier nicht, den Server zu bauen, sondern einen bereits existierenden Server bei Claude Code anzumelden, damit der Agent seine Werkzeuge nutzen kann.

Der Unterschied ist wichtig: Für die allermeisten Dienste — Dateisystem, Git, GitHub, Browser — gibt es fertige Server. Eine Auswahl steht in der MCP-Server-Liste. Du musst sie nur registrieren.

Schritt 1: Den Server hinzufügen

Der zentrale Befehl ist claude mcp add (Stand Juli 2026 — prüf die aktuelle Syntax in Anthropics Dokumentation, sie wird gelegentlich erweitert). Für einen lokalen Server gibst du einen Namen und den Startbefehl an:

claude mcp add mein-server -- <startbefehl des servers>

Alles nach dem -- ist der Befehl, mit dem Claude Code den Server startet. Ein entfernter Server wird stattdessen über seine HTTP-Adresse eingebunden. Braucht der Server Zugangsdaten — etwa einen API-Schlüssel —, werden diese in der Regel als Umgebungsvariablen mitgegeben.

Schritt 2: Den richtigen Geltungsbereich wählen

Claude Code kennt drei Ebenen, auf denen ein Server gelten kann:

  • Lokal: nur für dich, nur in diesem Projekt. Der Standard, gut zum Ausprobieren.
  • Projekt: in einer Konfigurationsdatei im Projektordner hinterlegt, die du ins Git-Repository committen kannst. So bekommt dein ganzes Team dasselbe Setup.
  • Nutzer: gilt über alle deine Projekte hinweg — sinnvoll für Server, die du überall brauchst, etwa einen Dateisystem-Server.

Faustregel: Zum Testen lokal, für Team-Werkzeuge auf Projektebene, für persönliche Dauerbrenner auf Nutzerebene.

Schritt 3: Prüfen, ob der Server läuft

Nach dem Hinzufügen listest du die registrierten Server auf, um ihren Status zu sehen. Läuft alles, tauchen die Werkzeuge des Servers im Kontext des Agents auf, sobald eine passende Aufgabe kommt. Startet der Server nicht, siehst du hier meist die Fehlerursache — falscher Befehl, fehlende Zugangsdaten oder eine nicht erreichbare Adresse.

Ein häufiger Stolperstein: Läuft die Claude-Code-Session schon, kennt sie den frisch hinzugefügten Server noch nicht. Ein Neustart der Session behebt das.

Welche Server eignen sich für den Anfang?

Wer zum ersten Mal einen MCP-Server einrichtet, fängt am besten mit etwas Überschaubarem an, dessen Wirkung sofort sichtbar ist:

  • Dateisystem-Server: gibt dem Agent kontrollierten Zugriff auf bestimmte Ordner — ein gutes erstes Beispiel, weil du das Ergebnis direkt an geänderten Dateien siehst.
  • Git-Server: lässt den Agent den Verlauf und Zustand eines Repositories abfragen.
  • GitHub-Server: öffnet Issues, Pull Requests und Repositories — praktisch, sobald du mit dem Agent an gehosteten Projekten arbeitest.

Diese drei sind gut dokumentiert und weit verbreitet. Richte zuerst einen davon lokal ein, prüfe, dass seine Werkzeuge auftauchen, und erweitere dann schrittweise. So bekommst du ein Gefühl dafür, wie sich ein Server im Alltag anfühlt, bevor du heiklere Dienste wie eine Datenbank anbindest — für die dann die Hinweise aus MCP-Server absichern gelten.

Wann lohnt sich ein eigener Server statt eines fertigen?

Sobald du ein System anbinden willst, für das es keinen gepflegten Server gibt — deine interne Datenbank, ein eigenes API, spezielle Hardware. Dann führt der Weg über ein SDK; die konkrete Umsetzung in Python zeigt MCP-Server mit Python bauen, den grundsätzlichen Einstieg MCP-Server erstellen.

Für alles andere gilt: erst in der MCP-Server-Liste und im offiziellen Server-Verzeichnis nachsehen, ob es den passenden Server schon gibt — meist erspart das den Eigenbau. Und ehe du einen fremden Server registrierst, gilt dieselbe Vorsicht wie bei Skills: Quelle prüfen, denn ein Server läuft mit echten Rechten auf deinem Rechner.


FAQ

Häufige Fragen

Was ist der Unterschied zwischen einem lokalen und einem entfernten MCP-Server?
Ein lokaler Server läuft als Prozess auf deinem Rechner und spricht über stdio, die Standardein- und -ausgabe, mit Claude Code. Ein entfernter Server ist über das Netz per HTTP erreichbar. Lokale Server richtest du mit einem Startbefehl ein, entfernte mit einer URL — für die meisten Einsteiger-Fälle reicht der lokale Weg (Stand Juli 2026).
Muss ich einen MCP-Server programmieren, um ihn zu nutzen?
Nein. Für die meisten gängigen Dienste gibt es fertige Server, die du nur registrieren musst. Programmieren brauchst du erst, wenn du einen eigenen Server für ein internes System bauen willst — wie das geht, zeigt der Artikel zum Erstellen.
Warum taucht mein Server nach dem Hinzufügen nicht auf?
Meist einer von drei Gründen: Die Session lief schon vor dem Hinzufügen (Claude Code neu starten), der Startbefehl oder die URL ist falsch, oder der Server braucht Zugangsdaten, die noch fehlen. Mit dem Befehl zum Auflisten der Server siehst du den Status und ggf. Fehlermeldungen.
Kann ich einen Server nur für ein bestimmtes Projekt aktivieren?
Ja, genau dafür ist der Projekt-Geltungsbereich da. Der Server wird dann in einer Konfigurationsdatei im Projektordner hinterlegt und gilt nur dort — praktisch, um ein Team-Setup mit ins Git-Repository zu committen.
Sind fertige MCP-Server kostenlos?
Die Server selbst sind meist Open Source und kostenlos. Kosten können durch den angebundenen Dienst entstehen — etwa API-Gebühren oder Limits des Dienstes, mit dem der Server spricht. Der Server ist nur die Brücke.

Weiterlesen: Was ist ein MCP-Server? Einfach erklärt · MCP-Server-Liste: Die wichtigsten Server im Überblick · MCP-Server mit Python bauen: FastMCP Schritt für Schritt