Dynamics 365 Business Central Admin MCP Server (YAMPI)

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.

🌟 Features

• 🔐 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

📦 Installation

Via npm (Recommended)

npm install -g @demiliani/d365bc-admin-mcp

Prerequisites

• Node.js 16+ - Download
• Dynamics 365 Business Central - Admin access to your tenant
• Microsoft Entra ID - Azure account with BC admin privileges

⚙️ Configuration

After installation, configure your AI assistant to use the MCP server.

Claude Desktop

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:

1. Open the configuration file (create it if it doesn’t exist)
2. Add the above configuration
3. Save the file
4. Restart Claude Desktop
5. You should see the MCP server connected in the chat window

GitHub Copilot (VS Code)

Location: .vscode/settings.json in your workspace or global settings

Configuration:

{
  "github.copilot.chat.mcp.servers": {
    "d365bc-admin": {
      "command": "d365bc-admin-mcp"
    }
  }
}

Steps:

1. Open VS Code Settings (JSON)
2. Add the above configuration
3. Save the file
4. Restart VS Code
5. Open GitHub Copilot Chat to start using the MCP server

Cursor

Location: .cursor/config.json in your workspace

Configuration:

{
  "mcp": {
    "servers": {
      "d365bc-admin": {
        "command": "d365bc-admin-mcp"
      }
    }
  }
}

Steps:

1. Create .cursor/config.json in your workspace root
2. Add the above configuration
3. Save the file
4. Restart Cursor
5. The MCP server will be available in Cursor’s AI chat

🔐 Authentication

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!

💡 Usage Examples