Claude Code MCP: Server verbinden, Geltungsbereiche, Remote-MCP und Praxisbeispiele

Einen Server hinzufügen

# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright

Stdio-Server sind Programme, die Claude Code für Sie startet — die meisten Community-Server sind npm- oder Python-Pakete, die so ausgeführt werden. Remote-Server sind URLs; sie authentifizieren sich über OAuth (führen Sie /mcp in einer Sitzung aus und folgen Sie dem Ablauf im Browser) oder über einen Header, den Sie beim Hinzufügen übergeben, wie im PostHog-Beispiel. Prüfen Sie die Dokumentation des jeweiligen Anbieters auf die aktuelle URL — Remote-Endpunkte ändern sich.

Geltungsbereiche und .mcp.json

• local (Standard) — in Ihren Benutzereinstellungen gespeichert, nur für dieses Projekt. Persönliche, private Server.
• project (--scope project) — wird geschrieben in .mcp.json im Stammverzeichnis des Repositorys und mit allen geteilt, die es klonen. Claude Code fragt beim ersten Mal nach, bevor es den Servern eines Projekts vertraut.
• user (--scope user) — in jedem Projekt auf Ihrem Rechner verfügbar.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}

.mcp.json unterstützt die Expansion von Umgebungsvariablen, sodass das Repository die Serverdefinition enthalten kann, während jeder Entwickler seine eigenen Zugangsdaten bereitstellt.

Einen Server in einer Sitzung verwenden

Sobald die Verbindung steht, sind die Tools des Servers einfach verfügbar — fragen Sie nach „den Fehlern der letzten 24 Stunden aus PostHog“, und Claude Code ruft das Tool auf. Ressourcen, die der Server bereitstellt, lassen sich über @-Erwähnungen referenzieren (@github:issue://123), wodurch sie bei Bedarf in den Kontext geladen werden. Prompts, die ein Server definiert, erscheinen als Slash-Befehle unter /mcp__<server>__<prompt>. /mcp zeigt den Verbindungsstatus an, ermöglicht die erneute Verbindung oder Authentifizierung und listet jedes Tool mit seiner Beschreibung auf.

Beispiele zum Übernehmen

• PostHog MCP — Produktanalysen direkt im Agenten: „Hinter welchem Feature-Flag steckt dieser Code, und wie sieht dessen Rollout aus?“ PostHog stellt einen Remote-MCP-Server bereit; fügen Sie ihn hinzu mit --transport http und Ihrem persönlichen API-Schlüssel als Bearer-Header.
• GitHub — Issues und Pull Requests als Kontext; kombinieren Sie dies mit der Action aus dem GitHub-Leitfaden für den Review-Zyklus.
• Playwright — ein echter Browser für End-to-End-Tests und zum Prüfen der gerade geänderten Benutzeroberfläche; siehe den Leitfaden zur QA-Automatisierung.
• Postgres / SQLite — schemaorientierte Abfragen und Migrationen; verwenden Sie einen Benutzer mit reinem Lesezugriff, sofern Sie nicht bewusst Schreibzugriff benötigen.
• Dateisystem außerhalb des Repositorys — --add-dir ist für zusätzliche Verzeichnisse einfacher; MCP ist für Dinge gedacht, die keine Dateien sind.

Kosten und Kontext

Jedes Tool-Ergebnis, das ein MCP-Server zurückgibt, landet im Gespräch und wird danach bei jedem weiteren Austausch erneut gesendet. Ein Server, der 5,000 Zeilen zurückgibt, sprengt den Kontext. Bevorzugen Sie Tools mit Begrenzungen, bitten Sie um Zusammenfassungen und /compact nach einer umfangreichen Abfrage. Server laufen lokal oder beim Anbieter; sie werden nicht über den Modell-Endpunkt geleitet, daher bleibt ANTHROPIC_BASE_URL=https://aiprimetech.io unverändert — abgerechnet werden nur die Tokens, die die Ergebnisse verbrauchen.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.