AnythingMCP
Back to Guides

Come Convertire le API SOAP in Server MCP

Trasforma i servizi web SOAP/WSDL legacy in server MCP moderni utilizzando AnythingMCP. Collega le API SOAP aziendali agli agenti AI senza riscrivere nulla.

Perché le API SOAP Sono Ancora Importanti

Nonostante l'ascesa di REST e GraphQL, i servizi web SOAP rimangono la colonna portante dell'IT aziendale. Banche, compagnie assicurative, fornitori di servizi sanitari e agenzie governative si affidano a milioni di endpoint SOAP che alimentano processi aziendali critici.

Il problema? Gli agenti AI parlano MCP, non SOAP. Fino ad ora, collegare l'AI a questi sistemi legacy richiedeva middleware personalizzato, mesi di sviluppo e una profonda competenza in SOAP.

AnythingMCP: Da SOAP a MCP in Pochi Minuti

AnythingMCP analizza automaticamente le definizioni WSDL, mappa le operazioni SOAP sugli strumenti MCP e gestisce tutta la serializzazione e deserializzazione XML dietro le quinte.

Guida Passo dopo Passo

Passo 1: Distribuire AnythingMCP

Clonare il repository e avviare l'applicazione con Docker Compose:

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

Questo avvia PostgreSQL, l'API backend (porta 4000) e la dashboard (porta 3000).

Passo 2: Creare un Connettore SOAP

Aprire la dashboard di AnythingMCP all'indirizzo http://localhost:3000 e creare un nuovo connettore SOAP. Fornire l'URL WSDL del proprio servizio — AnythingMCP lo analizzerà automaticamente e scoprirà tutte le operazioni disponibili.

Passo 3: Analisi Automatica del WSDL

AnythingMCP legge il WSDL e automaticamente:

  • Scopre tutte le operazioni SOAP (ad es., getOrder, createInvoice, updateCustomer)
  • Mappa i tipi XML complessi in parametri strutturati per gli strumenti MCP
  • Genera descrizioni leggibili per gli agenti AI
  • Gestisce envelope SOAP, intestazioni e namespace in modo trasparente

Passo 4: Configurare l'Autenticazione

Nelle impostazioni del connettore, configurare l'autenticazione per il proprio servizio SOAP. AnythingMCP supporta WS-Security, autenticazione Basic e intestazioni SOAP personalizzate. Le variabili d'ambiente possono essere utilizzate per memorizzare le credenziali in modo sicuro.

Passo 5: Personalizzare la Mappatura degli Strumenti

Nella dashboard, revisionare quali operazioni esporre e personalizzare come appaiono agli agenti AI. È possibile rinominare gli strumenti, migliorare le descrizioni ed escludere le operazioni pericolose.

Passo 6: Testare e Collegare

Utilizzare l'interfaccia di test integrata per chiamare ogni operazione SOAP direttamente dalla dashboard. Quindi configurare il proprio client MCP:

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

Casi d'Uso Comuni SOAP Aziendali

| Servizio SOAP | Strumento MCP Generato | Caso d'Uso Agente AI | |---|---|---| | SAP RFC/BAPI | get_material_details | "Cerca l'inventario per il pezzo X" | | Oracle EBS | create_purchase_order | "Crea un OdA per 100 unità" | | Sanità HL7 | get_patient_record | "Recupera la storia clinica del paziente" | | Core Bancario | get_account_balance | "Verifica lo stato del conto" | | Sinistri Assicurativi | submit_claim | "Presenta un nuovo sinistro assicurativo" |

Gestione dei Tipi XML Complessi

Le API SOAP spesso utilizzano strutture XML profondamente nidificate. AnythingMCP le appiattisce in parametri JSON intuitivi con cui gli agenti AI possono lavorare facilmente.

Buone Pratiche

  1. Iniziare in sola lettura — Esporre prima le operazioni di interrogazione, poi aggiungere le operazioni di scrittura
  2. Utilizzare WS-Security — Non trasmettere mai le credenziali in testo semplice
  3. Testare con il proprio WSDL — Verificare che il WSDL sia accessibile dal server AnythingMCP
  4. Limitazione delle richieste — I servizi SOAP hanno spesso limiti di frequenza rigorosi; configurare di conseguenza

Prossimi Passi