MCP-Server zu Claude Code hinzufügen: Befehle, Scopes und Lösungen

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.

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?.

Was du brauchst

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.

Remote-HTTP-Server

Die Grundform ist für jeden Dienst gleich:

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

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] <name> -- <command> [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

Prüfen, ob es geklappt hat

Nachdem du einen Server hinzugefügt hast, prüfe ihn im Terminal oder in Claude Code selbst.

$ claude mcp list$ claude mcp get notion$ claude mcp remove notion

In einer Sitzung zeigt dir /mcp den Status jedes Servers. Du siehst einen von drei Zuständen: verbunden, Authentifizierung nötig oder Verbindung fehlgeschlagen.

Mit OAuth anmelden

Viele Cloud-Server nutzen OAuth 2.0, den Ablauf "Mit deinem Konto anmelden". Der einfachste Weg hat zwei Schritte.

Aus der Shell kannst du außerdem claude mcp login <name> und claude mcp logout <name> 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.

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.

Ö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.

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.

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.

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

Laden imApp Store

ERHÄLTLICH BEIGoogle Play

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

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 <name> <url> für einen Remote-Server aus, oder claude mcp add <name> -- <command> 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 <name> aus. Um dich von einem Server abzumelden, ohne ihn zu entfernen, nutze claude mcp logout <name>.

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

Weiterlesen

• Was ist MCP? Das Model Context Protocol einfach erklärt für die Idee dahinter.
• So fügst du Connectors in Claude hinzu: Verzeichnis, eigene URL und Sicherheit für dasselbe in den Claude-Apps.
• Claude Code Best Practices: Gewohnheiten für bessere Ergebnisse, um gut zu arbeiten, sobald die Tools verbunden sind.
• CLAUDE.md erklärt: Claude Code dein Projekt einmal beibringen, um Claude zu sagen, wie es die verbundenen Tools in deinem Projekt nutzen soll.