SAP Business One Order-to-Cash MCP Server

Dieses Projekt stellt Operationen des SAP Business One Service Layer als Tools auf Basis des Model Context Protocol (MCP) bereit, sodass ein Agent wie Claude den vollständigen Order-to-Cash-Ablauf über stdio ausführen kann.

Was ist enthalten

• Node.js + TypeScript MCP-Server

• SAP Business One Session-Cookie-Authentifizierung mit automatischer erneuter Anmeldung bei Ablauf

• 9 O2C-Tools, die vom Angebot bis zum Inkasso reichen

• .env-gesteuerte Konfiguration

Related MCP server: SAP Business One MCP Server

Projektstruktur

sap-b1-mcp-server/
|- src/
|  \- server.ts
|- dist/
|- .env
|- .env.example
|- package.json
|- tsconfig.json
\- README.md

Tools

1. create_sales_quotation

2. create_sales_order

3. check_atp

4. create_delivery

5. get_pick_list

6. confirm_delivery_pod

7. create_ar_invoice

8. apply_incoming_payment

9. get_collections_worklist

Umgebung

SAP_B1_BASE_URL=https://your-sap-server:50000/b1s/v1
SAP_B1_COMPANY=SBODemoUS
SAP_B1_USER=manager
SAP_B1_PASSWORD=yourpassword
NODE_TLS_REJECT_UNAUTHORIZED=0

Setzen Sie NODE_TLS_REJECT_UNAUTHORIZED=0 nur, wenn der SAP Business One Service Layer ein selbstsigniertes Zertifikat verwendet.

Installation

npm install

Build

npm run build

Ausführen

node dist/server.js

Erwartetes Startprotokoll:

SAP B1 MCP server running (stdio)

Claude Desktop MCP-Konfiguration

{
  "mcpServers": {
    "sap-b1-o2c": {
      "command": "node",
      "args": ["/absolute/path/to/dist/server.js"],
      "env": {
        "SAP_B1_BASE_URL": "https://your-server:50000/b1s/v1",
        "SAP_B1_COMPANY": "SBODemoUS",
        "SAP_B1_USER": "manager",
        "SAP_B1_PASSWORD": "yourpassword"
      }
    }
  }
}

Hinweise

• Der Server verbindet sich über die REST-API des Service Layer mit SAP Business One.

• Session-Cookies werden automatisch erneuert, wenn die Anmeldung abläuft.

• Die Rechnungs- und Zahlungstools sind als Live-Buchungsvorgänge implementiert. Daher ist es sinnvoll, in Ihrem Agent-Workflow einen Schritt für die Freigabe durch einen Menschen vorzusehen.

• Einige Organisationen speichern Metadaten zu Spediteur, POD und Genehmigung in benutzerdefinierten Feldern. Dieses Grundgerüst speichert diese Referenzen standardmäßig in Dokumentkommentaren, um über SAP-B1-Mandanten hinweg portabel zu bleiben.

Häufige Probleme

• UNABLE_TO_VERIFY_LEAF_SIGNATURE: Setzen Sie NODE_TLS_REJECT_UNAUTHORIZED=0 bei selbstsignierten SAP-Zertifikaten

• SAP B1 login failed: Überprüfen Sie Basis-URL, Unternehmensdatenbank, Benutzername und Passwort

• ECONNREFUSED: Stellen Sie sicher, dass der Service Layer läuft und erreichbar ist

• Cannot find module: Führen Sie npm install und npm run build aus

• MCP-Tools werden nicht angezeigt: Überprüfen Sie den absoluten Pfad in Ihrer Claude-MCP-Konfiguration