Business Central MCP
About
An MCP server for interacting with Microsoft Business Central, built with FastMCP and FastAPI.
Details
- Author
- javiarmesto
- Categories
- Productivity, Other
Jump to
Setup
Install Business Central MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/javiarmesto/Lab3_1_MCP_BusinessCentral
Follow the installation instructions in the repository README, then restart your MCP client.
An MCP server for interacting with Microsoft Business Central, built with FastMCP and FastAPI.
MCP_BusinessCentral - Servidor Model Context Protocol 🚀
Este proyecto implementa unservidor MCPpara Microsoft Business Central, usando FastMCP y FastAPI, integrable con Claude Desktop y otros clientes AI.
🎉 El servidor está desplegado y operativo en Azure App Service:
- URL:https://mcp-bc-javi-chb7bue4evbkeyb0.westeurope-01.azurewebsites.net
- Documentación API:https://mcp-bc-javi-chb7bue4evbkeyb0.westeurope-01.azurewebsites.net/docs
- Estado: ✅ 100% funcional con datos reales de Business Central
- Endpoints disponibles: GET /customers, /items, /orders, POST /customers
📋Para usar el servidor desplegado: Consulta el archivotest-mcp-api.httpcon ejemplos de todas las operaciones.
ElModel Context Protocol(MCP) es un estándar abierto que permite a clientes AI acceder a herramientas, datos y servicios externos de forma segura y estructurada. MCP define una arquitectura cliente-servidor donde:
- MCP Host:Cliente AI (Claude, Copilot, etc.)
- MCP Client:Conector MCP en el host
- MCP Server:Este proyecto (Python) expone herramientas y lógica de negocio
- Transporte:JSON-RPC sobre stdin/stdout (local) o HTTP/SSE (remoto)
Más información:MCP servers en Microsoft Learn
- Se recomienda usar Microsoft Entra ID (Azure AD) y OAuth2 para entornos de producción.
- Consulta laguía de autenticación para Business Central.
Ejemplo: Autenticación OAuth2 con Entra ID
import httpx def get_bc_token(tenant_id, client_id, client_secret, scope): url = f"https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token" data = { "grant_type": "client_credentials", "client_id": client_id, "client_secret": client_secret, "scope": scope } response = httpx.post(url, data=data) response.raise_for_status() return response.json()["access_token"]
- Business Central impone límites de uso (rate limits) en sus APIs. Si recibes errores 429 (Too Many Requests) o 504 (Gateway Timeout), implementa lógica de reintentos y backoff.
- Más información:Límites de API en Business Central.
Ejemplo: Manejo de errores 429 y 504 en llamadas a la API
import httpx import time def call_bc_api_with_retry(url, headers, max_retries=5): retries = 0 backoff = 2 while retries < max_retries: response = httpx.get(url, headers=headers) if response.status_code == 429: wait = backoff retries print(f"Rate limit alcanzado. Reintentando en {wait}s...") time.sleep(wait) retries += 1 elif response.status_code == 504: print("Timeout de la API. Reintentando...") time.sleep(backoff) retries += 1 else: return response raise Exception("No se pudo completar la petición tras varios intentos")
Más información:Límites de API en Business Central
- Usa siempre los endpoints REST oficiales de Business Central para la integración.
- Desacopla la lógica de negocio del transporte MCP.
- Documenta claramente las herramientas expuestas y sus parámetros siguiendo el estándar MCP.
- Consulta ladocumentación de APIs REST de Business Central.
📁 MCP_BusinessCentral/ ├── requirements.txt # Dependencias Python ├── README.md # Documentación principal ├── .env # Variables de entorno (no se incluye en repo) ├── .venv/ # Entorno virtual Python ├── .github/copilot-instructions.md ├── .vscode/tasks.json # Tareas de VS Code ├── task1.txt # (Ejemplo o pruebas) └── 📁 bc_server/ # Paquete principal ├── BusinessCentralMCP.py # Servidor MCP (JSON-RPC) para BC ├── http_server.py # API REST (FastAPI) con OpenAPI/Swagger ├── setup_guide.py # Script de validación de entorno y credenciales ├── client.py # Cliente HTTP para la API de BC ├── config.py # Carga y validación de configuración └── __init__.py
1. BusinessCentralMCP.py - Servidor MCP (JSON-RPC)
Expone herramientas para interactuar con Business Central vía JSON-RPC:
- get_customers(limit): Lista clientes
- get_customer_details(customer_id): Detalle de un cliente
- get_items(limit): Lista artículos
- get_sales_orders(limit): Lista órdenes de venta
- create_customer(...): Crea un nuevo cliente
Expone los mismos métodos anteriores vía HTTP REST, con documentación Swagger/OpenAPI.
3. setup_guide.py - Validación de entorno
Script para comprobar variables de entorno y conectividad con Azure AD y Business Central.
- FastMCP: Framework para servidores MCP (JSON-RPC)
- FastAPI: API REST moderna con documentación automática
- httpx: Cliente HTTP asíncrono
- Pydantic: Validación y serialización de datos
- python-dotenv: Gestión de variables de entorno
python -m venv .venv .venv\Scripts\Activate.ps1
uvicorn bc_server.http_server:app --reload --host 0.0.0.0 --port 8000
Accede a la documentación interactiva en:http://localhost:8000/docs
¿Quieres el servidor disponible online?Consulta laGuía Completa de Despliegueque incluye:
- Proceso paso a paso para Azure App Service
- Solución a todos los problemas encontrados
- Configuración de variables de entorno
- Scripts de automatización
- Suite de testing completa
Resultado: Servidor 100% operativo en Azure con integración real a Business Central.
El archivotest-mcp-api.httpcontiene una suite completa de tests para validar todas las funcionalidades:
### Health Check GET https://mcp-bc-javi-chb7bue4evbkeyb0.westeurope-01.azurewebsites.net/health ### Listar Clientes GET https://mcp-bc-javi-chb7bue4evbkeyb0.westeurope-01.azurewebsites.net/customers?limit=5 ### Crear Cliente POST https://mcp-bc-javi-chb7bue4evbkeyb0.westeurope-01.azurewebsites.net/customers Content-Type: application/json { "displayName": "Cliente Test", "email": "test@example.com" }
Usar REST Client extensionde VS Code para ejecutar los tests directamente desde el editor.
- Localiza el archivo de configuración de Claude Desktop:
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
{ "mcpServers": { "businesscentral-mcp": { "command": "C:/ruta/completa/.venv/Scripts/python.exe", "args": ["-m", "bc_server.BusinessCentralMCP"] } } }
🛠️ Herramientas Disponibles (BusinessCentralMCP)
Consulta la documentación Swagger en/docssi usas la API REST.
- Claude Desktop:Configura el archivo de Claude Desktop y reinicia para probar las herramientas MCP.
- Modo desarrollo:Usa los scripts de la carpetabc_serverpara pruebas y debugging.
- API REST:Ejecutauvicorn bc_server.http_server:app --reloady prueba los endpoints enhttp://localhost:8000/docs.
- VS Code Task:Usa la tarea "Run Python Script" para lanzar scripts rápidamente.
- Integración MCP con Business Central
- Exposición de datos de clientes, artículos y órdenes
- Creación de clientes desde herramientas AI
- API REST y JSON-RPC para integración flexible
📚 Referencias oficiales y recursos útiles
- MCP servers en Microsoft Learn
- APIs REST de Business Central
- Desarrollar apps conectadas a Business Central
- Límites de API en Business Central
- Documentación MCP Oficial
- FastMCP GitHub
- Claude Desktop
- Pydantic Docs
- Blog TechSphereDynamics
¡Desarrollado con visión y buen rollo!**😉
Para cualquier duda, revisa los comentarios en el código o consulta la documentación oficial de MCP.
Contract and template management for drafting, reviewing, and sending binding contracts.
Qasper gives AI agents the tools to discover local service businesses, check availability, and book appointments in real time.
Find buying signals for companies and contacts
AI-native trade business management for Australian tradies. 11 MCP tools for leads, quotes, jobs, invoicing, financials, and client CRM.
Australian trade business OS with 67 MCP tools across 23 domains — autonomous business formation, lead management, quoting, job scheduling, invoicing, crypto payments, and growth analytics for tradies.
Connect your Attio workspace to large language models.
Interact with and manage your Bitrix24 CRM instance through a powerful set of tools.
Prospection B2B en France — sourcing entreprises, enrichissement contacts, push CRM. Remote MCP server avec OAuth 2.1.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
