SAP Business One Order-to-Cash MCP Server

このプロジェクトは、SAP Business One Service Layer の操作を Model Context Protocol (MCP) ツールとして公開し、Claude などのエージェントが stdio 経由で Order-to-Cash フロー全体を実行できるようにします。

含まれるもの

• Node.js + TypeScript 製 MCP サーバー

• セッションクッキー認証方式の SAP Business One 認証（期限切れ時の自動再ログイン対応）

• 見積から回収までをカバーする 9 つの O2C ツール

• .env による設定管理

Related MCP server: SAP Business One MCP Server

プロジェクト構成

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

ツール

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

環境設定

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

NODE_TLS_REJECT_UNAUTHORIZED=0 は、SAP Business One Service Layer が自己署名証明書を使用している場合にのみ設定してください。

インストール

npm install

ビルド

npm run build

実行

node dist/server.js

想定される起動ログ:

SAP B1 MCP server running (stdio)

Claude Desktop MCP 設定

{
  "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"
      }
    }
  }
}

注意事項

• サーバーは Service Layer REST API を介して SAP Business One に接続します。

• セッションクッキーは、ログインの有効期限が切れると自動的に更新されます。

• 請求書および支払いツールは実際に転記を行う操作として実装されているため、エージェントのワークフローに人間による承認ステップを残しておくことをお勧めします。

• 一部の組織では、運送会社、POD、承認メタデータをユーザー定義フィールドに保存しています。このスキャフォールドは、SAP B1 テナント間での可搬性を保つために、デフォルトではこれらの参照を伝票コメントに保存します。

よくある問題

• UNABLE_TO_VERIFY_LEAF_SIGNATURE: 自己署名の SAP 証明書には NODE_TLS_REJECT_UNAUTHORIZED=0 を設定してください

• SAP B1 login failed: ベース URL、会社データベース、ユーザー、パスワードを確認してください

• ECONNREFUSED: Service Layer が実行中で到達可能であることを確認してください

• Cannot find module: npm install と npm run build を実行してください

• MCP ツールが表示されない: Claude MCP 設定の絶対パスを確認してください