A Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop, GitHub Copilot, and Cursor to manage Dynamics 365 Business Central environments through natural language commands.
- 🔐 Interactive Authentication - Secure Microsoft Entra ID authentication with browser-based login
- 📦 34 Administrative Tools - Complete environment, app, session, PTE upload, and extension management
- ⚡ Smart Token Caching - Automatic token refresh to minimize authentication prompts
- 🌍 Multi-Tenant Support - Manage multiple Business Central tenants seamlessly
- 💬 Natural Language Interface - Control BC through conversational AI commands
- 🔒 Secure by Design - No credentials stored, uses Azure authentication standards
npm install -g @demiliani/d365bc-admin-mcp- Node.js 16+ - Download
- Dynamics 365 Business Central - Admin access to your tenant
- Microsoft Entra ID - Azure account with BC admin privileges
After installation, configure your AI assistant to use the MCP server.
Location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Configuration:
{
"mcpServers": {
"d365bc-admin": {
"command": "d365bc-admin-mcp"
}
}
}Steps:
- Open the configuration file (create it if it doesn't exist)
- Add the above configuration
- Save the file
- Restart Claude Desktop
- You should see the MCP server connected in the chat window
Location: .vscode/settings.json in your workspace or global settings
Configuration:
{
"github.copilot.chat.mcp.servers": {
"d365bc-admin": {
"command": "d365bc-admin-mcp"
}
}
}Steps:
- Open VS Code Settings (JSON)
- Add the above configuration
- Save the file
- Restart VS Code
- Open GitHub Copilot Chat to start using the MCP server
Location: .cursor/config.json in your workspace
Configuration:
{
"mcp": {
"servers": {
"d365bc-admin": {
"command": "d365bc-admin-mcp"
}
}
}
}Steps:
- Create
.cursor/config.jsonin your workspace root - Add the above configuration
- Save the file
- Restart Cursor
- The MCP server will be available in Cursor's AI chat
On first use, a browser window will open for Microsoft Entra ID authentication. Sign in with your Business Central administrator account. The token is cached for 50 minutes and automatically refreshed.
No additional setup required - the MCP server handles authentication automatically!
Once configured, use natural language commands in your AI assistant:
"Show me all my Business Central environments"
"What's the status of my Production environment?"
"Create a new sandbox environment called 'Dev-Test' in the US"
"Copy Production environment to a new sandbox called 'Testing'"
"Delete the 'Old-Test' sandbox environment"
"List all installed apps in Production"
"Show available updates for my apps"
"Install app with ID <app-id> in my Production environment"
"Update the Sales Module app to version 2.0"
"Uninstall the old Marketing app from Sandbox"
"Show active user sessions in Production"
"Terminate session abc123 in my Sandbox environment"
"Get the update window settings for Production"
"Set update window for Production to 10 PM - 6 AM UTC"
"Show storage usage for all environments"
"What's the storage usage for Production?"
"Upload the app c:\\Packages\\MyPTE.app to Production (Fabrikam)"
"Bulk upload all .app files from c:\\Packages into Sandbox and wait for deployments"
"Check the extension deployment status for Fabrikam in Production"
The MCP server exposes 33 administrative tools organized by category:
| Tool | Description |
|---|---|
get_microsoft_entra_id_token |
Get authentication token with intelligent caching |
get_tenant_id_from_tenant_name |
Retrieve tenant ID from tenant name |
| Tool | Description |
|---|---|
get_environment_informations |
List all BC environments in a tenant |
create_new_environment |
Create a new BC environment |
copy_environment |
Copy an existing environment to create a new one |
delete_environment |
Delete a Business Central environment |
get_environment_update_window |
Get update window settings for an environment |
set_environment_update_window |
Configure update window for an environment |
set_app_insights_key |
Set Application Insights connection string |
get_environment_storage_usage |
Get storage usage for a specific environment |
get_all_environments_storage_usage |
Get storage usage for all environments |
get_companies |
List companies in an environment |
| Tool | Description |
|---|---|
get_installed_apps |
List apps installed in an environment |
get_available_app_updates |
Check for available app updates |
install_app |
Install a Marketplace (AppSource) app in a Business Central environment |
update_app |
Update an app to a specific version |
uninstall_app |
Remove an app from an environment |
get_app_operations |
Get status of app install/update/uninstall operations |
| Tool | Description |
|---|---|
get_available_environment_updates |
Check for available BC version updates |
schedule_environment_update |
Schedule or run an environment update |
| Tool | Description |
|---|---|
get_active_sessions |
List active user sessions in an environment |
kill_active_sessions |
Terminate a specific active session |
| Tool | Description |
|---|---|
get_notification_recipients |
List notification recipients |
create_notification_recipient |
Add a new notification recipient |
delete_notification_recipient |
Remove a notification recipient |
| Tool | Description |
|---|---|
get_available_features |
List available features in an environment |
activate_feature |
Activate a feature in a Business Central environment |
deactivate_feature |
Deactivate a feature in a Business Central environment |
| Tool | Description |
|---|---|
get_extension_deployment_status |
Get extension deployment status for an environment/company |
create_pte_upload |
Create and upload a single PTE (.app) file |
create_pte_uploads_from_folder |
Bulk upload PTEs from a folder, waiting for each deployment |
get_extension_upload |
Retrieve the status of a specific extension upload task |
| Tool | Description |
|---|---|
clear_cached_token |
Clear cached authentication token for a tenant |
get_token_cache_status |
View cached token status for all tenants |
-
Install the package:
npm install -g @demiliani/d365bc-admin-mcp
📖 Need detailed installation instructions? See the Installation Guide for platform-specific steps (Windows, macOS, Linux) and troubleshooting.
-
Configure your AI assistant (see Configuration section above)
-
Start using it:
- Open your AI assistant (Claude, Copilot, or Cursor)
- Type: "Show me all my Business Central environments"
- Authenticate when prompted (first time only)
- Start managing your BC environments with natural language!
For detailed installation documentation, see:
- Installation Guide - Detailed installation steps
npm install -g @demiliani/d365bc-admin-mcp
which d365bc-admin-mcp- Ensure you have Business Central admin privileges
- Check that you're signing in with the correct Microsoft account
- Try clearing the token cache: "Clear cached token for tenant [tenant-id]"
- Verify the config file location for your OS
- Check for JSON syntax errors in the config
- Restart your AI assistant completely
- Check the assistant's logs for error messages
Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
- npm Package: https://www.npmjs.com/package/@demiliani/d365bc-admin-mcp
- Issues: Report bugs or request features via GitHub Issues
- Version: 1.2.0
Built with:
- Model Context Protocol - Standard for AI assistant integrations
- Azure Identity - Microsoft authentication
- Business Central Admin API - BC administration
Made with ❤️ for the Dynamics 365 Business Central community
