MCP Inspector – Die Weboberfläche nutzen
Dieser Guide geht die Weboberfläche des MCP Inspector Feld für Feld durch und beantwortet die praktische Frage: Was trage ich eigentlich in jedes Feld ein? — Transport Type, Command, Arguments, Environment Variables, Authentication, Configuration und Open Auth Settings.
Du willst stattdessen die Architektur, den CLI-Modus und den Sicherheits-Hintergrund? Siehe den MCP Inspector Developer Guide.
1. Starten und die UI öffnen
Starte den Inspector aus einem Terminal:
npx @modelcontextprotocol/inspector
Er gibt eine URL aus, in die ein Session-Token bereits eingebettet ist — öffne diese, damit die UI automatisch authentifiziert ist:
🔗 http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=3a1c267f...
Die Weboberfläche läuft unter http://localhost:6274. Wenn du die nackte Adresse ohne Token öffnest, musst du den Token unter Configuration einfügen (siehe §7 unten).
2. Die Oberfläche auf einen Blick
┌───────────────────────────┬──────────────────────────────────────┐
│ LINKE SIDEBAR (verbinden) │ HAUPTBEREICH (nach dem Verbinden) │
│ │ │
│ Transport Type ▼ │ [ Resources | Prompts | Tools | │
│ Command / URL │ Ping | Sampling | Roots | │
│ Arguments │ Notifications ] │
│ Environment Variables │ │
│ Authentication │ → Elemente auflisten, Schemas │
│ Configuration ⚙ │ inspizieren, Tools ausführen, │
│ │ Ressourcen lesen, │
│ [ Connect ] │ das Message-Log beobachten │
└───────────────────────────┴──────────────────────────────────────┘
Deine ganze Einrichtungszeit verbringst du in der linken Sidebar. Sobald du auf Connect klickst, werden die Tabs rechts lebendig.
3. Der Verbindungsablauf in drei Schritten
- Wähle einen Transport Type.
- Fülle die Felder aus, die dieser Transport einblendet (Command/Arguments für lokal; URL für remote).
- Klicke auf Connect. Der Status wechselt zu Connected, und die Tabs auf der rechten Seite füllen sich.
Der Rest dieses Guides erklärt jedes Feld.
4. Transport Type
Das erste Dropdown. Es entscheidet, wie der Inspector deinen Server erreicht, und welche weiteren Felder erscheinen.
| Option | Nutze es, wenn… | Felder, die es zeigt |
|---|---|---|
| STDIO | Der Server ist ein lokaler Prozess, den du per Befehl startest (die meiste lokale Entwicklung). | Command, Arguments, Environment Variables |
| SSE | Der Server ist remote/HTTP und nutzt Server-Sent Events (älterer Remote-Stil). | URL, Connection Type, Authentication |
| Streamable HTTP | Der Server ist remote/HTTP und nutzt den modernen Streamable-Transport. | URL, Connection Type, Authentication |
- Du testest einen Server, den du auf deiner eigenen Maschine betreibst → STDIO.
- Du verbindest dich mit einem gehosteten/remote Server → Streamable HTTP (probiere das zuerst), oder SSE, wenn der Server nur den älteren Endpunkt anbietet.
Für SSE / Streamable HTTP bekommst du zusätzlich einen Connection Type:
- Via Proxy (Standard) — der Verkehr läuft über den lokalen Proxy des Inspectors. Nutze das normalerweise.
- Direct — der Browser verbindet sich direkt mit dem Server (nützlich, wenn der Proxy ihn nicht erreichen kann, z. B. bei bestimmten CORS-Setups).
5. Command, Arguments & Environment Variables (STDIO)
Diese drei erscheinen nur bei STDIO.
Command
Die ausführbare Datei, die deinen Server startet — nicht das Skript selbst. Typische Werte:
| Server-Typ | Command |
|---|---|
| Node / TypeScript | node |
| Ein npm-Paket ausführen | npx |
| Python (uv-Projekt) | uv |
| Ein PyPI-Paket ausführen | uvx |
| Python direkt | python |
Arguments
Alles, was du nach dem Befehl tippen würdest, durch Leerzeichen getrennt. Das Feld-Label lautet wörtlich "Arguments (space-separated)".
| Command | Arguments | Ergebnis |
|---|---|---|
node | build/index.js | startet deinen gebauten Server |
npx | -y @modelcontextprotocol/server-filesystem /Users/you/Desktop | Filesystem-Server, begrenzt auf diesen Ordner |
uvx | mcp-server-git --repository ~/code/my-repo | Git-Server für dieses Repo |
uv | --directory path/to/server run package-name | startet ein lokales uv-Projekt |
Command + Arguments ist genau die Terminal-Zeile npx @modelcontextprotocol/inspector <Command> <Arguments>. Wenn es in deiner Shell läuft, läuft es auch hier.
Environment Variables
Schlüssel/Wert-Paare, die in den Server-Prozess eingespeist werden — hier kommen die Secrets und die Konfiguration hin, die dein Server braucht. Klicke auf Add Environment Variable, dann fülle die Platzhalter Key und Value aus.
| Key (Beispiel) | Value | Wofür |
|---|---|---|
GITHUB_TOKEN | ghp_… | Server authentifiziert sich bei GitHub |
OPENAI_API_KEY | sk-… | Server ruft OpenAI auf |
LOG_LEVEL | debug | ausführliche Server-Logs |
Das sind nicht die eigenen Einstellungen des Inspectors — sie werden an deinen Server übergeben, genau wie der env-Block in einem mcp.json-Eintrag.
6. Authentication & Open Auth Settings
Dieser Abschnitt erscheint bei SSE / Streamable HTTP-Servern (Remote-Server, die Anmeldedaten erfordern). Es gibt zwei voneinander unabhängige Mechanismen — nutze den, den dein Server erwartet.
Option A — Custom Headers / Bearer Token
Der einfachste Fall: Der Server akzeptiert einen statischen Token oder API-Schlüssel in einem Header.
- Bearer Token → der Inspector sendet
Authorization: Bearer <your-token>. - Custom Headers → füge einen beliebigen Header hinzu, etwa
X-API-Key: <value>, wenn der Server einen nicht-standardmäßigen Namen nutzt.
Nutze das, wenn du bereits einen langlebigen Token oder API-Schlüssel hast.
Option B — OAuth 2.0 Flow ("Open Auth Settings")
Wenn der Server OAuth spricht (das moderne Muster für gehostete MCP-Server), öffne den OAuth 2.0 Flow / die Auth Settings, um den Authorization-Code-Handshake auszuführen. Der Inspector übernimmt die Discovery, leitet dich durch den Login des Anbieters und speist den resultierenden Access-Token ein.
| Feld | Was du einträgst |
|---|---|
| Client ID | Lass es leer, wenn der Server dynamische Client-Registrierung unterstützt — der Inspector registriert sich selbst. Trage nur dann einen Wert ein, wenn du einen Client vorab registriert hast. |
| Client Secret (optional) | Nur für vertrauliche Clients, die dir ein Secret ausgestellt haben. Öffentliche Clients lassen es leer. |
| Redirect URL | Mit dem Callback des Inspectors vorausgefüllt (http://localhost:6274/oauth/callback). Ändere es nur, wenn der Server einen bestimmten registrierten Redirect verlangt. |
| Scope (durch Leerzeichen getrennt) | Die Berechtigungs-Scopes, die der Server dokumentiert, z. B. read write. Lass es leer, um die Standardwerte zu akzeptieren. |
Bei den meisten OAuth-fähigen MCP-Servern trägst du hier nichts ein: Lass Client ID, Secret und Scope leer, behalte die Standard-Redirect-URL, klicke, um den Flow zu starten, logge dich ein, und der Token wird automatisch erfasst. Fülle Felder nur aus, wenn ein Server ausdrücklich einen vorab registrierten Client oder bestimmte Scopes verlangt.
7. Configuration-Panel
Der Abschnitt Configuration (Zahnrad ⚙) enthält die eigenen Einstellungen des Inspectors — wie er mit dem Proxy spricht und wie lange er wartet. Die Standardwerte sind sinnvoll; ändere diese nur bei Bedarf.
| Einstellung | Standard | Ändere sie, wenn… |
|---|---|---|
Proxy Session Token (MCP_PROXY_AUTH_TOKEN) | (auto) | Du die UI ohne die Token-URL geöffnet hast — füge hier den im Terminal ausgegebenen Token ein. |
Request Timeout (MCP_SERVER_REQUEST_TIMEOUT) | 300000 ms | Ein Tool ist langsam und läuft in einen Timeout — erhöhe ihn. |
Reset Timeout on Progress (MCP_REQUEST_TIMEOUT_RESET_ON_PROGRESS) | true | Lass es an, damit Fortschritts-Benachrichtigungen lange Aufrufe am Leben halten. |
Maximum Total Timeout (MCP_REQUEST_MAX_TOTAL_TIMEOUT) | 60000 ms | Begrenze die absolute Wartezeit, selbst bei Fortschritts-Updates. |
Inspector Proxy Address (MCP_PROXY_FULL_ADDRESS) | (leer) | Der Proxy läuft auf einem nicht-standardmäßigen Host/Port, z. B. http://10.1.1.22:5577. |
Eine rote Meldung "Connection Error — did you add the proxy session token?" bedeutet, dass die UI nicht authentifiziert ist. Füge hier den Proxy Session Token ein, oder starte neu und nutze die vollständige URL mit ?MCP_PROXY_AUTH_TOKEN=….
8. Verbinden und die Arbeits-Tabs
Klicke auf Connect. Das Status-Badge zeigt Connected (oder Disconnected / einen Fehler). Steuer-Buttons:
- Connect — die Sitzung öffnen.
- Restart — den Server-Prozess (STDIO) neu starten und erneut verbinden.
- Reconnect — die Sitzung nach einem Server-Rebuild wiederherstellen.
- Disconnect — sie schließen.
Sobald verbunden, arbeitest du in den Tabs:
| Tab | Was du dort tust |
|---|---|
| Resources | Ressourcen auflisten, Metadaten ansehen (MIME-Typ, Beschreibung), Inhalte lesen, Subscriptions testen. |
| Prompts | Prompt-Vorlagen sehen, ihre Argumente ausfüllen, die generierten Nachrichten vorschauen. |
| Tools | Tools auflisten, ihre Eingabe-Schemas lesen, sie mit eigenen Eingaben ausführen, Ergebnisse ansehen. |
| Notifications | Server-Logs und Protokoll-Benachrichtigungen beobachten — dein wichtigstes Debugging-Fenster. |
9. Eine Konfiguration wiederverwenden
Zwei Kopier-Buttons in der Sidebar exportieren, was du eingerichtet hast:
- Server Entry — kopiert den JSON-Block dieses einen Servers.
- Servers File — kopiert eine vollständige
mcp.jsonmit einermcpServers-Map.
Füge das Ergebnis in eine mcp.json-Datei ein, um dasselbe Setup später erneut zu starten oder es mit deinem Team zu teilen. (Siehe den Developer Guide, Abschnitt Configuration file, für das Format und wie man es lädt.)
10. Schnelle Rezepte
Lokaler Filesystem-Server (STDIO):
- Transport:
STDIO· Command:npx· Arguments:-y @modelcontextprotocol/server-filesystem /Users/you/Desktop
Lokaler Git-Server (STDIO, Python):
- Transport:
STDIO· Command:uvx· Arguments:mcp-server-git --repository ~/code/my-repo
Dein eigener gebauter Server mit einem Secret (STDIO):
- Transport:
STDIO· Command:node· Arguments:build/index.js· Env:API_KEY = …
Remote-Server mit einem API-Schlüssel (Streamable HTTP):
- Transport:
Streamable HTTP· URL:https://server.example.com/mcp· Authentication: Bearer Token =…
Remote-Server mit OAuth (Streamable HTTP):
- Transport:
Streamable HTTP· URL:https://server.example.com/mcp· Öffne den OAuth-Flow, lass die Felder leer, logge dich ein.
Siehe auch
- MCP Inspector – Developer Guide — Architektur, CLI-Modus, Umgebungsvariablen, Sicherheitsmodell.
- MCP Connector Guide for Claude — MCP-Server und -Connectors bauen.
- MCP Inspector on GitHub