So fügen Sie Claude Code einen MCP-Server hinzu (schrittweise Anleitung)

Einführung

Claude Code wurde entwickelt, um mehr als nur beim Programmieren zu helfen. Es kann ganze Codebasen analysieren, mehrstufige Änderungen planen und Aufgaben dateiübergreifend ausführen. Für sich genommen ist Claude Code jedoch immer noch auf Ihre lokale Umgebung beschränkt. Moderne Entwicklungsworkflows beinhalten die Interaktion mit:

• Repositorien
• Datenbanken
• APIs
• Interne Tools

Hier kommen MCP-Server (Model Context Protocol) ins Spiel. MCP ermöglicht es Claude Code, eine Verbindung zu externen Systemen herzustellen und Aktionen zu ergreifen, die über die Codebearbeitung hinausgehen. So werden Workflows wie die folgenden ermöglicht:

• Codeänderungen weiterleiten
• Datenbanken abfragen
• Befehle ausführen
• Dienste auslösen

Mit anderen Worten, MCP verwandelt Claude Code von einem Codierungstool in ein Vollstreckungsagent. Das Einrichten von MCP-Servern in Claude Code kann jedoch verwirrend sein, insbesondere wenn Sie dies zum ersten Mal tun. Dieser Leitfaden führt Sie durch genau wie man einen MCP-Server zu Claude Code hinzufügt, Schritt für Schritt.

Was Sie benötigen, bevor Sie loslegen

Bevor Sie Claude Code einen MCP-Server hinzufügen, stellen Sie sicher, dass Sie über Folgendes verfügen.

Wenn Sie diese im Voraus einrichten, sparen Sie Zeit und vermeiden häufig auftretende Konfigurationsprobleme.

1. Claude Code ist installiert und funktioniert

Stellen Sie sicher, dass Claude Code in Ihrer Umgebung installiert ist und ordnungsgemäß ausgeführt wird.

Du solltest in der Lage sein:

• Eine Codebasis öffnen und darin navigieren
• Befehle oder Eingabeaufforderungen ausführen
• Greifen Sie auf Konfigurationseinstellungen zu

Wenn Claude Code nicht vollständig eingerichtet ist, schließen Sie das zuerst ab.

2. Ein MCP-Server (lokal oder gehostet)

Claude Code beinhaltet standardmäßig keine MCP-Server, Sie müssen einen verbinden. Das kann sein:

• EIN lokaler MCP-Server läuft auf deinem Computer
• EIN gehosteter MCP-Server (intern oder von Drittanbietern)

Zu den gängigen MCP-Servern gehören:

• GitHub (für Repositorys)
• Dateisystem (für Dateioperationen)
• PostgreSQL (für Datenbanken)
• REST-APIs (für Dienste)

Beginnen Sie mit einem Server, der Ihrem Anwendungsfall entspricht.

3. Zugangsdaten und Zugang

Die meisten MCP-Server benötigen eine Authentifizierung. Möglicherweise benötigen Sie:

• API-Schlüssel
• Zugriffstoken
• Datenbank-Anmeldeinformationen

Vergewissern Sie sich:

• Die Anmeldeinformationen sind gültig
• Der Gültigkeitsbereich der Berechtigungen ist korrekt
• Sensible Daten werden sicher gespeichert

4. Ein klarer Anwendungsfall

Bevor Sie einen MCP-Server hinzufügen, entscheiden Sie, was Claude Code tun soll.

Zum Beispiel:

• Code verwalten → GitHub MCP
• Daten abfragen → Datenbank MCP
• Dienste aufrufen → API MCP

Dies hilft Ihnen, unnötige Komplexität zu vermeiden.

5. Eine sichere Umgebung zum Testen

Am besten konfigurieren Sie MCP-Server in einem Entwicklungs- oder Inszenierungsumgebung zuerst.

Auf diese Weise können Sie:

