Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Testen Sie einen Model Context Protocol (MCP) Server auf drei Ebenen: das Protokollverhalten, seine Windows Registrierung und sein Verhalten über den vorgesehenen Agenthost. Das Übergehen einer Ebene beweist nicht, dass die anderen funktionieren.
Hinweis
Einige Informationen beziehen sich auf ein Produkt in einer Vorabversion, das vor der kommerziellen Freigabe grundlegend geändert werden kann. Microsoft gibt keine Garantie, weder ausdrücklich noch impliziert, hinsichtlich der hier bereitgestellten Informationen.
Prerequisites
- Ein Entwicklungsserver MCP und Testdaten, die Sie sicher lesen oder ändern können. Für einen lokalen Server sollten Sie den Befehl, die Argumente und die zum Starten nötigen Umgebungsvariablen kennen. Kennen Sie für einen Remoteserver dessen Endpunkt-, Transport- und Authentifizierungsanforderungen.
- Eine unterstützte Node.js Installation. Der aktuelle MCP Inspektor erfordert Node.js 22.19.0 oder höher. Überprüfen Sie deren Anforderungen, wenn Sie die Inspector-Version für Ihre Tests auswählen.
- Für die Windows-Registrierung und die Ausführung in Containern ist Windows 11 Build 26220.7262 oder höher erforderlich, wobei das Feature MCP verfügbar und aktiviert sein muss. Befolgen Sie die aktuellen Voraussetzungen für die Paketidentitätsregistrierung, einschließlich der Signaturanforderungen, für Ihre Bereitstellung.
- Ein Agenthost, der die Erkennung und Verbindung über die Windows On-Device-Agent-Registrierung (ODR) unterstützt, wenn Sie diese Integration testen.
Überprüfen Sie Ihre Node.js Version in PowerShell:
node --version
Für Direct Inspector-Tests ist keine Windows-Registrierung erforderlich. Ein lokaler Binärserver benötigt Paketidentität und die erforderlichen Registrierungsmetadaten, um unter Windows eingebettet ausgeführt zu werden. Informationen zu den entsprechenden Anforderungen finden Sie unter Sicheres Isolieren MCP von Servern unter Windows.
Protokollverhalten mit MCP Inspector testen
MCP Der Inspector kann eine direkte Verbindung mit einem Server herstellen, damit Sie seine Initialisierung, Tools, Ergebnisse und Fehler überprüfen können, bevor Sie die Windows-Integration testen. Starten Sie nur ausführbare Dateien, und stellen Sie eine Verbindung mit Endpunkten her, denen Sie vertrauen.
Lokalen stdio-Server testen
Ersetzen Sie den Beispielpfad durch die ausführbare Datei des Servers, und führen Sie dann Folgendes aus:
$serverPath = 'C:\path\to\YourMcpServer.exe'
npx @modelcontextprotocol/inspector "$serverPath"
Inspektor startet den Server und öffnet seine Webschnittstelle. Geben Sie argumente oder Umgebungsvariablen an, die Ihr Server benötigt. Übergeben Sie für Server, die in einer anderen Laufzeit implementiert sind, den Befehl, der normalerweise den Server startet.
Überprüfen Sie, ob der Server:
- Initialisiert erfolgreich und meldet den erwarteten Namen, die Version und die Funktionen.
- Listet die erwarteten Tools mit genauen Beschreibungen und Eingabe- und Ausgabeschemas auf.
- Gibt die erwarteten Ergebnisse für gültige Eingaben zurück.
- Gibt aussagekräftige Fehlermeldungen für ungültige Eingaben, nicht autorisierte Anfragen und nicht verfügbare Abhängigkeiten zurück, ohne Anmeldeinformationen oder vertrauliche Daten preiszugeben.
Bei Stdioservern geben Sie Protokollmeldungen über die Standardausgabe aus und schreiben Diagnoseprotokolle in die Standardfehlerausgabe. Andere Ausgabe auf der Standardausgabe kann die MCP-Verbindung unterbrechen.
Verwenden Sie für eine Befehlszeilen-Toollistenüberprüfung den CLI-Client des Inspektors:
npx @modelcontextprotocol/inspector --cli "$serverPath" --method tools/list
Dadurch wird eine direkte Verbindung mit der ausführbaren Datei überprüft. Es testet nicht die Windows-Erkennung und startet den Server nicht in einer isolierten Agent-Sitzung. Verwenden Sie für die wiederholbare Automatisierung eine genehmigte Inspector-Version, und befolgen Sie die Inspector CLI-Anleitung, einschließlich der Authentifizierungsbehandlung für nicht interaktive Ausführungen.
Entfernten HTTP-Server testen
Starten Sie den Inspector mit dem Endpunkt Ihres Entwicklungsservers und dem unterstützten Transport. Ersetzen Sie für einen streambaren HTTP-Endpunkt die Beispiel-URL, und führen Sie Folgendes aus:
$serverUrl = 'https://your-server.example/mcp'
npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
Schließen Sie den Authentifizierungsfluss des Servers ab, und testen Sie seine Tools mit zulässigen und eingeschränkten Konten. Platzieren Sie keine Zugriffstoken oder geheimen Clientschlüssel in Beispielen, Screenshots oder freigegebenen Protokollen.
Ein Remoteserver läuft auf eigener Infrastruktur. Die Verbindung von Windows aus platziert diesen Remoteprozess nicht innerhalb einer Windows-Agent-Sitzung.
Windows-Registrierung überprüfen
Installieren oder registrieren Sie den Server, indem Sie das Verfahren entsprechend seinem Bereitstellungsmodell ausführen:
- Registrieren Sie einen MCP Server in einer App mit Paketidentität.
- Registrieren Sie einen MCP Server mit einem MCP Bündel.
- Manuelles Registrieren von Remote- und lokalen MCP Servern.
Verwenden Sie die MCP befehlsgruppe, die im ODR-Befehlszeilenverweis dokumentiert ist, um registrierte Server aufzulisten:
odr.exe mcp list
Überprüfen Sie, ob die erwarteten Server- und Registrierungsmetadaten angezeigt werden. Eine Auflistung bestätigt Discovery-Metadaten; sie beweist nicht, dass der Server ein Tool starten, authentifizieren oder ausführen kann.
Vorschaubefehlsoberflächen können sich je nach Windows-Build unterscheiden. Überprüfen Sie die Hilfe für Ihre installierte Version, wenn ein Befehl nicht erkannt wird:
odr.exe --help
odr.exe mcp --help
Vergleichen Sie bei der Windows-Registrierung im Standardmodus die Laufzeitantworten initialize und tools/list des Servers mit den statischen Antworten des Manifests. Namen, Versionen, Funktionen, Toolbeschreibungen und Schemas müssen die übereinstimmenden Anforderungen in Registrieren eines MCP Servers mit einem MCP Paket erfüllen. Wiederholen Sie diese Überprüfung, wenn Sie entweder die Implementierung oder das Manifest aktualisieren.
Über den vorgesehenen Agent-Host testen
Verwenden Sie den Host und den Windows-Registrierungspfad, die Ihre Benutzer verwenden. Ersetzen Sie keinen direkten Start der ausführbaren Datei durch einen Test der ODR-vermittelten Ausführung.
Testen Sie für einen lokalen Paketidentitätsserver unter den standardmäßigen Agent-Connector-Schutzfunktionen:
- Ermitteln Sie den installierten Server über die Windows Integration des Hosts, und stellen Sie eine Verbindung damit her. Vergewissern Sie sich, dass der Host die registrierte Verbindung anstelle einer separat konfigurierten ausführbaren Datei verwendet.
- Listen Sie Tools auf und rufen Sie einen unbedenklichen schreibgeschützten Vorgang mit Testdaten auf. Überprüfen Sie das Ergebnis und alle erwarteten Einwilligungsaufforderungen.
- Test des erforderlichen Ressourcenzugriffs sowohl vor als auch nach der entsprechenden Zustimmung. Stellen Sie sicher, dass der Server nicht vom direkten Zugriff auf die Anmeldeinformationen, Einstellungen, Dateien oder App-Fenster des angemeldeten Benutzers abhängt.
- Verweigerte Berechtigungen, widerrufene Einwilligung, abgelaufene Authentifizierung und nicht verfügbare Dienste testen. Vergewissern Sie sich, dass Fehler behandelt werden, ohne den Zugriff unbemerkt zu erweitern.
- Aktualisieren und deinstallieren Sie das Paket. Stellen Sie sicher, dass sich die Registrierung wie erwartet ändert und der Host keine gelöschte Registrierung mehr anbietet oder verwendet.
Important
Direkt installierte MCP Pakete werden nicht gekapselt unter den Standardschutzmechanismen ausgeführt. Reduzieren Sie den Agent-Connector-Schutz nicht, damit ein Kapselungstest besteht. Überprüfen Sie die Kapselungsanforderungen und Einschränkungen, bevor Sie einen Registrierungspfad auswählen.
Die Zustimmung für den Dateizugriff gilt für den Host, nicht einzeln für jeden Server, der von diesem Host verwendet wird. Verwenden Sie ein Testsetup mit bekanntem Zustimmungsstatus, wenn das Verweigerungsverhalten überprüft wird, und gehen Sie nicht davon aus, dass ein anderer Server, den derselbe Host verwendet, von einer freigegebenen Ressource ausgeschlossen ist.
Windows-Containment begrenzt den Zugriff auf lokale Ressourcen. Ihre Back-End-Dienste müssen den Aufrufer weiterhin authentifizieren und jeden Vorgang autorisieren. Testen Sie bei Tools, die Daten ändern, auch die Genehmigung, den Abbruch und das Wiederholungsverhalten der Anwendung mit Datensätzen aus Nicht-Produktionsumgebungen.
Fehler beheben
| Symptom | Was soll überprüft werden? |
|---|---|
node oder npx nicht gefunden |
Überprüfen Sie die Node.js Installation und PATH, und öffnen Sie dann ein neues PowerShell-Fenster. |
| Der Inspector kann keine Verbindung mit einem lokalen Server herstellen. | Überprüfen Sie den ausführbaren Pfad, erforderliche Argumente und Umgebung, Startfehler und ob die Standardausgabe Nichtprotokolltext enthält. |
| ODR meldet, dass die MCP Surface nicht aktiviert ist | Überprüfen Sie den unterstützten Windows-Build, die Featureverfügbarkeit und die anwendbaren Organisationseinstellungen, bevor Sie am Server selbst eine Problembehandlung durchführen. |
| Der Server wird in ODR nicht angezeigt. | Überprüfen Sie die Installations- oder Registrierungsprozedur und die Hilfe des installierten Befehls. Überprüfen Sie bei Paketen die Einschränkungen des Standardschutzes. |
| Direct Inspector-Aufrufe funktionieren, aber Hostanrufe schlagen fehl | Überprüfen Sie den registrierten Startpfad, die Manifest-/Laufzeitvereinbarung, Containment-Einschränkungen, den Zustimmungsstatus und die Authentifizierung in der Agentsitzung. |