Back to Guides

So konvertieren Sie SOAP APIs in MCP-Server

Wandeln Sie Legacy-SOAP/WSDL-Webdienste mit AnythingMCP in moderne MCP-Server um. Verbinden Sie Enterprise-SOAP-APIs mit KI-Agenten, ohne etwas neu zu schreiben.

Warum SOAP APIs nach wie vor wichtig sind

Trotz des Aufstiegs von REST und GraphQL bleiben SOAP-Webdienste das Rückgrat der Unternehmens-IT. Banken, Versicherungen, Gesundheitsdienstleister und Behörden verlassen sich auf Millionen von SOAP-Endpunkten, die kritische Geschäftsprozesse antreiben.

Das Problem? KI-Agenten sprechen MCP, nicht SOAP. Bisher erforderte die Verbindung von KI mit diesen Legacy-Systemen individuelle Middleware, monatelange Entwicklung und tiefes SOAP-Fachwissen.

AnythingMCP: SOAP zu MCP in Minuten

AnythingMCP parst automatisch WSDL-Definitionen, bildet SOAP-Operationen auf MCP-Tools ab und übernimmt die gesamte XML-Serialisierung und -Deserialisierung im Hintergrund.

Schritt-für-Schritt-Anleitung

Schritt 1: AnythingMCP bereitstellen

Klonen Sie das Repository und starten Sie die Anwendung mit Docker Compose:

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Dies startet PostgreSQL, die Backend-API (Port 4000) und das Dashboard (Port 3000).

Schritt 2: SOAP-Connector erstellen

Öffnen Sie das AnythingMCP-Dashboard unter http://localhost:3000 und erstellen Sie einen neuen SOAP-Connector. Geben Sie die WSDL-URL Ihres Dienstes an — AnythingMCP parst sie automatisch und erkennt alle verfügbaren Operationen.

Schritt 3: Automatisches WSDL-Parsing

AnythingMCP liest Ihre WSDL und führt automatisch folgende Schritte aus:

  • Erkennt alle SOAP-Operationen (z. B. getOrder, createInvoice, updateCustomer)
  • Bildet komplexe XML-Typen auf strukturierte MCP-Tool-Parameter ab
  • Generiert menschenlesbare Beschreibungen für KI-Agenten
  • Behandelt SOAP-Envelopes, Header und Namespaces transparent

Schritt 4: Authentifizierung konfigurieren

Konfigurieren Sie in den Connector-Einstellungen die Authentifizierung für Ihren SOAP-Dienst. AnythingMCP unterstützt WS-Security, Basic Auth und benutzerdefinierte SOAP-Header. Umgebungsvariablen können zur sicheren Speicherung von Anmeldedaten verwendet werden.

Schritt 5: Tool-Zuordnung anpassen

Im Dashboard können Sie überprüfen, welche Operationen bereitgestellt werden, und anpassen, wie sie KI-Agenten angezeigt werden. Sie können Tools umbenennen, Beschreibungen verbessern und gefährliche Operationen ausschließen.

Schritt 6: Testen und verbinden

Verwenden Sie die integrierte Testoberfläche, um jede SOAP-Operation direkt vom Dashboard aus aufzurufen. Konfigurieren Sie dann Ihren MCP-Client:

{
  "mcpServers": {
    "my-soap-service": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Häufige Enterprise-SOAP-Anwendungsfälle

| SOAP-Dienst | Generiertes MCP-Tool | KI-Agenten-Anwendungsfall | |---|---|---| | SAP RFC/BAPI | get_material_details | „Bestand für Teil X nachschlagen" | | Oracle EBS | create_purchase_order | „Bestellung für 100 Einheiten erstellen" | | Healthcare HL7 | get_patient_record | „Patientenhistorie abrufen" | | Banking Core | get_account_balance | „Kontostand prüfen" | | Insurance Claims | submit_claim | „Neuen Versicherungsanspruch einreichen" |

Umgang mit komplexen XML-Typen

SOAP APIs verwenden häufig tief verschachtelte XML-Strukturen. AnythingMCP flacht diese zu intuitiven JSON-Parametern ab, mit denen KI-Agenten einfach arbeiten können.

Best Practices

  1. Schreibgeschützt beginnen — Stellen Sie zuerst Abfrageoperationen bereit, dann fügen Sie Schreiboperationen hinzu
  2. WS-Security verwenden — Übertragen Sie Anmeldedaten niemals im Klartext
  3. Mit Ihrer WSDL testen — Überprüfen Sie, ob die WSDL vom AnythingMCP-Server erreichbar ist
  4. Ratenbegrenzung — SOAP-Dienste haben häufig strikte Ratenlimits; konfigurieren Sie entsprechend

Nächste Schritte