FACT COPY · DE

Faktenfassung: MCP und bestehende APIs kombinieren

REST-, SOAP- und GraphQL-Schnittstellen über klar definierte MCP-Fähigkeiten nutzbar machen.

Originalseite: https://travel-mcp.com/de/wissen/blog/mcp-und-bestehende-apis/

Erstellt
Aktualisiert
Zuletzt geprüft

Sachliche Zusammenfassung

REST-, SOAP- und GraphQL-Schnittstellen über klar definierte MCP-Fähigkeiten nutzbar machen. Im Mittelpunkt stehen konkrete Architekturentscheidungen, Sicherheitsgrenzen und die Voraussetzungen für ein Migrationspfad vom API-Portfolio zum kuratierten Capability-Katalog.

API-Inventar

Das API-Inventar erfasst nicht nur Endpunkte, sondern Eigentümer, Authentifizierung, Limits, Datenklassen und Stabilität. Undokumentierte Legacy-Schnittstellen eignen sich nicht automatisch als Fundament für agentische Zugriffe.

Für eine belastbare Analyse von „API-Inventar“ genügt deshalb keine Funktionsbeschreibung. Zu untersuchen sind Verantwortungsgrenze, Datenherkunft, erlaubte Zustandsänderungen, Fehlersemantik und der Nachweis, dass eine Adapterarchitektur, die bestehende Investitionen schützt und KI-gerechte Verträge ergänzt unter realen Betriebsbedingungen funktioniert. Ein Travel-Szenario sollte mindestens einen Normalfall, fehlende oder widersprüchliche Daten, einen Berechtigungsfehler und einen Ausfall des nachgelagerten Systems abdecken. Gerade bei REST-Services, SOAP-Fachverfahren, GraphQL-Plattformen und API-Gateways zeigt sich, ob das Modell nur eine überzeugende Antwort formuliert oder ob die gesamte Aufrufkette fachlich korrekt, reproduzierbar und für Betrieb sowie Revision nachvollziehbar ist.

Capability statt Endpunkt

Ein MCP-Tool repräsentiert eine fachliche Capability. Mehrere technische Aufrufe dürfen intern gebündelt werden, wenn Transaktion, Fehler und Berechtigung als ein verständlicher Vertrag erscheinen.

Methodisch sollte „Capability statt Endpunkt“ als überprüfbarer Vertrag behandelt werden. Das Team formuliert Vorbedingungen, Invarianten, Erfolgs- und Abbruchkriterien und ordnet jede Entscheidung einem fachlichen sowie technischen Eigentümer zu. Anschließend werden Negativtests aus blinde Eins-zu-eins-Generierung, weitergereichte interne Fehler und fehlende fachliche Aggregation abgeleitet. Für Integrationsteams, Architekten und API-Verantwortliche entsteht dadurch eine gemeinsame Bewertungsgrundlage: Architekturdiagramme erklären die Struktur, Testfälle belegen das Verhalten und Telemetrie zeigt die Qualität im laufenden Einsatz. Nur diese Verbindung erlaubt eine belastbare Aussage darüber, ob das System den angestrebten Nutzen tatsächlich und dauerhaft liefert.

Adapter und Anti-Corruption Layer

Der Adapter übersetzt zwischen öffentlichem Tool-Schema und internen Modellen. Diese Anti-Corruption-Schicht verhindert, dass SOAP-Feldnamen oder GraphQL-Interna den KI-Vertrag dominieren.

In der Reisebranche muss „Adapter und Anti-Corruption Layer“ zusätzlich gegen volatile Preise, verteilte Bestände, personenbezogene Profile, zeitkritische Reservierungen und heterogene Anbieter geprüft werden. Ein Ergebnis kann technisch gültig und wenige Sekunden später fachlich überholt sein. Deshalb benötigen Antworten Quelle, Erhebungszeitpunkt, Gültigkeitsgrenze und gegebenenfalls einen erneuten Bestätigungsschritt. Schreibende Fähigkeiten verlangen Idempotenz, eindeutige Korrelationskennungen und einen definierten Kompensationsweg. Diese Anforderungen machen MCP nicht unnötig komplex; sie legen jene Realitäten offen, die in klassischen Integrationen häufig nur implizit im Anwendungscode verborgen bleiben.

Authentifizierung weiterreichen

Nutzeridentität sollte delegiert und Audience-gebunden weitergegeben werden. Wo ein Backend nur Servicekonten kennt, muss der MCP-Server objektbezogene Rechte selbst verlässlich erzwingen und die ursprüngliche Identität auditieren.

Der Reifegrad von „Authentifizierung weiterreichen“ lässt sich an konkreten Evidenzen ablesen: versionierte Verträge, dokumentierte Rechte, automatisierte Grenzfalltests, messbare Laufzeiten, strukturierte Fehler und eine verantwortete Änderungsroute. Eine Demonstration unter Idealbedingungen ist kein Produktionsnachweis. Für ein Migrationspfad vom API-Portfolio zum kuratierten Capability-Katalog muss außerdem geklärt sein, wie neue Server- oder Clientversionen eingeführt, Abhängigkeiten zurückgerollt und fehlerhafte Fähigkeiten gesperrt werden. So wird aus einer technischen Möglichkeit eine kontrollierbare Organisationsfähigkeit, deren Nutzen, Risiko und laufende Kosten miteinander verglichen werden können.

