MCP-Server entwickeln lassen: Anforderungen an Dienstleister

Ein individueller MCP-Server wird relevant, wenn KI-Anwendungen auf eigene Fachsysteme zugreifen sollen, für die kein geeigneter Standardzugang besteht. Der Beschaffungsgegenstand ist dabei mehr als die technische Bereitstellung eines Protokolls. Zu klären sind Datenumfang, erlaubte Aktionen und die Verantwortlichkeit für deren Folgen. Ein kontrollierter erster Schritt kann ausschließlich lesende Werkzeuge umfassen, etwa für den Abruf eines Vorgangsstatus.

Ausgangslage und Projektgrenzen

• Definieren Sie, welche Unternehmensfunktion ein Assistent lesen oder ausführen soll. Ein Werkzeug wie Auftragsstatus lesen ist besser abgrenzbar als ein pauschaler Datenbankzugriff.
• Trennen Sie reine Auskunft von Änderungen an Kunden, Verträgen oder Aufträgen. Schreibaktionen benötigen nachvollziehbare Zuständigkeit und gegebenenfalls Freigabe.
• Ordnen Sie jedem vorgesehenen Client reale Nutzeridentitäten und Unternehmensrollen zu; ein gemeinsames technisches Konto kann fachliche Rechte verschleiern.

Jedes Werkzeug benötigt ein verständliches Eingabeschema und eine serverseitige Berechtigungsprüfung. Die Anmeldung eines Nutzers sagt noch nicht aus, auf welchen Datensatz er zugreifen darf. Rollen, Organisation und Vertraulichkeit müssen auch für verschachtelte Beziehungen gelten. Schreibende Aktionen brauchen fachliche Validierung, nachvollziehbare Ergebnisse und Schutz vor unbeabsichtigten Wiederholungen. Kritische Schritte sollten eine explizite Freigabe oder einen gesonderten Geschäftsprozess verlangen.

Architektur, Risiken und Aufwandstreiber

• MCP und REST sollten dieselben fachlichen Dienste für Validierung, Zugriff und Zustandsänderungen aufrufen.

Transportadapter übernehmen nur die jeweilige Protokollübersetzung.

• Prüfen Sie die Zielgruppe eines Zugriffstokens und die Identität des Nutzers.

Tokens dürfen nicht ungeprüft an weitere Dienste durchgereicht werden.

• Begrenzen Sie Ergebnisse und verknüpfte Objekte.

Umfangreiche Daten liefern Sie über gezielte Detailabfragen und Pagination statt rekursiv eingebetteter Gesamtbestände.

GSWE betreibt in diesem Projekt ein Symfony-Backend mit REST- und MCP-Zugängen. Der Code enthält öffentliche API-Inhalte, authentifizierte MCP-Zugriffe, Rollenprüfungen und eine zusätzliche Vertraulichkeitsberechtigung. Diese eigene technische Grundlage ist ein nachvollziehbarer Ausgangspunkt für die Projektbesprechung. Sie ersetzt keine Prüfung der Anforderungen und Systemgrenzen eines Kundenprojekts.

Konkrete Prüffälle für den ersten Release

• Derselbe Nutzer liest einen Auftrag über REST und MCP. Sichtbare Felder, Organisationsgrenzen und fachlicher Status stimmen überein.
• Ein Werkzeug erhält eine unbekannte Eigenschaft oder eine ungültige Statusänderung. Beide Zugriffswege lehnen sie nach denselben fachlichen Regeln ab.
• Ein Client wiederholt eine Schreibaktion nach einem Timeout. Das System erkennt den Vorgang und führt die Änderung nicht unbemerkt doppelt aus.

Fordern Sie funktionale Tests für öffentliche, angemeldete und nicht berechtigte Nutzer an. Testfälle müssen nicht nur sichtbare Werkzeuge, sondern die tatsächliche Ausführung und ausgegebene Daten abdecken. Für Teilupdates ist festzulegen, dass ausgelassene Felder bestehen bleiben. Begrenzte Feldgrößen, verständliche Fehlermeldungen und klar dokumentierte Einzelschritte helfen KI-Clients, strukturierte Inhalte zuverlässig zu bearbeiten.

Beauftragen Sie zuerst ein klar begrenztes Werkzeug mit überschaubaren Auswirkungen. Die Abnahme sollte zeigen, dass ein anonymer Zugriff, ein angemeldeter Benutzer ohne Fachberechtigung und ein Benutzer ohne Vertraulichkeitsfreigabe unterschiedlich behandelt werden. Testen Sie Teilaktualisierungen: Eine Änderung an einem Textfeld darf keine anderen Inhalte löschen. Schreibende Werkzeuge benötigen außerdem fachliche Validierung und eine nachvollziehbare Rückmeldung darüber, welche Aktion tatsächlich ausgeführt wurde.

Trennen Sie bei der Werkzeugfreigabe lesende Abfragen von Aktionen mit fachlichen Folgen. Für schreibende Werkzeuge sind Eingabeprüfung, nachvollziehbare Bestätigung und Protokollierung besonders relevant. Die Abnahme sollte zeigen, dass ein öffentlich erreichbarer Endpunkt auch bei manipulierten Parametern keine geschützten Datensätze oder Werkzeuge freigibt.

Entscheidungshilfe für die Beauftragung

• Fordern Sie eine Werkzeugliste mit Eingabeschema, fachlichem Zweck, benötigter Rolle und möglichen Nebenwirkungen.
• Vereinbaren Sie Vertragstests für REST und MCP mit identischen Beispieldaten, einschließlich fehlender Rechte und ungültiger Eingaben.
• Prüfen Sie Client-Kompatibilität, Protokollversion und Verbindungsabbrüche im vorgesehenen Einsatz; eine lokale Werkzeugdemo belegt den produktiven Betrieb noch nicht.

Für ein vergleichbares Angebot

• MCP-Client, Quellsystem und die konkret benötigten Lese- oder Schreibaktionen nennen.
• Für jedes Tool Eingaben, Berechtigungen, Rückgabedaten und Bestätigungen festlegen.
• Abgewiesene Aktionen, ungültige Eingaben und Ausfälle des Fachsystems in die Abnahme aufnehmen.

Ein guter MCP-Auftrag beschreibt Geschäftsfunktionen und Sicherheitsgrenzen. Die Qualität zeigt sich daran, ob derselbe Nutzer über REST und MCP nur die vorgesehenen Daten und Aktionen erhält. Eine kleine, getestete Werkzeugmenge kann für den Einstieg wertvoller sein als ein umfangreicher Zugang ohne belastbare Daten- und Rechteprüfung.

Nutzen bewerten und den Ausbau begrenzen

• Messen Sie, ob Nutzer einen fachlichen Vorgang zuverlässig abschließen können und wie häufig manuelle Korrekturen erforderlich sind.
• Erweitern Sie die Werkzeugmenge nur, wenn Rollen, Protokollierung und Fehlerbehandlung auch für neue Aktionen geklärt sind.
• Bewerten Sie den MCP-Server als zusätzlichen Zugang zur Unternehmenssoftware.

Er sollte keine zweite, abweichende Fachlogik etablieren.

Skizzieren Sie, welche Aktion Ihr KI-Client im Fachsystem ausführen soll. GSWE übersetzt diesen Auftrag in einen abgegrenzten MCP-Toolumfang mit Rechten und überprüfbaren Ein- und Ausgaben.

Einen MCP-Server entwickeln lassen: MCP-Server für KI-Integration und Tool-Anbindung.