sap-sd-mcp-validation

# 🤖 SAP SD Order Validation Agent — MCP Protocol

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

🎯 ¿Qué hace este proyecto?

Un agente de inteligencia artificial que valida órdenes de venta SAP SD (Order-to-Cash) antes de impactar el ERP, utilizando el Model Context Protocol (MCP) de Anthropic como capa de comunicación entre Claude/Joule y SAP S/4HANA Cloud Public Edition.

El problema que resuelve

En SAP SD, los errores de pricing, crédito y disponibilidad de material generan correcciones manuales costosas:

Related MCP server: SAP OData to MCP Server

🏗️ Arquitectura Clean Core

Usuario / Comprador
        ↓
   MCP Client
(Our Server / App)
        ↓
  SAP SD MCP Server         ← Este repositorio
  (sap_sd_server.py)
        ↓                         ↓
  Claude / Joule         S/4HANA Cloud API
     Agent               (API_SALES_ORDER_SRV)

Principio Clean Core: Toda la lógica de validación corre en la periferia del ERP a través de MCP. El core de SAP S/4HANA no es modificado — extensibilidad 100% vía BTP.

🛠️ Tools expuestas al agente

Resources disponibles

• sap://materials — Catálogo de materiales

• sap://customers — Maestro de clientes

• sap://orders — Órdenes creadas en sesión

Prompt pre-configurado

• validate_full_order — Orquesta el flujo completo O2C con auditoría

🚀 Cómo probarlo

Opción A — Google Colab (recomendado, sin instalación)

1. Haz clic en el badge Open In Colab al inicio de este README

2. Ve al panel izquierdo → ícono 🔑 Secrets → agrega ANTHROPIC_API_KEY

3. Menú → Ejecutar todo

Opción B — Local

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

# Crear entorno virtual
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Instalar dependencias
pip install -r requirements.txt

# Configurar API key
echo "ANTHROPIC_API_KEY=sk-ant-tu-key" > .env

# Correr el servidor MCP directamente
python sap_sd_server.py

🧪 Casos de prueba incluidos

📋 Audit Log integrado

Cada llamada del agente queda registrada con trazabilidad completa:

[1] 2026-06-18T10:30:01
    Evento : TOOL_CALL
    Tool   : validate_material_number
    Input  : {"material_id": "MAT-1001"}
    Output : {"stock_disponible": 42, "disponible": true}

[2] 2026-06-18T10:30:02
    Evento : TOOL_CALL
    Tool   : check_pricing_conditions
    Input  : {"material_id": "MAT-1001", "quantity": 5}
    Output : {"total_price_usd": 6250.0}

🗺️ Roadmap

🔗 Alineación con SAP Roadmap oficial

Este proyecto anticipa funcionalidades del SAP S/4HANA Cloud release 2608 (Q3 2026):

• AI-assisted sales order creation from unstructured data — SAP Road Map Explorer

• Autonomous Enterprise agents for O2C processes — SAP Sapphire 2026

📁 Estructura del repositorio

sap-sd-mcp-validation/
│
├── .gitignore                          # Excluye .env, __pycache__, .venv
├── requirements.txt                    # Dependencias Python
├── sap_sd_server.py                    # Servidor MCP SAP SD (FastMCP)
├── SAP_SD_MCP_Agent_Fabian_Acevedo.ipynb  # Notebook Colab interactivo
└── README.md                           # Este archivo

🤝 Sobre el autor

SAP Certified Implementation Consultant (C_S4CPB_2602) y SAP Certified Build Developer (C_LCNC_2601). Especializado en SAP BTP, Clean Core extensibility, y automatización de procesos O2C con IA.

Open to remote SAP consulting roles — LATAM / Global (EST/CST)