• Integrationen sicher testen
• Probleme ohne Risiko debuggen
• Bestätigen Sie Berechtigungen und Workflows

Sobald alles funktioniert, können Sie das Setup auf die Produktion ausdehnen.

So funktioniert MCP in Claude Code

Bevor Sie etwas konfigurieren, ist es hilfreich zu verstehen, wie MCP in Claude Code integriert ist. Claude Code ist verantwortlich für:

• Deine Codebasis verstehen
• Aufgaben planen
• Entscheiden, welche Maßnahmen zu ergreifen sind

MCP-Server sind verantwortlich für:

• Ausführung dieser Aktionen
• Interaktion mit externen Systemen
• Rückgabe der Ergebnisse an Claude Code

So funktioniert der Flow

1. Sie definieren eine Aufgabe in Claude Code
2. Claude Code bestimmt, welches Tool (MCP-Server) benötigt wird
3. Der MCP-Server führt die Anfrage aus
4. Die Ergebnisse werden zurückgegeben und für den nächsten Schritt verwendet

Zum Beispiel:

• „Fehlgeschlagene API reparieren und bereitstellen“
  • Claude analysiert Code
  • Verwendet MCP zum Ausführen von Tests
  • Verwendet MCP, um Änderungen voranzutreiben
  • Verwendet MCP, um die Bereitstellung auszulösen

Schritt für Schritt: Einen MCP-Server zu Claude Code hinzufügen

Lassen Sie uns erklären, wie Sie einen MCP-Server tatsächlich hinzufügen und konfigurieren.

Schritt 1: Richten Sie Ihren MCP-Server ein

Bevor Sie ihn zu Claude Code hinzufügen, muss Ihr MCP-Server laufen.

Je nach Server kann das Setup Folgendes beinhalten:

• Abhängigkeiten installieren
• Lokales Ausführen eines Dienstes
• Umgebungsvariablen setzen

Beispiel (knotenbasierter MCP-Server):

npm installnpm start

Oder mit Docker:

docker run <mcp-server-image>

Vergewissern Sie sich:

• Der Server läuft
• Sie kennen den Endpunkt (URL/Port)
• Erforderliche Anmeldeinformationen sind konfiguriert

Schritt 2: Öffnen Sie die Claude Code-Konfiguration

In Claude Code:

• Navigiere zu deinem Konfigurationsdatei oder Einstellungsfeld
• Suchen Sie den Abschnitt für Werkzeugbau/MCP/Integrationen

(Der genaue Standort kann je nach Einrichtung variieren)

Schritt 3: MCP-Servereintrag hinzufügen

Sie fügen nun einen Konfigurationseintrag hinzu, der Claude Code mitteilt, wie eine Verbindung zum MCP-Server hergestellt wird.

Beispiel für eine Konfiguration

{
  "mcpServers": [
    {
      "name": "github",
      "type": "http",
      "url": "http://localhost:3000",
      "auth": {
        "type": "bearer",
        "token": "YOUR_API_TOKEN"
      }
    }
  ]
}

Was jedes Feld bedeutet

• Name → Von Claude Code verwendeter Identifier
• Art → Verbindungstyp (HTTP/Local)
• url → MCP-Serverendpunkt
• Auth → Angaben zur Authentifizierung

Schritt 4: Authentifizierung konfigurieren

Wenn Ihr MCP-Server eine Authentifizierung erfordert:

• API-Schlüssel oder Token hinzufügen
• Stellen Sie sicher, dass die Berechtigungen korrekt sind
• Vermeiden Sie es, Geheimnisse im Klartext preiszugeben

Je nach Server kann dies Folgendes beinhalten:

• Inhabermarken
• API-Schlüssel
• OAuth-Anmeldeinformationen

Schritt 5: Testen Sie den MCP-Server

Testen Sie die Integration nach der Konfiguration.

Probiere Eingabeaufforderungen wie:

• „Repositorys von GitHub auflisten“
• „Führen Sie Tests in diesem Projekt durch“
• „Daten aus der Datenbank abrufen“

