Seminar FerretDB Data API und MCP-Integration

Zielsetzung

Das Seminar zeigt, wie FerretDB neben dem MongoDB-Protokoll über die integrierte Data API und den grundlegenden MCP-Server angesprochen wird. Die Schnittstellen werden sicher aktiviert, getestet, beobachtet und in kleine Anwendungs- beziehungsweise Automatisierungsszenarien eingebunden.

Inhaltsübersicht

1. Zielsetzung und Lernziele
2. Teilnehmerkreis und Voraussetzungen
3. Schnittstellen und Einsatzgrenzen
4. Listener und Authentifizierung konfigurieren
5. CRUD über die Data API
6. OpenAPI-gestützte Tests
7. MCP-Grundintegration
8. Betrieb und Fehleranalyse
9. Praxisübungen und Methodik

Lernziele

• Data API und MCP-Schnittstelle architektonisch voneinander abgrenzen
• HTTP-Endpunkte, Authentifizierung und Listener sicher konfigurieren
• CRUD-Anfragen über die Data API erstellen und automatisiert prüfen
• MCP-Funktionen mit klaren Berechtigungs- und Sicherheitsgrenzen erproben

Teilnehmerkreis

Softwareentwickler, API-Entwickler, Automatisierungsfachkräfte, KI-Teams und DevOps-Verantwortliche.

Voraussetzungen

Grundkenntnisse in FerretDB, HTTP, JSON und Authentifizierung. Erfahrung mit einem API-Client oder curl ist hilfreich.

Seminarinhalte

Kapitel 1: Schnittstellen und Einsatzgrenzen

Inhaltsübersicht des Kapitels: MongoDB-Protokoll, Data API und MCP nach Zweck und Zielgruppe unterscheiden; Unterstützte Operationen und Reifegrad für den eigenen Einsatz bewerten; Vertrauensgrenzen zwischen Client, FerretDB und Datenbank festlegen.

1. Schritt 1: MongoDB-Protokoll, Data API und MCP nach Zweck und Zielgruppe unterscheiden
2. Schritt 2: Unterstützte Operationen und Reifegrad für den eigenen Einsatz bewerten
3. Schritt 3: Vertrauensgrenzen zwischen Client, FerretDB und Datenbank festlegen

Kapitel 2: Listener und Authentifizierung konfigurieren

Inhaltsübersicht des Kapitels: Data-API- und MCP-Listener auf geeignete Adressen und Ports binden; Zugangsdaten, Netzwerkfreigaben und TLS-Anforderungen definieren; Konfiguration mit Health- und Negativtests prüfen.

1. Schritt 1: Data-API- und MCP-Listener auf geeignete Adressen und Ports binden
2. Schritt 2: Zugangsdaten, Netzwerkfreigaben und TLS-Anforderungen definieren
3. Schritt 3: Konfiguration mit Health- und Negativtests prüfen

Kapitel 3: CRUD über die Data API

Inhaltsübersicht des Kapitels: Insert-, Find-, Update- und Delete-Anfragen als JSON erstellen; Authentifizierungsheader und Fehlerantworten korrekt behandeln; Idempotenz, Eingabevalidierung und Zeitüberschreitungen berücksichtigen.

1. Schritt 1: Insert-, Find-, Update- und Delete-Anfragen als JSON erstellen
2. Schritt 2: Authentifizierungsheader und Fehlerantworten korrekt behandeln
3. Schritt 3: Idempotenz, Eingabevalidierung und Zeitüberschreitungen berücksichtigen

Kapitel 4: OpenAPI-gestützte Tests

Inhaltsübersicht des Kapitels: API-Beschreibung in einen geeigneten Client übernehmen; Umgebungsvariablen für Basisadresse und Zugangsdaten einrichten; Positive, negative und wiederholbare API-Tests definieren.

1. Schritt 1: API-Beschreibung in einen geeigneten Client übernehmen
2. Schritt 2: Umgebungsvariablen für Basisadresse und Zugangsdaten einrichten
3. Schritt 3: Positive, negative und wiederholbare API-Tests definieren

Kapitel 5: MCP-Grundintegration

Inhaltsübersicht des Kapitels: MCP-Listener aktivieren und die angebotenen Werkzeuge inventarisieren; Einen kontrollierten Clientzugriff mit begrenztem Testdatensatz herstellen; Ausgaben, Fehler und Sicherheitsrisiken protokollieren und bewerten.

1. Schritt 1: MCP-Listener aktivieren und die angebotenen Werkzeuge inventarisieren
2. Schritt 2: Einen kontrollierten Clientzugriff mit begrenztem Testdatensatz herstellen
3. Schritt 3: Ausgaben, Fehler und Sicherheitsrisiken protokollieren und bewerten

Kapitel 6: Betrieb und Fehleranalyse

Inhaltsübersicht des Kapitels: Logs, Metriken und Traces den Schnittstellenaufrufen zuordnen; Fehler zwischen Transport, Authentifizierung und Datenoperation unterscheiden; Betriebsregeln für Freigabe, Überwachung und Abschaltung formulieren.

1. Schritt 1: Logs, Metriken und Traces den Schnittstellenaufrufen zuordnen
2. Schritt 2: Fehler zwischen Transport, Authentifizierung und Datenoperation unterscheiden
3. Schritt 3: Betriebsregeln für Freigabe, Überwachung und Abschaltung formulieren

Praxisübungen

• Eine vollständige CRUD-Folge über HTTP ausführen und als Testsammlung speichern
• MCP-Zugriff in einer abgeschotteten Laborumgebung aktivieren und prüfen
• Fehlerfälle für falsche Zugangsdaten, ungültige Daten und nicht erreichbare Backends analysieren

Methodik

Kurze Architektur- und Sicherheitsblöcke wechseln mit API-Aufrufen, Konfigurationsübungen und nachvollziehbaren Testfällen. Experimentelle oder grundlegende Funktionen werden ausdrücklich in einer kontrollierten Laborumgebung behandelt.