Source: https://claudetutorial.com/guides/de-de/mcp-server-zu-claude-code-hinzufuegen-befehle-scopes-und-loesungen [Zurück zu Anleitungen](https://claudetutorial.com/guides/de-de) Builder # MCP-Server zu Claude Code hinzufügen: Befehle, Scopes und Lösungen 27. Oktober 2026 10 Min. Lesezeit --- Meist läuft es so: Du liest drei verschiedene Einrichtungsseiten, kopierst einen Befehl, der für dein System leicht danebenliegt, und wunderst dich, warum nichts erscheint. Der echte Ablauf besteht aus einem Befehl und einer Prüfung, sofern du weißt, welche Art von Server du hinzufügst. > Jeder MCP-Server, den du zu Claude Code hinzufügst, läuft auf einen Befehl hinaus: claude mcp add, gefolgt davon, wie er sich verbindet. Dieser Leitfaden gibt dir die Befehle für die drei Arten von Servern, erklärt die Scopes, die bestimmen, wer den Server bekommt, und behandelt Anmeldung, Sicherheit und die Lösungen für das, was schiefgeht. Ist MCP neu für dich, beginne mit [Was ist MCP?](https://claudetutorial.com/guides/de-de/was-ist-mcp-das-model-context-protocol-einfach-erklaert). ## Was du brauchst - Claude Code ist installiert und funktioniert. Falls nicht, siehe [Claude Code für Einsteiger](https://claudetutorial.com/guides/de-de/claude-code-fuer-einsteiger-installieren-anmelden-erste-aufgabe) - Die Adresse des Servers (bei einem Remote-Server) oder sein Startbefehl (bei einem lokalen), aus der Dokumentation des Dienstes - Ein Konto beim Dienst, den du verbindest Verbinde einen Server, wenn du merkst, dass du Daten aus einem anderen Tool in den Chat kopierst. Ist er verbunden, kann Claude in diesem System lesen und direkt darin handeln. ## Drei Arten von Servern Welchen Befehl du nutzt, hängt davon ab, wie sich der Server mit dir verbindet. | Art | Wie er sich verbindet | Wofür | | --- | --- | --- | | **Remote HTTP** | Eine Webadresse im Internet | Die meisten Cloud-Dienste. Die empfohlene Wahl | | **Remote SSE** | Eine Webadresse mit einem älteren Verfahren | Dienste, die nur das anbieten. Veraltet, bevorzuge also HTTP, wo es geht | | **Lokal stdio** | Ein Programm, das auf deinem Rechner läuft | Lokale Dateien, Datenbanken und Tools | ### Remote-HTTP-Server Die Grundform ist für jeden Dienst gleich: ``` claude mcp add --transport http ``` Ein echtes Beispiel verbindet Notion: ``` claude mcp add --transport http notion https://mcp.notion.com/mcp ``` Braucht der Server ein Token, übergib es als Header: ``` claude mcp add --transport http secure-api https://api.example.com/mcp \ --header "Authorization: Bearer your-token" ``` ### Remote-SSE-Server (veraltet) Das SSE-Verfahren ist veraltet, nutze also HTTP, wenn der Dienst es anbietet. Hat ein Dienst nur SSE, verwendet der Befehl einen anderen Transport: ``` claude mcp add --transport sse asana https://mcp.asana.com/sse ``` ### Lokaler stdio-Server Ein stdio-Server ist ein Programm, das auf deinem eigenen Rechner läuft und von Claude Code gestartet wird. Die Grundform hat einen doppelten Bindestrich, und alles danach ist der Befehl, der den Server startet: ``` claude mcp add [options] -- [args...] ``` Ein Beispiel, das einen Airtable-Server mit einem API-Schlüssel hinzufügt: ``` claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \ -- npx -y airtable-mcp-server ``` Den doppelten Bindestrich nicht vergessen Alles nach `--` wird unverändert an den Server weitergegeben. Ohne ihn versucht Claude Code, die eigenen Flags des Servers als seine Optionen zu lesen, und der Befehl scheitert auf verwirrende Weise. ## Prüfen, ob es geklappt hat Nachdem du einen Server hinzugefügt hast, prüfe ihn im Terminal oder in Claude Code selbst. Terminal ``` $ claude mcp list$ claude mcp get notion$ claude mcp remove notion ``` Alle konfigurierten Server auflisten, die Details eines Servers ansehen oder einen entfernen. In einer Sitzung zeigt dir `/mcp` den Status jedes Servers. Du siehst einen von drei Zuständen: verbunden, Authentifizierung nötig oder Verbindung fehlgeschlagen. | Status | Was er bedeutet | Was du tun sollst | | --- | --- | --- | | Connected | Der Server ist bereit | Bitte Claude, ihn zu nutzen | | Needs authentication | Du hast dich noch nicht angemeldet | Führe `/mcp` aus und folge der Anmeldung im Browser | | Failed to connect | Claude Code konnte ihn nicht erreichen oder starten | Siehe die Lösungen unten | ## Mit OAuth anmelden Viele Cloud-Server nutzen OAuth 2.0, den Ablauf "Mit deinem Konto anmelden". Der einfachste Weg hat zwei Schritte. 1. Den Server hinzufügen Zum Beispiel: `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` 2. Authentifizieren Führe in Claude Code `/mcp` aus und folge den Anmeldeschritten in deinem Browser. Aus der Shell kannst du außerdem `claude mcp login ` und `claude mcp logout ` ausführen. Tokens werden sicher gespeichert und automatisch erneuert. Um den Zugriff zu widerrufen, nutze **Clear authentication** (Authentifizierung löschen) im Menü von `/mcp`. ## Scopes: wer den Server bekommt Beim Hinzufügen eines Servers wählst du seinen Scope (Geltungsbereich). Der Scope bestimmt, welche Projekte ihn sehen und ob dein Team ihn teilt. | Scope | Verfügbar in | Mit dem Team geteilt | Gespeichert in | | --- | --- | --- | --- | | **Local** (der Standard) | Nur im aktuellen Projekt | Nein | `~/.claude.json` | | **Project** | Nur im aktuellen Projekt | Ja, über die Versionskontrolle | `.mcp.json` im Projektstamm | | **User** | In allen deinen Projekten | Nein | `~/.claude.json` | Wähle einen mit dem Flag `--scope`: ``` # Project scope: shared with your team claude mcp add --transport http shared-server --scope project https://example.com/mcp # User scope: available in all your projects claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic ``` Ein Server mit Project-Scope schreibt eine `.mcp.json`-Datei in den Stamm deines Projekts, die du committest, damit alle dieselbe Verbindung bekommen: ``` { "mcpServers": { "shared-server": { "type": "http", "url": "https://example.com/mcp" } } } ``` Taucht derselbe Servername in mehr als einem Scope auf, verbindet sich Claude Code einmal, mit der Definition aus der Quelle mit der höchsten Priorität: zuerst Local, dann Project, dann User. Gewinnt zuerst Gewinnt zuletzt 1. Local Nur dieses Projekt, nur du, gespeichert in ~/.claude.json 2. Project Mit deinem Team geteilt über .mcp.json 3. User Alle deine Projekte, nur du, gespeichert in ~/.claude.json Nutze Project für Tools, die das ganze Team braucht, User für deine persönlichen Tools und Local zum Ausprobieren. Öffnest du ein Projekt mit einer `.mcp.json` von jemand anderem, bittet Claude Code in einer interaktiven Sitzung um deine Zustimmung, bevor es dessen Server nutzt. Um diese Freigabeentscheidungen zurückzusetzen, führe `claude mcp reset-project-choices` aus. ## Beliebte Server, die du heute hinzufügen kannst Diese Beispiele stammen aus der offiziellen Dokumentation. Lies für die aktuelle Adresse immer die Seite des Dienstes selbst. | Dienst | Befehl | | --- | --- | | Sentry (Fehler) | `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` | | Stripe (Zahlungen) | `claude mcp add --transport http stripe https://mcp.stripe.com` | | GitHub (Code-Reviews) | `claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT"` | | Notion | `claude mcp add --transport http notion https://mcp.notion.com/mcp` | | PostgreSQL über DBHub | `claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"` | Achte bei der Datenbank auf den Benutzernamen: `readonly`. Gib Claude ein Datenbankkonto, das nur lesen kann. Diese eine Entscheidung beseitigt den teuersten Fehler, den du machen könntest. Du kannst außerdem geprüfte Connectors im Verzeichnis von Anthropic unter claude.ai/directory durchsuchen. Und hast du einen Connector in claude.ai hinzugefügt, steht er in Claude Code bereits zur Verfügung, wenn du dich mit deinem Claude-Konto anmeldest. ## Sicher bleiben Ein MCP-Server gibt Claude Zugriff auf ein System, und manche Server holen Inhalte von außen, etwa Webseiten oder Tickets, die Fremde geschrieben haben. Prüfe, ob du jedem Server vertraust Server, die externe Inhalte holen, können dich Prompt Injection aussetzen: Text, der eine KI zu etwas verleiten soll, das du nicht verlangt hast. Füge nur Server aus Quellen hinzu, denen du vertraust, und sieh nach, was Claude damit vorhat. - Der Server stammt aus der Dokumentation des Dienstes selbst, nicht aus einem beliebigen Beitrag - Datenbanken nutzen ein Konto nur mit Leserechten - Tokens stehen in Headern oder Umgebungsvariablen, nie in einer Datei, die du committest - Du arbeitest in einem Berechtigungsmodus, in dem du siehst, was Claude mit den Tools tut Der letzte Punkt hängt damit zusammen, wie viel Claude ohne Nachfrage tut. Wie du das festlegst, zeigt [Berechtigungsmodi und Plan-Modus in Claude Code erklärt](https://claudetutorial.com/guides/de-de/berechtigungsmodi-und-plan-modus-von-claude-code-erklaert). In Claude Tutorial Einem Tool zu vertrauen ist eine Entscheidung, keine Voreinstellung Zu beurteilen, welche Systeme Zugriff verdienen und für welche Aktionen, ist eine Fähigkeit, die weit über Code hinausgeht. Die App übt sie mit echten Szenarien. Bald verfügbar [ERHÄLTLICH BEI Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile) ## Grenzen und Feinabstimmung Zwei Grenzen helfen, Verhalten zu erklären, das sonst seltsam wirkt. - **Große Ergebnisse.** Claude Code zeigt eine Warnung, wenn die Ausgabe eines Tools 10.000 Tokens überschreitet, und begrenzt die Ausgabe standardmäßig auf 25.000 Tokens. Um die Grenze zu erhöhen, setze die Variable `MAX_MCP_OUTPUT_TOKENS`, zum Beispiel `MAX_MCP_OUTPUT_TOKENS=50000`. - **Langsame Server.** Um zu ändern, wie lange Claude Code auf den Start eines Servers wartet, setze `MCP_TIMEOUT`. Zum Beispiel erlaubt `MCP_TIMEOUT=10000 claude` zehn Sekunden. Die Tool-Suche ist standardmäßig an, damit sich dein Kontext nicht auf einmal mit jeder Tool-Beschreibung füllt. Führe `/context` aus, um zu sehen, was Platz belegt. ## Wenn es nicht funktioniert | Was du siehst | Wahrscheinliche Ursache | Lösung | | --- | --- | --- | | Der Server fehlt in `claude mcp list` | Er wurde in einem anderen Scope oder Projekt hinzugefügt | Führe `claude mcp list` im Projekt aus, in dem du ihn hinzugefügt hast, oder füge ihn mit `--scope user` hinzu | | `/mcp` zeigt Needs authentication | Du hast dich nicht angemeldet | Führe `/mcp` aus und folge den Schritten im Browser, oder `claude mcp login ` | | `/mcp` zeigt Failed to connect | Falsche Adresse, Server nicht erreichbar oder ein Startbefehl, der scheitert | Prüfe die URL in der Dokumentation des Dienstes. Führe bei einem lokalen Server seinen Befehl im Terminal aus, um den Fehler zu sehen | | Die eigenen Flags eines lokalen Servers werden abgelehnt | Der doppelte Bindestrich fehlt | Setze `--` vor den Serverbefehl | | In einem Projekt geht es, in einem anderen nicht | Der Local-Scope gilt für ein Projekt | Füge ihn mit `--scope user` erneut hinzu, oder mit Project-Scope für ein Team | | Claude ignoriert einen Projektserver | Die Zustimmung zur `.mcp.json` wurde abgelehnt | Führe `claude mcp reset-project-choices` aus und stimme erneut zu | | Die Ausgabe wird abgeschnitten | Der Standard von 25.000 Tokens | Erhöhe `MAX_MCP_OUTPUT_TOKENS` | Passt nichts davon, bitte Claude Code um Hilfe: Füge den Fehler ein und frage, was er bedeutet. Auch `/doctor` prüft deine Einrichtung. ## Häufig gestellte Fragen ### Wie füge ich einen MCP-Server zu Claude Code hinzu? Führe `claude mcp add --transport http ` für einen Remote-Server aus, oder `claude mcp add -- ` für einen lokalen. Führe danach in Claude Code `/mcp` aus, um den Status zu prüfen und dich anzumelden. ### Wo speichert Claude Code MCP-Server? Server mit Local- und User-Scope stehen in `~/.claude.json`. Server mit Project-Scope stehen in einer `.mcp.json`-Datei im Stamm deines Projekts, die du committen kannst. ### Was ist der Unterschied zwischen Local-, Project- und User-Scope? Local gilt für das aktuelle Projekt und nur für dich. Project gilt für das aktuelle Projekt und wird mit deinem Team geteilt. User gilt für alle deine Projekte und nur für dich. ### Wie entferne ich einen MCP-Server? Führe `claude mcp remove ` aus. Um dich von einem Server abzumelden, ohne ihn zu entfernen, nutze `claude mcp logout `. ### Was bedeutet der doppelte Bindestrich in claude mcp add? Er trennt die eigenen Optionen von Claude Code vom Befehl, der den Server startet. Alles danach wird unverändert an den Server weitergegeben. ### Sind MCP-Server sicher? Nur so sicher wie die Server, die du wählst, und der Zugriff, den du gibst. Nutze vertrauenswürdige Server, Datenbankkonten nur mit Leserechten und einen Berechtigungsmodus, in dem du siehst, was Claude tut. ### Kann ich meine Connectors aus claude.ai in Claude Code nutzen? Ja. Connectors, die du in claude.ai hinzufügst, stehen in Claude Code zur Verfügung, im Terminal und in Cloud-Sitzungen, wenn du dich mit deinem Claude-Konto anmeldest. ## Deine MCP-Checkliste für Claude Code - `claude mcp list` zeigt den Server, und `/mcp` zeigt ihn als verbunden - Du hast den Scope mit Absicht gewählt: Local zum Testen, Project fürs Team, User für dich selbst - Zugangsdaten stehen in Headern oder Umgebungsvariablen, nicht in committeten Dateien - Alles, was Daten berührt, die du nicht wiederherstellen kannst, nutzt nur lesenden Zugriff ## Weiterlesen - [Was ist MCP? Das Model Context Protocol einfach erklärt](https://claudetutorial.com/guides/de-de/was-ist-mcp-das-model-context-protocol-einfach-erklaert) für die Idee dahinter. - [So fügst du Connectors in Claude hinzu: Verzeichnis, eigene URL und Sicherheit](https://claudetutorial.com/guides/de-de/connectors-in-claude-hinzufuegen-verzeichnis-eigene-url-und-sicherheit) für dasselbe in den Claude-Apps. - [Claude Code Best Practices: Gewohnheiten für bessere Ergebnisse](https://claudetutorial.com/guides/de-de/best-practices-fuer-claude-code-gewohnheiten-fuer-bessere-ergebnisse), um gut zu arbeiten, sobald die Tools verbunden sind. - [CLAUDE.md erklärt: Claude Code dein Projekt einmal beibringen](https://claudetutorial.com/guides/de-de/claude-md-erklaert-claude-code-dein-projekt-einmal-beibringen), um Claude zu sagen, wie es die verbundenen Tools in deinem Projekt nutzen soll.