Daten transformieren

Transformation reduziert Daten auf den Zweck. Interne IDs, Debugfelder und personenbezogene Attribute gehören nicht automatisch ins Tool-Ergebnis. Ein Ausgabeschema macht die Reduktion testbar.

Für eine belastbare Analyse von „Daten transformieren“ genügt deshalb keine Funktionsbeschreibung. Zu untersuchen sind Verantwortungsgrenze, Datenherkunft, erlaubte Zustandsänderungen, Fehlersemantik und der Nachweis, dass eine Adapterarchitektur, die bestehende Investitionen schützt und KI-gerechte Verträge ergänzt unter realen Betriebsbedingungen funktioniert. Ein Travel-Szenario sollte mindestens einen Normalfall, fehlende oder widersprüchliche Daten, einen Berechtigungsfehler und einen Ausfall des nachgelagerten Systems abdecken. Gerade bei REST-Services, SOAP-Fachverfahren, GraphQL-Plattformen und API-Gateways zeigt sich, ob das Modell nur eine überzeugende Antwort formuliert oder ob die gesamte Aufrufkette fachlich korrekt, reproduzierbar und für Betrieb sowie Revision nachvollziehbar ist.

Mehrere APIs aggregieren

Aggregation über mehrere APIs braucht ein definiertes Konsistenzmodell. Teilfehler werden sichtbar ausgewiesen. Bei Schreibvorgängen ist zu klären, ob Kompensation möglich ist oder ein Workflow die Transaktion übernehmen muss.

Methodisch sollte „Mehrere APIs aggregieren“ als überprüfbarer Vertrag behandelt werden. Das Team formuliert Vorbedingungen, Invarianten, Erfolgs- und Abbruchkriterien und ordnet jede Entscheidung einem fachlichen sowie technischen Eigentümer zu. Anschließend werden Negativtests aus blinde Eins-zu-eins-Generierung, weitergereichte interne Fehler und fehlende fachliche Aggregation abgeleitet. Für Integrationsteams, Architekten und API-Verantwortliche entsteht dadurch eine gemeinsame Bewertungsgrundlage: Architekturdiagramme erklären die Struktur, Testfälle belegen das Verhalten und Telemetrie zeigt die Qualität im laufenden Einsatz. Nur diese Verbindung erlaubt eine belastbare Aussage darüber, ob das System den angestrebten Nutzen tatsächlich und dauerhaft liefert.

Fehler übersetzen

HTTP- und SOAP-Fehler werden in fachliche, korrigierbare Resultate übersetzt. Ein 409 kann ‚Preis geändert‘ bedeuten; ein 503 ist temporär. Diese Unterscheidung steuert Nutzerhinweis und Wiederholung.

In der Reisebranche muss „Fehler übersetzen“ zusätzlich gegen volatile Preise, verteilte Bestände, personenbezogene Profile, zeitkritische Reservierungen und heterogene Anbieter geprüft werden. Ein Ergebnis kann technisch gültig und wenige Sekunden später fachlich überholt sein. Deshalb benötigen Antworten Quelle, Erhebungszeitpunkt, Gültigkeitsgrenze und gegebenenfalls einen erneuten Bestätigungsschritt. Schreibende Fähigkeiten verlangen Idempotenz, eindeutige Korrelationskennungen und einen definierten Kompensationsweg. Diese Anforderungen machen MCP nicht unnötig komplex; sie legen jene Realitäten offen, die in klassischen Integrationen häufig nur implizit im Anwendungscode verborgen bleiben.

Schrittweise Migration

Migration beginnt mit wenigen häufigen Fähigkeiten. Nutzungsdaten bestimmen weitere Adapter. Die APIs bleiben Systemverträge; MCP wird ein kuratierter Zugang – keine automatische Zweitveröffentlichung des gesamten Portfolios.

Der Reifegrad von „Schrittweise Migration“ lässt sich an konkreten Evidenzen ablesen: versionierte Verträge, dokumentierte Rechte, automatisierte Grenzfalltests, messbare Laufzeiten, strukturierte Fehler und eine verantwortete Änderungsroute. Eine Demonstration unter Idealbedingungen ist kein Produktionsnachweis. Für ein Migrationspfad vom API-Portfolio zum kuratierten Capability-Katalog muss außerdem geklärt sein, wie neue Server- oder Clientversionen eingeführt, Abhängigkeiten zurückgerollt und fehlerhafte Fähigkeiten gesperrt werden. So wird aus einer technischen Möglichkeit eine kontrollierbare Organisationsfähigkeit, deren Nutzen, Risiko und laufende Kosten miteinander verglichen werden können.

Travel-spezifisches Prüfmodell: Daten, Zustand und Verbindlichkeit