Wenn alles funktioniert:

• Claude Code wird den MCP-Server anrufen
• Sie erhalten eine gültige Antwort

Falls nicht:

• Protokolle überprüfen
• Anmeldeinformationen überprüfen
• Bestätigen Sie, dass Endpunkt erreichbar ist

Häufige Probleme und Problembehebungen

1. MCP-Server nicht erreichbar

Problem: Claude Code kann keine Verbindung herstellen

Korrigieren:

• Stellen Sie sicher, dass der Server läuft
• URL/Port überprüfen
• Überprüfen Sie den Netzwerkzugriff

2. Fehler bei der Authentifizierung

Problem: Zugriff verweigert oder ungültiges Token

Korrigieren:

• Anmeldeinformationen neu generieren
• Prüfe den Umfang der Erlaubnis
• Stellen Sie sicher, dass das Authentifizierungsformat korrekt ist

3. Fehler bei der Genehmigung

Problem: Server reagiert, aber Aktionen schlagen fehl

Korrigieren:

• Überprüfen Sie die Zugriffsebenen
• Überprüfen Sie die Serviceberechtigungen
• Passen Sie die Rollen nach Bedarf an

4. Fehler bei der Konfiguration

Problem: MCP-Server nicht erkannt

Korrigieren:

• Überprüfen Sie die JSON-Syntax
• Stellen Sie sicher, dass Pflichtfelder vorhanden sind
• Starten Sie Claude Code bei Bedarf neu

Bewährte Methoden für das Hinzufügen von MCP-Servern zu Claude Code

Sobald Sie die MCP-Server mit Claude Code verbunden haben, sollte sich der Schwerpunkt auf Ihre Einrichtung verlagern. sicher, zuverlässig und wartbar.

1. Beginnen Sie mit minimalen Berechtigungen

Vermeiden Sie es, MCP-Servern uneingeschränkten Zugriff zu gewähren.

Stattdessen:

• Verwenden Sie bereichsbezogene Token
• Erteilen Sie nur die erforderlichen Berechtigungen
• Erweitern Sie den Zugriff schrittweise

Dies ist besonders wichtig für:

• Produktionsdatenbanken
• Einsatzsysteme
• Interne APIs

2. Verwenden Sie separate Umgebungen

Testen Sie MCP-Integrationen immer in Entwicklungs- oder Staging-Umgebungen vor der Produktion.

Auf diese Weise können Sie:

• Konfigurationen sicher validieren
• Debuggen, ohne Live-Systeme zu beeinträchtigen
• Workflows verfeinern

Sobald es stabil ist, replizieren Sie das Setup in der Produktion mit strengeren Kontrollen.

3. Vor der Ausführung kritischer Aktionen validieren

Claude Code kann Workflows mit mehreren Schritten ausführen, aber nicht alle Aktionen sollten ungeprüft ausgeführt werden.

Bewährte Verfahren:

• Geplante Änderungen überprüfen
• Validierungsschritte für vertrauliche Workflows hinzufügen
• Vermeiden Sie vollständige Autonomie in Umgebungen mit hohem Risiko

4. Überwachen Sie die MCP-Nutzung

Sichtbarkeit ist entscheidend, wenn Claude Code mit mehreren Systemen interagiert.

Titel:

• Welche MCP-Server werden verwendet
• Welche Aktionen werden ausgeführt
• Wie sich Workflows im Laufe der Zeit verhalten

Das hilft bei:

• Debuggen
• Wirtschaftsprüfung
• Verbesserung der Zuverlässigkeit

5. Sorgen Sie für saubere und skalierbare Konfigurationen

Wenn Sie mehr MCP-Server hinzufügen, nimmt die Komplexität zu.

Um das zu verwalten:

• Verwenden Sie konsistente Namenskonventionen
• Organisieren Sie Konfigurationen übersichtlich
• Dokumentintegrationen

