SAP Business One Order-to-Cash MCP 서버

이 프로젝트는 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

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에 연결합니다.

• 세션 쿠키는 로그인이 만료되면 자동으로 갱신됩니다.

• 송장 및 결제 도구는 실시간 전기 작업으로 구현되어 있으므로, 에이전트 워크플로에 사람의 승인 단계를 유지하는 것이 좋습니다.

• 일부 조직에서는 운송업체, POD 및 승인 메타데이터를 사용자 정의 필드에 저장합니다. 이 스캐폴드는 SAP B1 테넌트 간 이식성을 유지하기 위해 기본적으로 이러한 참조를 문서 주석에 저장합니다.

일반적인 문제

• UNABLE_TO_VERIFY_LEAF_SIGNATURE: 자체 서명된 SAP 인증서의 경우 NODE_TLS_REJECT_UNAUTHORIZED=0을 설정하세요.

• SAP B1 login failed: 기본 URL, 회사 DB, 사용자 및 비밀번호를 확인하세요.

• ECONNREFUSED: Service Layer가 실행 중이고 연결 가능한지 확인하세요.

• Cannot find module: npm install 및 npm run build를 실행하세요.

• MCP 도구가 표시되지 않는 경우: Claude MCP 구성의 절대 경로를 확인하세요.