Für mcp und bestehende apis kombinieren muss die technische Betrachtung an der fachlichen Zustandsmaschine beginnen. Reiseangebote sind zeitgebundene Aussagen aus einem bestimmten Quellsystem; sie sind weder Bestand noch Buchung. Eine Order, Reservierung, ein PNR, Ticket, EMD oder Hotelaufenthalt repräsentiert jeweils andere Rechte, Fristen und Änderungsregeln. Der MCP-Vertrag muss deshalb offenlegen, welchen Zustand ein Tool liest oder verändert, welches System of Record entscheidet und ob das Ergebnis informativ, revalidiert, reserviert oder verbindlich ist. Bei REST-Services, SOAP-Fachverfahren, GraphQL-Plattformen und API-Gateways gehören Anbieter, Abrufzeitpunkt, Währung, Preisbestandteile, Gültigkeitsgrenze und Bedingungen in das strukturierte Ergebnis. Fehlen diese Angaben, kann ein sprachlich plausibler Agent fachlich nicht zwischen einer Suchantwort und einer belastbaren Transaktionsgrundlage unterscheiden.

Die Abnahme benötigt mindestens vier Testklassen: einen kontrollierten Normalfall, eine fachlich ungültige Eingabe, einen veralteten oder widersprüchlichen Backendzustand und einen Ausfall nach Beginn einer schreibenden Operation. Für Flugangebote sind etwa Offer-Ablauf und Repricing, für Hotels Rate-Plan- und Belegungsänderungen, für Bahn- und Mobilitätsdaten Feed-Aktualität, Zeitzonen und Servicekalender zu prüfen. Personen-, Profil- und Zahlungsdaten erhalten eine eigene Datenflussanalyse. Die Tests müssen nicht nur HTTP- oder JSON-RPC-Erfolg messen, sondern nachweisen, dass Identität, Objektberechtigung, Mandant, Zustimmung und tatsächlicher Backendzustand zusammenpassen.

Messbarkeit, Gegenbelege und redaktionelle Schlussfolgerung

Eine wissenschaftlich brauchbare Bewertung dokumentiert nicht nur erfolgreiche Beispiele. Sie nennt Gegenhypothesen: Eine direkte API könnte einfacher sein; eine regelbasierte Workflow-Engine könnte reproduzierbarer entscheiden; unzureichende Datenqualität könnte jeden Agentennutzen überlagern. Für ein Migrationspfad vom API-Portfolio zum kuratierten Capability-Katalog werden daher vorab Baseline und Messgrößen festgelegt. Geeignet sind Aufgabenabschluss, fachliche Korrektheit, Zahl notwendiger Nutzerkorrekturen, unzulässige Tool-Auswahl, Preis- oder Zustandsabweichungen, Latenz, Kosten pro erfolgreichem Vorgang und Wiederherstellungszeit. Ergebnisse werden nach Client-, Server-, Modell- und Backendfehler getrennt. Ohne diese Trennung lässt sich nicht feststellen, ob MCP, die Toolbeschreibung, das Modell oder das angeschlossene Reisesystem die Ursache eines Fehlers war.

Die belastbare Schlussfolgerung lautet daher weder „MCP einsetzen“ noch „MCP vermeiden“. Entscheidend ist, ob eine Adapterarchitektur, die bestehende Investitionen schützt und KI-gerechte Verträge ergänzt als begrenzter, versionierter und überprüfbarer Capability-Vertrag umgesetzt werden kann. Der Vertrag braucht einen fachlichen Owner, eine normative Protokollbasis, dokumentierte Travel-Semantik, negative Tests, ein Betriebsziel und einen Abschaltweg. Neue Protokollversionen oder Clientfunktionen werden zunächst in einer Kompatibilitätsmatrix bewertet; Release Candidates bleiben von der geltenden Spezifikation getrennt. Erst wenn Nutzen und Kontrollniveau unter realistischen Ausnahmen belegt sind, ist eine Erweiterung auf weitere Anbieter, Märkte oder schreibende Prozessschritte vertretbar.

Zwischenfragen zu MCP und bestehende APIs kombinieren

Welche Annahme ist in Ihrem Vorhaben bisher nur implizit? Wer ist für Daten, Tool-Vertrag und fachliches Ergebnis verantwortlich? Welche Aktion darf ein Agent selbständig ausführen, welche benötigt eine Bestätigung und welche bleibt grundsätzlich einem Menschen vorbehalten? Diese Fragen sind kein Hindernis für Innovation. Sie machen den späteren Betrieb erst möglich.

FAQ

Kann ein MCP-Tool mehrere APIs aufrufen?

Ja. Es kann eine fachliche Fähigkeit orchestrieren, solange Transaktion, Fehler und Berechtigungen klar definiert sind.

Was passiert mit dem API-Gateway?

Es kann weiterhin Authentifizierung, Limits und Routing übernehmen. Der MCP-Server ergänzt die KI-orientierte Semantik.

Sollten API-Schemas automatisch übernommen werden?

Sie können als Ausgangspunkt dienen, müssen aber für Nutzerabsicht, Sicherheit und Modellverständlichkeit kuratiert werden.

Primärquellen und Spezifikationen