Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Dynamics 365 Business Central Admin

by demilianiversion 2.0.1i★ 13iRuns on your computerRepository ↗
Registry nameio.github.demiliani/d365bc-admin-mcp

How to install

What it does

Administer Business Central environments, apps, PTEs, updates and exports via the Admin Center API.

  • Connects Runs on your computer
  • Account or key Needs D365BC_MCP_PERSIST_TOKEN_CACHE
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity14/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score26/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Dynamics 365 Business Central Admin. Follow https://mcp.popnx.com/i/demiliani-d365bc-admin-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 17, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Dynamics 365 Business Central Admin for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "d365bc-admin": { "command": "npx", "args": [ "-y", "@demiliani/d365bc-admin-mcp" ], "env": { "D365BC_MCP_PERSIST_TOKEN_CACHE": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For D365BC_MCP_PERSIST_TOKEN_CACHE, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Dynamics 365 Business Central Admin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Dynamics 365 Business Central Admin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Dynamics 365 Business Central Admin site ↗

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "d365bc-admin": {
          "command": "npx",
          "args": [
            "-y",
            "@demiliani/d365bc-admin-mcp"
          ],
          "env": {
            "D365BC_MCP_PERSIST_TOKEN_CACHE": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use Dynamics 365 Business Central Admin and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Dynamics 365 Business Central Admin or shows a Dynamics 365 Business Central Admin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • D365BC_MCP_LOG_LEVEL Log level written to stderr · default Information

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Dynamics 365 Business Central Admin yet

Dynamics 365 Business Central Admin runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Dynamics 365 Business Central Admin

  • You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Dynamics 365 Business Central Admin for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user d365bc-admin --env D365BC_MCP_PERSIST_TOKEN_CACHE=your-value -- npx -y @demiliani/d365bc-admin-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For D365BC_MCP_PERSIST_TOKEN_CACHE, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Dynamics 365 Business Central Admin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Dynamics 365 Business Central Admin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Dynamics 365 Business Central Admin site ↗

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user d365bc-admin --env D365BC_MCP_PERSIST_TOKEN_CACHE=your-value -- npx -y @demiliani/d365bc-admin-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see Dynamics 365 Business Central Admin listed as connected

  6. Try it

    Use Dynamics 365 Business Central Admin and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Dynamics 365 Business Central Admin or shows a Dynamics 365 Business Central Admin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • D365BC_MCP_LOG_LEVEL Log level written to stderr · default Information

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Dynamics 365 Business Central Admin for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "d365bc-admin": { "command": "npx", "args": [ "-y", "@demiliani/d365bc-admin-mcp" ], "env": { "D365BC_MCP_PERSIST_TOKEN_CACHE": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For D365BC_MCP_PERSIST_TOKEN_CACHE, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Dynamics 365 Business Central Admin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Dynamics 365 Business Central Admin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Dynamics 365 Business Central Admin site ↗

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the Dynamics 365 Business Central Admin settings, D365BC_MCP_PERSIST_TOKEN_CACHE is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use Dynamics 365 Business Central Admin and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Dynamics 365 Business Central Admin or shows a Dynamics 365 Business Central Admin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • D365BC_MCP_LOG_LEVEL Log level written to stderr · default Information

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Dynamics 365 Business Central Admin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Dynamics 365 Business Central Admin for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "d365bc-admin": { "type": "stdio", "command": "npx", "args": [ "-y", "@demiliani/d365bc-admin-mcp" ], "env": { "D365BC_MCP_PERSIST_TOKEN_CACHE": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For D365BC_MCP_PERSIST_TOKEN_CACHE, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Dynamics 365 Business Central Admin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Dynamics 365 Business Central Admin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Dynamics 365 Business Central Admin site ↗

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the Dynamics 365 Business Central Admin settings, D365BC_MCP_PERSIST_TOKEN_CACHE is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use Dynamics 365 Business Central Admin and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Dynamics 365 Business Central Admin or shows a Dynamics 365 Business Central Admin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • D365BC_MCP_LOG_LEVEL Log level written to stderr · default Information

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Dynamics 365 Business Central Admin💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user d365bc-admin --env D365BC_MCP_PERSIST_TOKEN_CACHE=your-value -- npx -y @demiliani/d365bc-admin-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "d365bc-admin": {
      "command": "npx",
      "args": [
        "-y",
        "@demiliani/d365bc-admin-mcp"
      ],
      "env": {
        "D365BC_MCP_PERSIST_TOKEN_CACHE": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "d365bc-admin": {
      "command": "npx",
      "args": [
        "-y",
        "@demiliani/d365bc-admin-mcp"
      ],
      "env": {
        "D365BC_MCP_PERSIST_TOKEN_CACHE": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "d365bc-admin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@demiliani/d365bc-admin-mcp"
      ],
      "env": {
        "D365BC_MCP_PERSIST_TOKEN_CACHE": "your-value"
      }
    }
  }
}

Values you fill in

  • D365BC_MCP_LOG_LEVEL env
    Log level written to stderr
  • D365BC_MCP_PERSIST_TOKEN_CACHE secret required env
    Keep the Microsoft sign-in in the encrypted OS token cache across restarts

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
26/wk
Connection
Runs on your computer
Latest versioni
2.0.1
Categoryi
Other
Published to registryi
Nov 17, 2026
Code last changedi
Nov 17, 2026
Maker
demiliani
Packages
npm: @demiliani/d365bc-admin-mcp
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account demiliani, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 3 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked yet

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/demiliani-d365bc-admin-mcp.svg)](https://mcp.popnx.com/en/servers/demiliani-d365bc-admin-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 97% of the other 20815 servers in this category
  • Published to the registry more recently than 94% of the other 20815 servers in this category
  • Basic checks equal to or better than 99% of the other 20815 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Dynamics 365 Business Central Admin safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: D365BC_MCP_PERSIST_TOKEN_CACHE

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 3 days ago, and the latest version (2.0.1) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 4 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 31 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Dynamics 365 Business Central Admin
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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
  • 📦 52 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
  • 🛰️ Admin Center API v2.29 - Built on the latest Business Central Administration Center API

📦 Installation

Via npm (Recommended)
npm install -g @demiliani/d365bc-admin-mcp

To upgrade, run the same command with @latest. Close your AI assistant first (or stop the MCP server): on Windows a running server keeps its executable locked.

The server is also listed in the MCP Registry as io.github.demiliani/d365bc-admin-mcp, so clients that browse the registry (such as VS Code) can find and install it directly.

Prerequisites
  • Node.js 18+ - Download
  • Windows, Linux (glibc) or macOS, on x64 or ARM64 - npm installs only the self-contained server for your platform (about 15 MB, no .NET install needed); elsewhere, build from source
  • 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)

The buttons add the server to your VS Code user configuration and run it through npx, so the global npm install is optional.

To configure it by hand, run MCP: Open User Configuration from the Command Palette (or create .vscode/mcp.json in a workspace) and add:

{

"servers": { "d365bc-admin": { "type": "stdio", "command": "d365bc-admin-mcp" } } }

Then start the server from the Start link shown above it in mcp.json (or MCP: List Servers) and use it from Copilot Chat in Agent mode.

Cursor

Location: ~/.cursor/mcp.json (all projects) or .cursor/mcp.json in a project

Configuration:

{

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

Save the file; the server appears under Cursor Settings → MCP, where it can be enabled and restarted.

🔐 Authentication

The server first tries the credentials already available on the machine (Azure CLI, Visual Studio, environment variables, managed identity). Otherwise, on first use, a browser window opens for Microsoft Entra ID authentication: sign in with your Business Central administrator account.

The sign-in is kept across restarts: refresh tokens are stored in the operating system's encrypted token cache (Windows DPAPI, macOS Keychain, Linux keyring) and the account is remembered in %LOCALAPPDATA%/D365BCAdminMCP (~/Library/Application Support/D365BCAdminMCP on macOS, ~/.local/share/D365BCAdminMCP on Linux), so the browser opens again only when the refresh token expires. Where no encrypted store is available (e.g. Linux without a keyring), the login is kept in memory only. Set D365BC_MCP_PERSIST_TOKEN_CACHE=false to disable persistence; clear_cached_token signs out of a tenant.

If the browser window does not launch automatically, run the MCP tool force_interactive_auth (e.g., ask your assistant: "Force interactive login for tenant 00000000-0000-0000-0000-000000000000"). It skips Azure CLI / Visual Studio credentials and the saved sign-in, opens the Microsoft login dialog for the specified tenant and lets you choose a different account (useful when the machine is signed in with a user that has no access to that tenant).

No additional setup required - the MCP server handles authentication automatically!

💡 Usage Examples

Once configured, use natural language commands in your AI assistant:

Environment Management
"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" "Rename the 'Testing' sandbox to 'UAT'" "Which points in time can I restore Production to? Restore it to yesterday 08:00 UTC as a sandbox called 'Prod-Restore'" "Show the running environment operations and how many environments I can still create" "Delete the Production environment" (you are asked to type 'Production' to confirm) "Export the Production database to my storage account; how many exports are left this month?" "Restrict Sandbox access to the 'BC Testers' security group"

Application Management
"List all installed apps in Production"

"Show available updates for my apps" "Install app with ID in my Production environment" "Update the Sales Module app to version 2.0" "Uninstall the old Marketing app from Sandbox"

Session Management
"Show active user sessions in Production"

"Terminate session abc123 in my Sandbox environment"

Update Windows
"Get the update window settings for Production"

"Set update window for Production to 10 PM - 6 AM UTC"

Storage & Monitoring
"Show storage usage for all environments"

"What's the storage usage for Production?"

Extension Deployment & PTE Uploads
"Install c:\\Packages\\MyPTE.app on Production (Fabrikam) during the update window"

"Install all .app files from c:\\Packages into Sandbox now, in dependency order, installing any missing AppSource apps" "Show the scheduled PTE installs for Production and cancel the one for MyPTE 2.0.0.0" "Check the extension deployment status for Fabrikam in Production"

🛠️ Available Tools (52 Total)

The MCP server exposes 52 administrative tools organized by category:

🔑 Authentication & Tenant Management (3 tools)
ToolDescription
get_microsoft_entra_id_tokenSign in to a tenant and cache the token used by the other tools (returns status and expiry, never the token)
force_interactive_authForce browser-based login and refresh the cached token for a tenant
get_tenant_id_from_tenant_nameRetrieve tenant ID from tenant name
🌍 Environment Management (16 tools)
ToolDescription
get_environment_informationsList all BC environments in a tenant
create_new_environmentCreate a new BC environment (optionally on a specific ring and application version)
copy_environmentCopy an existing environment to create a new one
delete_environmentDelete a Business Central environment
recover_environmentRecover a recently deleted environment
rename_environmentRename an environment (its URL changes, so integrations must be updated)
restore_environmentRestore an environment to a point in time as a new environment
get_available_restore_periodsList the time ranges an environment can be restored to
get_environment_operationsList environment operations (create, copy, rename, restore, ...) for the tenant or one environment
get_environment_quotasGet the environment and storage quotas of the tenant
get_environment_update_windowGet update window settings for an environment
set_environment_update_windowConfigure update window for an environment
set_environment_application_insights_connection_stringSet Application Insights connection string
get_usage_storage_for_environmentGet storage usage for a specific environment
get_usage_storage_for_all_environmentsGet storage usage for all environments
get_environment_companiesList companies in an environment
📦 Application Management (6 tools)
ToolDescription
get_installed_appsList apps installed in an environment
get_available_app_updatesCheck for available app updates
install_appInstall a Marketplace (AppSource) app in a Business Central environment
update_appUpdate an app to a specific version
uninstall_appRemove an app from an environment
get_app_operationsGet status of app install/update/uninstall operations
🔄 Environment Updates (2 tools)
ToolDescription
get_environment_updatesCheck for available BC version updates
set_environment_updateSchedule or run an environment update
👥 Session Management (2 tools)
ToolDescription
get_active_sessionsList active user sessions in an environment
kill_active_sessionsTerminate a specific active session
🔔 Notification Management (3 tools)
ToolDescription
get_environment_notification_recipientList notification recipients
create_environment_notification_recipientAdd a new notification recipient
delete_environment_notification_recipientRemove a notification recipient
🔐 Environment Access (5 tools)
ToolDescription
get_environment_security_groupGet the Microsoft Entra security group that restricts access to an environment
set_environment_security_groupRestrict access to the members of a security group
clear_environment_security_groupRemove the security group restriction
get_access_with_m365_licensesCheck whether users can access the environment with Microsoft 365 licenses
set_access_with_m365_licensesAllow or disallow access with Microsoft 365 licenses
💾 Database Export (2 tools)
ToolDescription
get_database_export_metricsExports allowed per month and remaining this month
start_database_exportExport the environment database as a .bacpac file to an Azure Storage account

start_database_export needs a paid subscription, the D365 BACKUP/RESTORE permission set and a Blob service SAS URI of an Azure standard storage account with Read, Write, Create and Delete permissions. The SAS URI is never logged or returned by the server, but it is part of the conversation with the AI assistant, so use a short-lived one. Track the export with `get_e

Only the beginning is shown; read the rest in the repo