Anbindung eines MCP-Servers in der Anwendung
Eine erfolgreiche Verbindung erfordert einen kompatiblen Endpunkt, Transport und Authentifizierung.
Was Sie lernen werden
- Erklären Sie: Host, Client und Server
- Wenden Sie die Idee in einem Beispiel an: Anbindung eines MCP-Servers in der Anwendung
- Erkennen Sie Einschränkungen und überprüfen Sie das Übungsergebnis
Eine erfolgreiche Verbindung erfordert einen kompatiblen Endpunkt, Transport und Authentifizierung. Wählen Sie dann für den Agent nützliche Tools aus.
Diese Schritte beziehen sich auf im Anwendungscode identifizierte Funktionen. Dieses Material wurde nicht in einer Live-Instanz validiert; Überprüfen Sie die Dokumentation und die Optionen in Ihrer Version.
Wie es funktioniert, Schritt für Schritt
Host, Client und Server
MCP ist ein Protokoll, das KI-Anwendungen mit externen Funktionen verbindet. Der Host stellt das Erlebnis bereit, der Client verwaltet die Verbindung und der Server stellt je nach Support Tools, Ressourcen oder Eingabeaufforderungen bereit. Werkzeuge führen Operationen aus; Ressourcen stellen adressierbare Inhalte bereit; Eingabeaufforderungen stellen Vorlagen bereit. Nicht jeder Server implementiert alle drei. Der Transport überträgt Nachrichten, die Authentifizierung identifiziert Anrufer und die Autorisierung steuert den Zugriff. Überprüfen Sie die Protokollrevision und die unterstützten Erweiterungen an beiden Enden. Die Kompatibilität lässt sich nicht allein aus der Kennzeichnung „MCP“ ableiten.
Das Modell schlägt vor, das Werkzeug führt aus
Der Tool-Aufruf erzeugt eine Aufrufanforderung mit einem Namen und Argumenten. Die Anwendung validiert das Schema, die Berechtigungen und die Beschränkungen vor der Ausführung. Das Ergebnis kehrt für den nächsten Schritt in den Kontext zurück. Beispielsweise nimmt get_product_stock eine SKU und gibt eine Menge zurück; In der Beschreibung sollte erläutert werden, dass keine Produkte reserviert werden. Unterscheiden Sie zwischen leeren Ergebnissen, Validierungsfehlern, fehlendem Zugriff und Zeitüberschreitungen. Gültiges JSON beweist nicht, dass die Argumente korrekt sind oder die Aktion autorisiert ist. Denken Sie bei externen Effekten auch an eine doppelte Ausführung.
Überprüfen Sie den Zugang vor der Nutzung
Berechtigungen müssen von Servern und der Datenschicht durchgesetzt werden. Lassen Sie nicht das Modell entscheiden, ob ein Benutzer ein Dokument sehen darf. Filtern Sie Quellen, bevor sie in den Kontext gelangen, nicht nachdem die Antwort generiert wurde. Verwenden Sie Anmeldeinformationen mit minimalem Zugriff, halten Sie sie von Eingabeaufforderungen, Screenshots und Browsercode fern und rotieren Sie offengelegte Schlüssel. Eine Widget-Domain-Zulassungsliste ersetzt nicht die API-Authentifizierung. Durch die Authentifizierung werden Sie identifiziert; Die Autorisierung bestimmt die Vorgänge und Daten, die Sie verwenden können. Test verweigerte auch den Zugriff.
Das erklärende Schaubild
Folgen Sie den durchgezogenen Pfeilen für den Hauptfluss. Gestrichelte blaue Pfeile liefern Daten oder Kontext; Gestrichelte rosa Pfeile zeigen Feedback oder zurückgegebene Ergebnisse an. Farben und Formen unterscheiden Modelle, Geschäfte, Entscheidungen und Ergebnisse. Scrollen Sie auf kleinen Bildschirmen horizontal, um das gesamte Schaubild zu verfolgen.
Ein vollständiges Beispiel
Wählen Sie unter MCP-Server Identität und URL festlegen die Option AUTO oder Servertransport und -authentifizierung aus. Testen und prüfen Sie Werkzeuge und hängen Sie nur get_product_stock an den Agenten an.
Probieren Sie es selbst aus
- Verbinden Sie einen schreibgeschützten Testserver und überprüfen Sie einen gültigen SKU-Aufruf.
- Notieren Sie die Eingabe, die Quelle und das erwartete Ergebnis, bevor Sie das Experiment durchführen. Verwenden Sie im Beispiel nur die fiktiven Daten.
- Folgen Sie den Diagrammschritten. Notieren Sie bei jedem Schritt, welche Informationen empfangen und produziert werden. Verwechseln Sie Zwischenergebnisse nicht mit Endergebnissen.
- Wiederholen Sie den Vorgang, nachdem Sie erforderliche Informationen entfernt oder die Eingabe mehrdeutig gemacht haben. Prüfen Sie, ob das System eine Antwort klärt, stoppt oder erfindet.
- Vergleichen Sie mit der erklärten Lösung. Bewahren Sie die Konfiguration, das Datum, das Ergebnis und eine Erklärung für Unterschiede auf. Ändern Sie eine Sache und testen Sie es erneut.
Eine erklärte Lösung
Die Verbindung wird überprüft, das Tool wird erkannt und ein erlaubter Aufruf ist erfolgreich. Mit einer erfolgreichen Übung können Sie den Zusammenhang zwischen Input, Phasen und Ergebnis aufzeigen. Bei fehlenden Informationen ist eine vorsichtige Antwort sinnvoller als erfundene Details. Vergleichen Sie mehr als nur Stil: Überprüfen Sie auch Bedingungen, Quellen und Vorgänge.
Wann dieser Ansatz hilft und wo seine Grenzen liegen
stdio ist ein allgemeines Konzept, keine implizite Remote-Form-Option. Wählen Sie diesen Ansatz, wenn er einen gemessenen Bedarf verbessert. Behalten Sie eine einfache Ausgangsbasis bei und vergleichen Sie die Ergebnisse mit identischen Eingaben. Ein erfolgreiches Beispiel stellt nicht in jeder Situation Verlässlichkeit dar.
Überprüfen Sie Ihr Wissen
Bietet ein Server mit Tools automatisch Ressourcen und Eingabeaufforderungen?
Nein. Fähigkeiten sind optional und müssen entdeckt und überprüft werden.
Wer führt einen vom Modell vorgeschlagenen Aufruf aus?
Die Anwendung oder der Hostdienst nach der Validierung. Das Modell erhält nicht automatisch uneingeschränkten Zugriff.
Zu welchem Ergebnis soll diese Übung führen?
Die Verbindung wird überprüft, das Tool wird erkannt und ein erlaubter Aufruf ist erfolgreich.
Wichtige Begriffe
- MCP-Server: Ein Dienst, der Funktionen über das Model Context Protocol verfügbar macht.
- Werkzeugaufruf: Eine strukturierte Anfrage zur Nutzung einer externen Funktion.
- Autorisierung / Autorisierung: Überprüfung des Zugriffsrechts auf einen Vorgang oder eine Ressource.
Quellen und Ihr nächster Schritt
Zur Vorbereitung: M01 – Was ist ein MCP-Server?