Seminar KI-Agenten und MCP – Werkzeuge und Dienste integrieren

Beschreibung

Das Model Context Protocol standardisiert die Verbindung zwischen Agentenanwendungen und angebotenen Werkzeugen beziehungsweise Kontextdaten. Dieses Seminar zeigt die Rollen von Host, Client und Server und entwickelt einen begrenzten MCP-Server für einen internen Servicefall. Dabei wird deutlich, welche Aufgaben das Protokoll übernimmt und welche fachlichen Regeln weiterhin in der Anwendung durchgesetzt werden müssen.

Der praktische Schwerpunkt liegt auf einem sauberen Werkzeugvertrag, kontrollierten Transportwegen und Integrationstests. Ein lokaler Dienst wird zunächst über Standard-Ein- und -Ausgabe angebunden; anschließend wird die Einbindung eines HTTP-basierten Dienstes untersucht. Die Autorisierungsübung nutzt einen vorbereiteten Zugangsdienst. Der Aufbau einer vollständigen Identitätsplattform ist nicht Bestandteil des Kurses. Protokollversion und Fähigkeiten werden zwischen Client und Server ausdrücklich abgeglichen.

Als Werkzeugdienst dient eine kleine Anwendung für Serviceinformationen. Der Agent kann den Status eines zulässigen Vorgangs lesen und einen Änderungsvorschlag vorbereiten. Der MCP-Server übernimmt die Protokollkommunikation, während der dahinterliegende Dienst die fachlichen Rechte prüft. An diesem Aufbau lassen sich Unterschiede zwischen Verbindungserfolg, gültigem Token und tatsächlich erlaubtem Ressourcenzugriff untersuchen. Die Übungen zeigen außerdem, wie eine klare Fehlerantwort dem Agenten eine kontrollierte Reaktion ermöglicht, ohne interne Zugangsdaten oder unnötige Systemdetails preiszugeben.

Seminarziele

• MCP-Rollen, Fähigkeiten und Werkzeugverträge fachlich richtig einordnen.
• Einen kleinen Server mit klar begrenzten Werkzeugen implementieren.
• Lokalen Transport und HTTP-Zugriff passend absichern.
• Fehlersituationen zwischen Agent, Client, Server und Fachsystem diagnostizieren.

Seminarinhalte

• Protokoll und Rollen
• Werkzeuge bereitstellen
• Transport und Integration
• Autorisierung und Vertrauensgrenzen
• Kompatibilität und Fehlertests

Protokoll und Rollen

• Host, Client und Server sowie deren Verantwortlichkeiten unterscheiden.
• Initialisierung, Versionsabgleich und Aushandlung unterstützter Fähigkeiten prüfen.
• Tools, Resources und Prompts nach Steuerung und Einsatzgebiet einordnen.

Werkzeuge bereitstellen

• Eingabeschema, Ergebnisformat und fachliche Fehlerzustände definieren.
• Ein lesendes Werkzeug und einen kontrollierten Änderungsvorschlag implementieren.
• Beschreibungen als fremde Metadaten behandeln und Werkzeugumfang begrenzen.

Transport und Integration

• Lokale Kommunikation über stdio und Streamable HTTP vergleichen.
• Prozessstart, Netzwerkpfad, Zeitgrenzen und Abbruch sauber behandeln.
• Einen MCP-Client an den eigenen Agentenadapter anbinden.

Autorisierung und Vertrauensgrenzen

• HTTP-Zugriff mit einem vorbereiteten Autorisierungsdienst untersuchen.
• Tokenziel, erlaubte Berechtigungen und fachlichen Ressourcenzugriff prüfen.
• Lokale Zugangsdaten, Weitergabe von Tokens und Netzwerkfreigaben begrenzen.

Kompatibilität und Fehlertests

• Unbekannte Werkzeuge, ungültige Parameter und fehlende Rechte testen.
• Verbindungsabbruch, Versionsunterschiede und Dienstneustart untersuchen.
• Werkzeugaufrufe mit Vorgangskennung und reduzierten Protokolldaten nachverfolgen.

Praxisübungen

1. Einen kleinen MCP-Server mit einem lesenden Servicewerkzeug implementieren und das Werkzeugschema prüfen.
2. Den Server lokal an einen Agentenclient anbinden und Werkzeugantworten korrekt zuordnen.
3. Einen vorbereiteten HTTP-Zugang mit gültigen und unzulässigen Tokens beziehungsweise Ressourcenzugriffen untersuchen.
4. Fehlerhafte Parameter, einen nicht erreichbaren Dienst und einen kontrollierten Abbruch als Integrationstests ausführen.

Arbeitsumgebung

Vorbereitete Python-Umgebung mit kompatiblem MCP-SDK, Agentenclient, Test-API und einem vorkonfigurierten Autorisierungsdienst. Verwendete Protokollversionen werden vor Seminarbeginn aufeinander abgestimmt.