Claude MCP erklärt: So binden Sie einen Server an
MCP verbindet Claude über das Model Context Protocol von Anthropic mit externen Systemen. Ein MCP-Server stellt Werkzeuge und Daten bereit, auf die Claude lesend und handelnd zugreifen kann. Auch in Claude Code lässt sich ein Server mit wenigen Schritten hinzufügen.
Veröffentlicht am 11. Oktober, ursprünglich erschienen auf nulltensor.com
Claude MCP ist Claude, das über das Model Context Protocol, Anthropics offener Standard für die Ausstattung von KI-Assistenten mit Werkzeugen und Daten, mit anderen Systemen verbunden ist. Man fügt einen MCP-Server hinzu, der Server legt offen, was ein System kann, und Claude kann dann daraus lesen und darin handeln. In Claude Code genügt ein einziger Befehl claude mcp add, um einen Server hinzuzufügen.
Das ist die Kurzfassung. Der Rest dieses Beitrags behandelt, was ein MCP-Server Claude tatsächlich bietet, wie man in jeder Claude-Anwendung einen hinzufügt, wo die Konfiguration liegt und welche wenigen Sicherheitsgewohnheiten sich vom ersten Tag an lohnen.
Ein MCP-Server ist ein kleines Programm, das das Protokoll spricht und drei Arten von Dingen anbietet:
Server laufen auf eine von zwei Arten. Ein lokaler Server ist ein Prozess auf dem eigenen Rechner, den Claude startet und über Standard-Ein- und Ausgabe (stdio) anspricht. Ein entfernter Server läuft an einem anderen Ort, und Claude erreicht ihn über HTTP. Lokal ist einfacher für die eigenen Dateien und Werkzeuge; entfernt eignet sich für Dienste, bei denen man sich anmeldet, und es funktioniert über claude.ai im Browser, wo auf dem eigenen Rechner nichts laufen kann.
Anthropic hat MCP im November 2024 als offenen Standard veröffentlicht, sodass derselbe Server mit Claude Code, Claude Desktop, claude.ai und anderen MCP-Clients funktioniert. Ob ein System einen eigenen MCP-Server benötigt oder ob die bereits vorhandene API ausreicht, ist eine separate Entscheidung; ich habe sie in MCP vs API durchgearbeitet.
Der Befehl lautet claude mcp add. Bei einem lokalen Server ist alles nach den zwei Strichen der Befehl, den Claude Code zum Starten ausführt:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects Passwörter und Schlüssel übergibt man als Umgebungsvariablen und nicht als Argumente, und zwar mit --env:
claude mcp add --env AIRTABLE_API_KEY = your-key airtable -- npx -y airtable-mcp-server Bei einem entfernten Server gibt man den Transport und die URL an:
claude mcp add --transport http notion https://mcp.notion.com/mcp Entfernte Server melden einen in der Regel per OAuth an. Man öffnet eine Claude-Code-Sitzung, tippt /mcp, wählt den Server aus und schließt die Anmeldung im Browser ab. Ein Server, der stattdessen ein festes Token entgegennimmt, akzeptiert einen Header: --header "Authorization: Bearer your-token". Der ältere SSE-Transport funktioniert zwar noch, gilt aber als veraltet; verwendet HTTP, wo ein Server es anbietet.
Jeder Server wird auf einem von drei Scopes hinzugefügt, festgelegt mit --scope:
Den Projekt-Scope verwendet man für Server, die das ganze Team braucht, etwa den Issue-Tracker für dieses Repository, und committet die Datei. Den User-Scope nutzt man für persönliche Werkzeuge, die man überall verfügbar haben will. Einmalige Experimente lässt man auf dem Standardwert.
Projektbezogene Server liegen in der Datei.mcp.json, und man kann sie von Hand schreiben:
{ "mcpServers": { "issues": { "type": "http", "url": "https://example.com/mcp" }, "database": { "type": "stdio", "command": "/path/to/db-server", "args": [ "--read-only" ], "env": { "DB_URL": "${DB_URL}" } } } } ${VAR} wird aus der eigenen Umgebung expandiert, sodass die committete Datei keine Geheimnisse enthält; ${VAR:-default} liefert einen Fallback. Um einen Server aus einem JSON-Schnipsel hinzuzufügen, ohne Dateien zu bearbeiten, verwendet man claude mcp add-json <name> '<json>'. Wer Server bereits in Claude Desktop eingerichtet hat, importiert sie mit claude mcp add-from-claude-desktop unter macOS und WSL.
claude mcp list # alle konfigurierten Server claude mcp get issues # Details zu einem einzigen claude mcp remove issues # ihn löschen (mit --scope project für.mcp.json) Innerhalb einer Sitzung zeigt /mcp, welche Server verbunden sind und welche fehlgeschlagen sind, und erlaubt es, einen auszuschalten, ohne ihn zu löschen. Das ist die schnellste Lösung, wenn ein Server Fehlverhalten zeigt und man ihn für einen Nachmittag aus dem Weg haben will.
Claude Desktop liest lokale Server aus der Datei claude_desktop_config.json. Man öffnet sie über das Claude-Menü: Einstellungen, dann Entwickler, dann Konfiguration bearbeiten. Sie liegt unter macOS unter ~/Library/Application Support/Claude/claude_desktop_config.json und unter Windows unter %APPDATA%\Claude\claude_desktop_config.json und verwendet dieselbe mcpServers-Struktur wie.mcp.json. Nach dem Bearbeiten beendet man die App und öffnet sie erneut; Desktop liest die Datei nur beim Start.
claude.ai im Browser kann keine lokalen Prozesse starten und verwendet daher nur entfernte Server, die es Konnektoren nennt. Man öffnet die Einstellungen, wählt Connectors, klickt auf Hinzufügen und dann auf „Benutzerdefinierten Connector hinzufügen“, fügt die Server-URL ein und meldet sich an. In den Einstellungen des Konnektors lassen sich einzelne Werkzeuge ein- oder ausschalten, was sich für alles lohnt, das schreiben kann.
Ein MCP-Server läuft mit echten Zugangsdaten und bei lokalen Servern mit den Berechtigungen des eigenen Benutzerkontos. Drei Gewohnheiten decken das meiste Risiko ab:
Die gestalterische Seite davon, also zu entscheiden, welche Aktionen ein Server überhaupt anbieten soll, macht den Großteil von MCP vs API aus.
MCP gibt Claude Zugriff auf ein System; ein Skill vermittelt ihm eine Vorgehensweise. Die beiden passen zusammen: Der Server holt die Daten, der Skill sagt, was damit geschehen soll. Den vollständigen Vergleich, einschließlich der Frage, wann man was verwendet, findet man unter Claude Skills vs MCP servers.
Was ist Claude MCP? Claude MCP ist Claude unter Verwendung des Model Context Protocol, Anthropics offenem Standard zur Verbindung von KI-Assistenten mit anderen Systemen. Claude verbindet sich mit MCP-Servern, und jeder Server legt Werkzeuge, Ressourcen oder Prompts aus einem System offen, etwa GitHub oder einer Datenbank, sodass Claude aktuelle Daten lesen und dort Aktionen ausführen kann.
Wie füge ich Claude Code einen MCP-Server hinzu? Man führt claude mcp add aus. Bei einem lokalen Server setzt man den Startbefehl hinter zwei Striche: claude mcp add my-server -- npx -y some-mcp-server. Bei einem entfernten Server übergibt man Transport und URL: claude mcp add --transport http my-server https://example.com/mcp. Anschließend führt man /mcp innerhalb von Claude Code aus, um zu prüfen, ob die Verbindung steht.
Wo liegt die Claude-MCP-Konfigurationsdatei? Das hängt von der Anwendung ab. Claude Code speichert lokale und Benutzer-Server in ~/.claude.json und geteilte Projekt-Server in.mcp.json im Projektstammverzeichnis. Claude Desktop verwendet claude_desktop_config.json, unter macOS unter ~/Library/Application Support/Claude und unter Windows unter %APPDATA%\Claude. claude.ai speichert Konnektoren in den Kontoeinstellungen.
Wie entferne ich einen MCP-Server aus Claude? In Claude Code führt man claude mcp remove gefolgt vom Servernamen aus, mit --scope project, wenn er in.mcp.json liegt. Um einen Server anzuhalten, ohne ihn zu löschen, öffnet man /mcp und schaltet ihn aus. In Claude Desktop löscht man seinen Eintrag aus der Konfigurationsdatei und startet die App neu.
Was ist der Unterschied zwischen Claude MCP und Claude Skills? MCP gibt Claude Zugriff auf ein anderes System; ein Skill vermittelt Claude eine Vorgehensweise. Ein MCP-Server ruft den Kundendatensatz ab, und ein Skill sagt, wie man daraus den Standardbericht erstellt. Sie lösen unterschiedliche Probleme, und die meisten realen Workflows verwenden am Ende beides gemeinsam.
Wählt ein System aus, das ihr bereits jeden Tag öffnet, fügt dessen Server im lokalen Scope hinzu und gebt Claude darin eine echte Aufgabe. Wenn sich der Server bewährt, verschiebt ihn in den Projekt-Scope, damit auch der Rest des Teams davon profitiert.
Automatisch übersetzt. Das Original auf Englisch ist unten aufklappbar.
Original (Englisch) anzeigen
Posted on Oct 11 • Originally published at nulltensor.com
Claude MCP is Claude connected to other systems through the Model Context Protocol, Anthropic's open standard for giving AI assistants tools and data. You add an MCP server, the server exposes what one system can do, and Claude can then read from it and act in it. In Claude Code, adding one is a single claude mcp add command.
That is the short version. The rest of this post covers what an MCP server actually gives Claude, how to add one in each Claude app, where the configuration lives, and the few security habits worth having from the first day.
An MCP server is a small program that speaks the protocol and offers three kinds of things:
Servers run in one of two ways. A local server is a process on your own machine that Claude starts and talks to over standard input and output (stdio). A remote server runs somewhere else and Claude reaches it over HTTP. Local is simpler for your own files and tools; remote suits services you sign in to, and it works from claude.ai in a browser, where nothing can run on your machine.
Anthropic released MCP as an open standard in November 2024, so the same server works with Claude Code, Claude Desktop, claude.ai and other MCP clients. Whether a system needs its own MCP server, or whether the API it already has is enough, is a separate decision; I worked through it in MCP vs API.
The command is claude mcp add. For a local server, everything after the two dashes is the command Claude Code runs to start it:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects Enter fullscreen mode Exit fullscreen mode Pass secrets as environment variables, not as arguments, with --env:
claude mcp add --env AIRTABLE_API_KEY = your-key airtable -- npx -y airtable-mcp-server Enter fullscreen mode Exit fullscreen mode For a remote server, give the transport and the URL:
claude mcp add --transport http notion https://mcp.notion.com/mcp Enter fullscreen mode Exit fullscreen mode Remote servers usually sign you in with OAuth. Open a Claude Code session, type /mcp, pick the server and finish the login in the browser. A server that takes a fixed token instead accepts a header: --header "Authorization: Bearer your-token". The older SSE transport still works but is deprecated; use HTTP where a server offers it.
Every server is added at one of three scopes, set with --scope:
Use project scope for servers the whole team needs, such as the issue tracker for that repository, and commit the file. Use user scope for personal tools you want everywhere. Leave one-off experiments at the default.
Project-scoped servers live in.mcp.json, and you can write it by hand:
{ "mcpServers": { "issues": { "type": "http", "url": "https://example.com/mcp" }, "database": { "type": "stdio", "command": "/path/to/db-server", "args": [ "--read-only" ], "env": { "DB_URL": "${DB_URL}" } } } } Enter fullscreen mode Exit fullscreen mode ${VAR} expands from your environment, so the committed file holds no secrets; ${VAR:-default} supplies a fallback. To add a server from a JSON snippet without editing files, use claude mcp add-json <name> '<json>'. If you already set servers up in Claude Desktop, claude mcp add-from-claude-desktop imports them on macOS and WSL.
claude mcp list # every configured server claude mcp get issues # details for one claude mcp remove issues # delete it (add --scope project for.mcp.json) Enter fullscreen mode Exit fullscreen mode Inside a session, /mcp shows which servers connected and which failed, and lets you switch one off without deleting it. That is the quickest fix when a server is misbehaving and you want it out of the way for an afternoon.
Claude Desktop reads local servers from claude_desktop_config.json. Open it from the Claude menu: Settings, then Developer, then Edit Config. It lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows, and uses the same mcpServers shape as.mcp.json. Quit and reopen the app after editing it; Desktop only reads the file at start-up.
claude.ai in the browser cannot start local processes, so it uses remote servers only, which it calls connectors. Open Settings, choose Connectors, click Add and then "Add custom connector", paste the server URL and sign in. The connector's settings let you turn individual tools on or off, which is worth doing for anything that can write.
An MCP server runs with real credentials and, for local servers, with your user account's permissions. Three habits cover most of the risk:
The design side of this, deciding which actions a server should expose at all, is most of what MCP vs API is about.
MCP gives Claude access to a system; a Skill teaches it a procedure. The two fit together: the server fetches the data, the Skill says what to do with it. For the full comparison, including when to reach for each, see Claude Skills vs MCP servers.
What is Claude MCP? Claude MCP is Claude using the Model Context Protocol, Anthropic's open standard for connecting AI assistants to other systems. Claude connects to MCP servers, and each server exposes tools, resources or prompts from one system, such as GitHub or a database, so Claude can read live data and take actions there.
How do I add an MCP server to Claude Code? Run claude mcp add. For a local server, put the launch command after two dashes: claude mcp add my-server -- npx -y some-mcp-server. For a remote server, pass the transport and URL: claude mcp add --transport http my-server https://example.com/mcp. Then run /mcp inside Claude Code to check it connected.
Where is the Claude MCP config file? It depends on the app. Claude Code keeps local and user servers in ~/.claude.json and shared project servers in.mcp.json at the project root. Claude Desktop uses claude_desktop_config.json, under ~/Library/Application Support/Claude on macOS and %APPDATA%\Claude on Windows. claude.ai stores connectors in your account settings.
How do I remove an MCP server from Claude? In Claude Code, run claude mcp remove followed by the server name, adding --scope project if it lives in.mcp.json. To pause a server without deleting it, open /mcp and turn it off. In Claude Desktop, delete its entry from the config file and restart the app.
What is the difference between Claude MCP and Claude Skills? MCP gives Claude access to another system; a Skill teaches Claude a procedure. An MCP server fetches the customer record, and a Skill says how to turn it into your standard report. They solve different problems, and most real workflows end up using both together.
Pick one system you already open every day, add its server at local scope, and give Claude one real task in it. If the server earns its place, move it to project scope so the rest of the team gets it too.