Dadurch wird sichergestellt, dass Ihr Setup auch bei der Weiterentwicklung Ihres Systems wartbar bleibt.

Überlegungen zur Produktion: Skalierung von MCP-Workflows

Die Einrichtung eines MCP-Servers ist einfach. Das Ausführen mehrerer MCP-gestützter Workflows in der Produktion ist nicht möglich.

1. Verwaltung mehrerer Integrationen

Wenn die Nutzung zunimmt, integrieren Teams mehrere MCP-Server:

• GitHub
• Datenbanken
• APIs
• Interne Tools

Ohne Struktur führt dies zu:

• Fragmentierte Konfigurationen
• Inkonsistente Zugriffskontrollen
• Schwer zu verwaltende Workflows

2. Durchsetzung von Leitplanken

Claude Code kann leistungsstarke Aktionen systemübergreifend ausführen.

Ohne angemessene Kontrollen birgt dies Risiken:

• Unbeabsichtigte Änderungen
• Unbefugter Zugriff
• Instabilität des Systems

Teams benötigen:

• Rollenbasierte Zugriffskontrolle
• Einschränkungen auf Aktionsebene
• Klare Ausführungsgrenzen

3. Beobachtbarkeit und Debugging

Das Debuggen von MCP-Workflows kann ohne Sichtbarkeit schwierig sein.

Du musst verstehen:

• Was Claude Code versucht hat
• Welcher MCP-Server hat die Anfrage bearbeitet
• Wo Fehler aufgetreten sind

Ohne Beobachtbarkeit wird die Fehlerbehebung langsam und unzuverlässig.

4. Verwaltung von Modellen, Kosten und Leistung

MCP-Workflows basieren auf zugrunde liegenden Modellen.

Im großen Maßstab müssen Teams Folgendes bewältigen:

• Modellauswahl (Latenz versus Qualität)
• Kosten bei wiederholten Ausführungen
• Leistungsengpässe

Dies erfordert eine zentrale Steuerung.

Ausführen von MCP-Workflows in der Produktion mit TrueFoundry

Es ist relativ einfach, einen MCP-Server lokal mit Claude Code zum Laufen zu bringen. Die eigentliche Herausforderung beginnt, wenn Sie versuchen, dieselben Workflows in Teams, Umgebungen und Produktionssystemen auszuführen.

Zu diesem Zeitpunkt stoßen Teams in der Regel auf einige Probleme:

• Anmeldeinformationen sind über Konfigurationen und Umgebungen verteilt
• Es gibt keine klare Kontrolle darüber, welche Maßnahmen ein Agent ergreifen kann
• Das Debuggen von Fehlern bei MCP-Aufrufen wird schwierig
• Modellnutzung und Kosten sind schwer nachzuverfolgen oder zu optimieren

Hier wird eine Plattform wie TrueFoundry nützlich — nicht als Add-On, sondern als Steuerungsebene für KI-gesteuerte Workflows.

Zentralisierung des MCP-Zugriffs und der Anmeldeinformationen

In den meisten Setups benötigen MCP-Server API-Schlüssel, Token oder Datenbankanmeldeinformationen. Diese enden oft wie folgt:

• In Konfigurationen fest codiert
• In Umgebungsvariablen gespeichert
• Inkonsistent in allen Umgebungen verwaltet

Mit TrueFoundry können Sie zentralisieren, wie diese Anmeldeinformationen verwaltet und abgerufen werden, also:

• Geheimnisse werden in lokalen Konfigurationen nicht offengelegt
• Der Zugriff ist für Entwicklung, Staging und Produktion konsistent
• Rotationen und Aktualisierungen sind einfacher zu handhaben

Definieren, was Agenten tun dürfen

Claude Code kann echte Aktionen ausführen — Code übertragen, Daten abfragen, Befehle ausführen.

In der Produktion möchten Sie nicht, dass jeder Agent uneingeschränkten Zugriff hat.

