🤖 SAP SD MCP Validation Agent

SAP Clean Core AI Agent — Order-to-Cash Automation via MCP Protocol

Autor: Fabian Andrés Acevedo R. | Bogotá, Colombia
Certificaciones: C_S4CPB_2602 · C_LCNC_2601
LinkedIn: linkedin.com/in/fabian-acevedo-sap-cloud-data

🎯 El Problema

En entornos SAP SD, la validación manual de pedidos de venta introduce fricciones críticas:

• Consultores SD deben verificar manualmente stock, pricing y crédito del cliente antes de crear cada orden.

• Pedidos rechazados en etapas tardías del proceso generan reprocesos costosos.

• La escalación de crédito a aprobadores depende de flujos manuales o correo electrónico.

Resultado: ciclos Order-to-Cash lentos, errores humanos y carga administrativa en el equipo de ventas.

Related MCP server: mcp4odata

✅ La Solución

Un agente de IA conversacional que, vía Model Context Protocol (MCP), conecta a Claude con las reglas de negocio SAP SD — validando materiales, precios y crédito de cliente en tiempo real, antes de crear el pedido, y escalando automáticamente a SAP Build Process Automation cuando se detecta crédito insuficiente.

Usuario (lenguaje natural)
        ↓
   MCP Client (Claude claude-sonnet-4-6)
        ↓
   SAP SD MCP Server (FastMCP)
   ├── validate_material_number()    → Catálogo S/4HANA
   ├── check_pricing_conditions()    → Pricing SD
   ├── verify_customer_credit_limit()→ Credit Management
   └── create_sales_order()          → Pedido de venta
        ↓
   SAP Build Process Automation      → Escalación de crédito (XSUAA / OAuth2)
        ↓
   S/4HANA Core  ←  Clean Core ✅ (sin modificaciones al núcleo)

Filosofía: Este agente opera en la periferia del ecosistema SAP — nunca modifica el núcleo ERP. Respeta el principio Clean Core usando únicamente APIs estándar (API_SALES_ORDER_SRV) y servicios BTP.

🏗️ Arquitectura

⚡ Demo — Casos de prueba validados

🚀 Instalación y uso

Prerrequisitos

• Python 3.10+

• Cuenta en Anthropic Console con API Key

Configuración

# 1. Clonar el repositorio
git clone https://github.com/fabianacevedo9006/sap-sd-mcp-validation.git
cd sap-sd-mcp-validation

# 2. Instalar dependencias
pip install -r requirements.txt

# 3. Configurar variables de entorno (ver .env.example)
cp .env.example .env
# Editar .env con tus credenciales

.env.example:

ANTHROPIC_API_KEY=
BTP_TOKEN_URL=
BTP_API_BASE_URL=
BTP_CLIENT_ID=
BTP_CLIENT_SECRET=

Ejecución (Google Colab)

Abre SAP_SD_MCP_Agent_Colab.ipynb en Google Colab y ejecuta las celdas en orden. El notebook guía el proceso completo en ~3 minutos.

📈 Valor de negocio

• Reducción de carga administrativa en el departamento de ventas — el agente valida en segundos lo que antes requería múltiples consultas manuales en SAP GUI.

• Trazabilidad completa: cada tool call queda registrada en el audit_log con timestamp, input y output — cumpliendo estándares de auditoría SAP.

• Escalación automática: pedidos con crédito insuficiente disparan un workflow en SAP Build Process Automation sin intervención manual.

• Clean Core garantizado: cero modificaciones al núcleo ERP — arquitectura certificable bajo SAP Clean Core Assessment.

🗺️ Roadmap

🔗 Contexto SAP Discovery Mission

Este proyecto forma parte de la misión SAP Discovery Center:
"Soporte fundamental para iniciar la automatización de procesos a través de SAP Build"

Demuestra la fase Adopt de SAP Activate: configuración de SAP Build Process Automation integrada con un agente IA de periferia, respetando el modelo Clean Core de SAP S/4HANA Cloud Public Edition.

📄 Licencia

MIT — ver LICENSE

Tags: sap-btp · gen-ai · mcp-protocol · s4hana-cloud · clean-core · order-to-cash · sap-build · process-automation