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 会话 Cookie 进行身份验证，并在过期时自动重新登录

• 涵盖从报价到收款的 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

仅当你的 SAP Business One Service Layer 使用自签名证书时，才设置 NODE_TLS_REJECT_UNAUTHORIZED=0。

安装

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。

• 登录过期时会话 Cookie 会自动更新。

• 发票和付款工具是作为实时过账操作实现的，因此在智能体工作流中保留人工审批步骤是个好主意。

• 一些组织将承运人、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 配置中的绝对路径。