SAP Business One Order-to-Cash MCP Server

Этот проект предоставляет операции SAP Business One Service Layer как инструменты Model Context Protocol (MCP), чтобы агент, такой как Claude, мог выполнять полный процесс Order-to-Cash через stdio.

Что входит

• MCP-сервер на Node.js + TypeScript

• аутентификация SAP Business One на основе session-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

Устанавливайте 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)

Конфигурация MCP для Claude Desktop

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

Примечания

• Сервер подключается к SAP Business One через REST API Service Layer.

• Сессионные cookie автоматически обновляются по истечении срока входа.

• Инструменты для счетов и платежей реализованы как операции live posting, поэтому в рабочий процесс вашего агента стоит включить шаг проверки человеком.

• Некоторые организации хранят метаданные перевозчика, POD и утверждений в пользовательских полях. Эта заготовка по умолчанию сохраняет эти ссылки в комментариях документа, чтобы сохранить переносимость между тенантами SAP B1.

Распространённые проблемы

• UNABLE_TO_VERIFY_LEAF_SIGNATURE: установите NODE_TLS_REJECT_UNAUTHORIZED=0 для самозаверяющих сертификатов SAP

• SAP B1 login failed: проверьте базовый URL, базу данных компании, пользователя и пароль

• ECONNREFUSED: убедитесь, что Service Layer запущен и доступен

• Cannot find module: выполните npm install и npm run build

• инструменты MCP не отображаются: проверьте абсолютный путь в вашей конфигурации MCP для Claude Desktop