Servidor MCP de SAP Business One Order-to-Cash

Este proyecto expone las operaciones de SAP Business One Service Layer como herramientas del Model Context Protocol (MCP), de modo que un agente como Claude pueda ejecutar el flujo completo de Order-to-Cash a través de stdio.

Qué incluye

• Servidor MCP de Node.js + TypeScript

• Autenticación de SAP Business One mediante cookie de sesión con reautenticación automática al expirar

• 9 herramientas O2C que cubren el proceso desde cotización hasta cobros

• Configuración basada en .env

Related MCP server: SAP Business One MCP Server

Estructura del proyecto

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

Herramientas

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

Variables de entorno

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

Establece NODE_TLS_REJECT_UNAUTHORIZED=0 únicamente cuando tu instancia de SAP Business One Service Layer utilice un certificado autofirmado.

Instalación

npm install

Compilación

npm run build

Ejecución

node dist/server.js

Registro de inicio esperado:

SAP B1 MCP server running (stdio)

Configuración de MCP de 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"
      }
    }
  }
}

Notas

• El servidor se conecta a SAP Business One a través de la API REST de Service Layer.

• Las cookies de sesión se renuevan automáticamente cuando el inicio de sesión expira.

• Las herramientas de factura y pago están implementadas como operaciones de contabilización en vivo, por lo que es recomendable mantener un paso de aprobación humana en el flujo de trabajo de tu agente.

• Algunas organizaciones almacenan transportista, POD y metadatos de aprobación en campos definidos por el usuario. Este andamiaje almacena esas referencias en los comentarios del documento por defecto para mantener la portabilidad entre los inquilinos de SAP B1.

Problemas comunes

• UNABLE_TO_VERIFY_LEAF_SIGNATURE: establece NODE_TLS_REJECT_UNAUTHORIZED=0 para certificados SAP autofirmados

• SAP B1 login failed: verifica la URL base, la base de datos de la compañía, el usuario y la contraseña

• ECONNREFUSED: confirma que el Service Layer está en ejecución y es accesible

• Cannot find module: ejecuta npm install y npm run build

• Las herramientas MCP no aparecen: verifica la ruta absoluta en tu configuración de MCP de Claude