SAP Business One MCP Server

SAP Business One MCP Server

Servidor MCP (Model Context Protocol) para integrar SAP Business One con Microsoft Copilot Studio.

##Características

-## Configuración

1. Variables de Entorn## Despliegue en AzureConexión ## Integración con Copilot St## Pruebas del Protocolo MCPdioersistente*## Estructura del Proyecto a SAP Business## TroubleshootingOne Service Layer API

• Creación de Sales Orders con validación completa

• Protocolo MCP Streamable compatible con Microsoft Copilot Studio

• Deployment en Azure Container Apps listo para producción

##Herramientas Disponibles

1. sap_connect - Conectar a SAP Business One

2. sap_status - Verificar estado de conexión

3. sap_create_sales_order - Crear Sales Orders

##Requisitos

• Python 3.11+

• SAP Business One con Service Layer habilitado

• Variables de entorno configuradas

##Configuración

1. Copiar .env.example a .env:

2. Configurar variables de entorno en .env:

3. Instalar dependencias:

4. Ejecutar servidor:

##Integración con Microsoft Copilot Studio

###1. Schema File Usar sap-mcp-schema.yaml como archivo de schema OpenAPI en Copilot Studio.

###2. Crear Custom Connector

1. En Copilot Studio, ir a Tools → Add a tool → New tool → Custom connector

2. Seleccionar Import OpenAPI file

3. Subir el archivo sap-mcp-schema.yaml

4. Completar la configuración siguiendo la documentación oficial

###3. Configurar Host Actualizar el host en sap-mcp-schema.yaml:

• Para desarrollo local: localhost:8000

• Para producción: your-domain.azurecontainerapps.io

##Deployment

###Azure Container Apps

1. Configurar variables de entorno en Azure:

2. Deploy usando el script:

###Docker

##Ejemplo de Uso

###Crear Sales Order

###Respuesta

##Health Check

##Licencia

MIT License

##Contribuir

1. Fork el proyecto

2. Crear feature branch (git checkout -b feature/AmazingFeature)

3. Commit cambios (git commit -m 'Add some AmazingFeature')

4. Push to branch (git push origin feature/AmazingFeature)

5. Abrir Pull Request

##Objetivo

Exponer herramientas de SAP Business One Service Layer API mediante el protocolo MCP streamable para que Microsoft Copilot Studio pueda consumirlas como un custom connector.

##Arquitectura

##� Características

###Herramientas MCP Disponibles

• sap_connect: Conectar a SAP Business One

• sap_status: Verificar estado de conexión

• sap_create_sales_order: Crear Sales Orders con validación completa

###Recursos MCP Disponibles

• sap://status: Estado actual de la conexión SAP

###Endpoints HTTP

• POST /mcp: Endpoint principal para protocolo MCP streamable

• GET /health: Verificación de salud del servidor

##🛠️ Configuración

###1. Variables de Entorno

Crea un archivo .env basado en .env.example:

Completa las variables:

###2. Desarrollo Local

El servidor estará disponible en http://localhost:8000

###3. Probar Localmente

##☁️ Despliegue en Azure

###Prerequisitos

• Azure CLI instalado y configurado

• Azure Container Registry creado

• Permisos para crear Container Apps

###Despliegue Automatizado

###Configurar Secrets en Azure

##🔌 Integración con Copilot Studio

###1. Crear Custom Connector

1. Ir a Power Platform Admin Center

2. Seleccionar Custom Connectors → New custom connector → Import from OpenAPI file

3. Subir el archivo sap-mcp-schema.yaml

4. Configurar la URL del host con tu Container App:

   https://app-sap-mcp-test.bravewater-b67ade29.eastus.azurecontainerapps.io

###2. Configurar en Copilot Studio

1. Abrir Copilot Studio

2. Ir a Settings → Generative AI → Custom Actions

3. Agregar el custom connector creado

4. Las herramientas SAP aparecerán automáticamente como acciones disponibles

###3. Ejemplo de Uso en Copilot

##🧪 Pruebas del Protocolo MCP

###Ejemplo de Solicitud MCP

###Ejemplo de Respuesta MCP

##📁 Estructura del Proyecto

Desarrollo

###Agregar Nueva Herramienta

1. Definir en handle_list_tools():

2. Implementar en handle_call_tool():

##🔍 Troubleshooting

###Problemas Comunes

1. Error de conexión SAP:

   • Verificar variables de entorno

   • Comprobar conectividad de red

   • Validar credenciales

2. Container App no responde:

   • Verificar logs: az containerapp logs show --name app-sap-mcp --resource-group rg-mcp-sap

   • Comprobar variables de entorno en Azure

3. Copilot Studio no encuentra herramientas:

   • Verificar schema OpenAPI

   • Comprobar URL del host en custom connector

   • Validar protocolo mcp-streamable-1.0

###Logs y Debugging

Referencias

• Model Context Protocol (MCP)

• SAP Business One Service Layer API

• Microsoft Copilot Studio Custom Connectors

• Azure Container Apps

Contribución

1. Fork el repositorio

2. Crear rama feature: git checkout -b feature/nueva-caracteristica

3. Commit cambios: git commit -am 'Agregar nueva característica'

4. Push a la rama: git push origin feature/nueva-caracteristica

5. Crear Pull Request

##📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver archivo LICENSE para más detalles.

##🆘 Soporte

• Issues: GitHub Issues

• Documentación: Wiki del proyecto

• Contacto: Crear un issue para soporte técnico --secrets "sap-username=tu-usuario" "sap-password=tu-password"

###Configurar NSG para SAP

##📊 Verificación

###Ver logs de la aplicación

###Verificar conectividad

##🔐 Seguridad

###Variables de entorno configuradas:

• SAP_BASE_URL: URL de tu SAP Business One API

• SAP_COMPANY_DB: Base de datos de la compañía

• SAP_USERNAME: Usuario SAP

• SAP_PASSWORD: Contraseña SAP (almacenada como secreto)

###Mejores prácticas:

• Credenciales almacenadas como secretos de Container Apps

• VNet isolation para comunicación privada con SAP

• Contenedor ejecutándose con usuario no-root

• Recursos limitados (CPU/Memory)

##🛠️ Troubleshooting

###Error de conectividad a SAP

1. Verificar que SAP esté ejecutándose

2. Verificar NSG rules

3. Verificar que las IPs sean correctas

4. Verificar credenciales

###Error de despliegue

1. Verificar permisos en Azure

2. Verificar que el nombre del Container Registry sea único

3. Verificar que la VNet exista

###Ver logs detallados

##📞 Soporte

Para problemas específicos:

1. Revisar logs de Container Apps

2. Verificar conectividad de red

3. Probar credenciales SAP desde Postman

4. Verificar configuración de secretos

##🔄 Actualizaciones

Para actualizar la aplicación: