Business Central MCP 智能体构建工作坊

🤖 Workshop: Construye un Agente de IA con Business Central MCP

Recorrido mínimo y límites

Este repo contiene guías por módulos, un portal index.html y una solución de referencia; no instala por sí solo un servidor ni un agente. Necesitas tu BC online, Copilot Studio y permisos para configurar la conexión. Empieza por preparación, configura BC en el módulo 02 y crea/conecta el agente en los módulos 03–04.

Como primera comprobación, descubre herramientas y lee clientes de tu sandbox. Las operaciones de creación/modificación son ejercicios posteriores: requieren habilitación expresa en la configuración MCP y permisos efectivos; no están garantizadas por tener conexión. Registra la consulta y su respuesta real. La documentación oficial consultada el 6 de octubre de 2026 distingue configuración de APIs, descubrimiento dinámico y permisos por operación.

Revisión estática: 6 de octubre de 2026. No se ha conectado Copilot Studio ni ejecutado el workshop; las versiones, capturas y nombres de herramientas de la edición deben contrastarse con tu entorno.

Conecta Microsoft Copilot Studio con datos en vivo de Business Central usando Model Context Protocol

📋 Descripción

Este workshop te guía paso a paso para construir un agente de IA conversacional que se conecta en tiempo real a datos de Business Central usando el protocolo MCP (Model Context Protocol).

Inspirado en: Microsoft Copilot Studio Labs - Contoso Agent with Dataverse MCP

Adaptado para: Microsoft Dynamics 365 Business Central

🎯 ¿Qué Vas a Construir?

Un agente llamado "Contoso BC Assistant" que puede:

Todo esto usando lenguaje natural y con datos en vivo de Business Central.

🏗️ Arquitectura

┌─────────────────────────────────────────────────────────────┐
│                    Usuario Final                             │
│         (Teams, Web, M365 Copilot, Custom App)              │
└─────────────────────┬───────────────────────────────────────┘
                      │ Lenguaje Natural
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                 Microsoft Copilot Studio                     │
│    ┌─────────────────────────────────────────────────┐      │
│    │              Contoso BC Assistant                │      │
│    │  • Instrucciones del agente                      │      │
│    │  • Orquestación generativa                       │      │
│    │  • Flujos de conversación                        │      │
│    └─────────────────────┬───────────────────────────┘      │
└─────────────────────────┬───────────────────────────────────┘
                          │ MCP Protocol
                          ▼
┌─────────────────────────────────────────────────────────────┐
│           Business Central MCP Server                        │
│    ┌─────────────────────────────────────────────────┐      │
│    │              Herramientas (Tools)                │      │
│    │  • bc_customers_read                             │      │
│    │  • bc_items_read                                 │      │
│    │  • bc_salesOrders_read/create                    │      │
│    │  • bc_salesInvoices_read                         │      │
│    │  • bc_vendors_read                               │      │
│    │  • bc_actions_search (modo dinámico)             │      │
│    └─────────────────────┬───────────────────────────┘      │
└─────────────────────────┬───────────────────────────────────┘
                          │ OData / API
                          ▼
┌─────────────────────────────────────────────────────────────┐
│            Microsoft Dynamics 365 Business Central           │
│                                                              │
│    Clientes │ Artículos │ Pedidos │ Facturas │ Proveedores  │
└─────────────────────────────────────────────────────────────┘

📚 Módulos del Workshop

Duración total: ~3.5 horas

✅ Prerequisitos

Licencias y Acceso

• [ ] Licencia de Business Central (Essential o Premium)
• [ ] Licencia de Copilot Studio con capacidad disponible
• [ ] Acceso de administrador al entorno de BC (para configurar MCP Server)
• [ ] Cuenta Microsoft 365 en el mismo tenant que Business Central
• [ ] (Opcional) Licencia Microsoft 365 Copilot para usuarios finales si se despliega en ese canal

Conocimientos Previos

• [ ] Familiaridad básica con Business Central
• [ ] Conceptos básicos de APIs REST
• [ ] No se requiere experiencia previa con IA/MCP

Entorno Técnico

• [ ] Business Central versión 27 (2025 release wave 2) o superior
• [ ] Feature Management: "Feature: Enable MCP Server access" activado en BC
• [ ] Navegador moderno (Microsoft Edge o Chrome)
• [ ] Acceso a copilotstudio.microsoft.com

🚀 Inicio Rápido

Opción A: Seguir los módulos en orden (recomendado)

# Empezar desde el principio
→ modulo-00-preparacion/README.md

Opción B: Ya tengo BC MCP configurado

# Saltar a crear el agente
→ modulo-03-crear-agente/README.md

Opción C: Solo quiero ver el resultado final

# Ver el agente completado
→ solucion-completa/README.md

🎯 Escenarios de Negocio

Escenario 1: Asistente de Ventas

El agente ayuda al equipo de ventas a:

• Consultar información de clientes rápidamente
• Verificar disponibilidad de artículos
• Revisar pedidos pendientes
• Comprobar límites de crédito

Escenario 2: Asistente de Compras

El agente ayuda al equipo de compras a:

• Buscar proveedores por artículo
• Revisar órdenes de compra pendientes
• Consultar precios de proveedores
• Verificar recepciones pendientes

Escenario 3: Asistente Financiero

El agente ayuda al equipo financiero a:

• Analizar cuentas por cobrar vencidas
• Revisar saldos de clientes
• Consultar movimientos contables
• Generar resúmenes de facturación

📊 Comparativa: MCP vs Otros Métodos

¿Por qué MCP?

1. Autodescubrimiento: El agente descubre automáticamente qué puede hacer
2. Actualizaciones automáticas: Los cambios en BC se reflejan sin reconfigurar
3. Lenguaje natural: Los usuarios hablan normalmente, no aprenden comandos
4. Seguridad integrada: Respeta permisos de BC del usuario conectado
5. Bajo mantenimiento: No hay flujos que actualizar cuando cambia BC

🔗 Recursos Adicionales

Documentación Oficial

• Business Central MCP Server
• Crear Agentes con Copilot Studio
• MCP en Copilot Studio

Comunidad

• GitHub - Microsoft MCS MCP Lab
• Copilot Developer Camp

🤝 Contribuir

¿Encontraste un error? ¿Tienes sugerencias?

1. Abre un Issue describiendo el problema/sugerencia
2. Si quieres contribuir, haz un Fork y Pull Request
3. Revisa las guías de contribución

⚠️ Notas Importantes

Estado del entorno: la edición del taller toma BC27 como referencia. Comprueba las funciones disponibles en tu BC online y la configuración oficial de MCP. Las herramientas de consulta de datos tienen su propio estado preview; no se asigna un único estado de disponibilidad a todo MCP.

Licencias: Asegúrate de tener las licencias adecuadas:

• Business Central (Essential o Premium)
• Copilot Studio con capacidad/créditos disponibles
• Para usar el agente en Microsoft 365 Copilot, los usuarios necesitan licencia de Microsoft 365 Copilot

Seguridad: El agente actúa con los permisos del usuario conectado. Configura roles adecuados en BC.

📄 Licencia

Este workshop está bajo licencia MIT. Puedes usarlo, modificarlo y distribuirlo libremente.

🙏 Créditos

• Microsoft: Por el framework MCP y Copilot Studio
• Comunidad BC: Por feedback y casos de uso

¡Empezamos! 🚀

👉 Módulo 0: Preparación del Entorno