# Dynamics 365 Business Central Admin

Dynamics 365 Business Central Admin is an MCP server for Claude Code that manages Business Central environments through the Admin Center API. Requests can trigger admin operations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13 repo stars
- Author: demiliani
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/demiliani/D365BCAdminMCP
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/dynamics-365-business-central-admin

## What it does

Dynamics 365 Business Central Admin lets an AI assistant manage Business Central environments, apps, sessions, extensions, and exports through the Administration Center API. Its tools cover environment creation, copying, renaming, and deletion, plus app updates, session termination, storage exports, and update-window settings.

The server needs Node.js 18+, administrator access to a Business Central tenant, and a Microsoft Entra ID account with Business Central admin privileges. Authentication can use Azure CLI, Visual Studio, environment credentials, or an interactive browser login. Refresh tokens use the operating system's encrypted store; on Linux without a keyring, the login remains in memory only.

Add it to Claude Code with `claude mcp add d365bc-admin-mcp -- npx -y @demiliani/d365bc-admin-mcp`. The server uses Admin Center API v2.29 and supports management across multiple Business Central tenants.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `D365BC_MCP_LOG_LEVEL`, `D365BC_MCP_PERSIST_TOKEN_CACHE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env D365BC_MCP_LOG_LEVEL=<D365BC_MCP_LOG_LEVEL> --env D365BC_MCP_PERSIST_TOKEN_CACHE=<D365BC_MCP_PERSIST_TOKEN_CACHE> --transport stdio dynamics-365-business-central-admin -- npx -y @demiliani/d365bc-admin-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add dynamics-365-business-central-admin --env D365BC_MCP_LOG_LEVEL=<D365BC_MCP_LOG_LEVEL> --env D365BC_MCP_PERSIST_TOKEN_CACHE=<D365BC_MCP_PERSIST_TOKEN_CACHE> -- npx -y @demiliani/d365bc-admin-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dynamics-365-business-central-admin": {
            "command": "npx",
            "args": [
                "-y",
                "@demiliani/d365bc-admin-mcp"
            ],
            "env": {
                "D365BC_MCP_LOG_LEVEL": "<D365BC_MCP_LOG_LEVEL>",
                "D365BC_MCP_PERSIST_TOKEN_CACHE": "<D365BC_MCP_PERSIST_TOKEN_CACHE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dynamics-365-business-central-admin": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@demiliani/d365bc-admin-mcp"
            ],
            "env": {
                "D365BC_MCP_LOG_LEVEL": "<D365BC_MCP_LOG_LEVEL>",
                "D365BC_MCP_PERSIST_TOKEN_CACHE": "<D365BC_MCP_PERSIST_TOKEN_CACHE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e D365BC_MCP_LOG_LEVEL=<D365BC_MCP_LOG_LEVEL> -e D365BC_MCP_PERSIST_TOKEN_CACHE=<D365BC_MCP_PERSIST_TOKEN_CACHE> dynamics-365-business-central-admin npx -y @demiliani/d365bc-admin-mcp
```
Replace <…> with your own values

## When to use it
- create a sandbox from Production
- list installed apps and available updates
- terminate an active user session
- set an environment update window
- export the Production database to a storage account

## Example prompts
- Show all Business Central environments and report the status of Production.
- Copy Production into a new sandbox named `Testing`.
- List active sessions in Production and terminate session `abc123`.

## Similar
- [business-central-development](https://affpapa.org/en/nevibecode/skills/business-central-development.md) — skill · 802 installs
- [dynamics-crm](https://affpapa.org/en/nevibecode/skills/dynamics-crm.md) — skill · 545 installs
- [D365FO MCP Server](https://affpapa.org/en/nevibecode/mcp/d365fo-mcp-server.md) — MCP server · ★ 42 repo stars
- [meilisearch-admin](https://affpapa.org/en/nevibecode/skills/meilisearch-admin.md) — skill · 132 installs
- [azure-business-process-tracking](https://affpapa.org/en/nevibecode/skills/azure-business-process-tracking.md) — skill · 168 installs
- [shopify-admin](https://affpapa.org/en/nevibecode/skills/shopify-admin.md) — skill · 1 install

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