Mit TrueFoundry können Sie Folgendes definieren:

• Welche MCP-Server kann ein Agent verwenden
• Welche Aktionen sind erlaubt (Lesen oder Schreiben, begrenzte Bereiche usw.)
• Wo Genehmigungen oder Validierungen erforderlich sind

Dies hilft, Situationen zu vermeiden, in denen ein Agent:

• Modifiziert empfindliche Systeme
• Führt unbeabsichtigte Workflows aus
• Verursacht schwer rückgängig zu werdende Änderungen

Beobachtbarkeit bei MCP-Aufrufen

Wenn in einem MCP-Workflow etwas kaputt geht, ist es am schwierigsten, das herauszufinden wo es gescheitert ist.

War es:

• Die Argumentation des Modells?
• Der MCP-Serveraufruf?
• Das Downstream-System?

TrueFoundry bietet Einblick in:

• Schritte zur Agentenausführung
• MCP-Serverinteraktionen
• Eingaben, Ausgaben und Fehler

Das macht es viel einfacher:

• Probleme debuggen
• Verhalten bei Audits
• Verbessern Sie Arbeitsabläufe im Laufe der Zeit

Skalierbares Management von Modellen und Kosten

Claude Code stützt sich auf zugrunde liegende Modelle, und MCP-Workflows beinhalten oft wiederholte Aufrufe.

Da die Nutzung zunimmt, müssen Teams:

• Anfragen modellübergreifend weiterleiten
• Kosten gegen Leistung abwägen
• Überwachen Sie die Nutzung teamübergreifend

TrueFoundry bietet Ihnen eine zentrale Möglichkeit für:

• Kontrollieren Sie, welche Modelle verwendet werden
• Optimieren Sie Routing-Strategien
• Kosten verfolgen und verwalten

Von der lokalen Einrichtung bis hin zu teamweiten Workflows

Was beginnt mit einer einfachen Einrichtung:

„MCP-Server hinzufügen → Aufgabe ausführen“

Schnell wird:

„Mehrere Agenten → mehrere MCP-Server → mehrere Umgebungen“

TrueFoundry hilft dabei, dies zu standardisieren, indem es eine konsistente Methode bietet, um:

• Integrationen konfigurieren
• Richtlinien durchsetzen
• Skalieren Sie Workflows teamübergreifend

MCP ermöglicht Claude Code die Interaktion mit Systemen.
TrueFoundry stellt sicher, dass diese Interaktionen kontrolliert, beobachtbar und produktionsbereit.

Fazit

Das Hinzufügen eines MCP-Servers zu Claude Code ermöglicht es, von einem leistungsstarken Codierungstool zu etwas viel Nützlicherem zu werden — einem Agenten, der tatsächlich mit Ihren Systemen interagieren und echte Workflows ausführen kann.

Mit dem richtigen Setup kann Claude Code über die Bearbeitung von Code hinausgehen und:

• Änderungen an Repositorys übertragen
• Datenbanken abfragen
• APIs aufrufen
• Befehle ausführen und Ergebnisse überprüfen

Sobald Sie jedoch beginnen, sich auf diese Workflows zu verlassen, die über lokale Experimente hinausgehen, ändert sich die Herausforderung. Es geht nicht mehr nur darum, einen MCP-Server zum Laufen zu bringen, es geht um Verwaltung der Art und Weise, wie diese Interaktionen zwischen Umgebungen, Systemen und Teams ablaufen.

Hier werden Plattformen wie TrueFoundry wichtig. Sie bieten eine Möglichkeit, MCP-basierte Workflows zu strukturieren und sorgen für Zugriffskontrolle, Sichtbarkeit und Skalierung, sodass Teams Tools wie Claude Code zuverlässig in der Produktion einsetzen können. Letztlich ist es MCP, das Funktionen freisetzt, aber der wahre Wert hängt davon ab, wie gut Sie können Betrieb und Skalierung dieser Funktionen in realen Systemen.