How to Connect Dynamics 365 Business Central to Cursor via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Microsoft Dynamics 365 Business Central, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Dynamics 365 Business Central + Cursor

Let your AI work in Business Central: look up customers, vendors and items, read sales quotes, orders and invoices, purchase invoices, the general ledger, chart of accounts and dimensions, and create customers and draft quotes and orders. Business Central online through the standard API v2.0, signed in with your Microsoft account.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID, BC_ENVIRONMENT

Step 1 — Get credentials

1. Open the Microsoft Entra admin center at https://entra.microsoft.com → Applications → App registrations → New registration, or reuse the app you created for the Outlook, OneDrive or SharePoint connector. Accounts in this organizational directory only is the usual choice.
2. Add a redirect URI with the platform Web: https://cloud.anythingmcp.com/api/mcp-oauth/callback (if you host AnythingMCP yourself: <your AnythingMCP URL>/api/mcp-oauth/callback). It has to match exactly, or Microsoft answers AADSTS50011.
3. Under API permissions → Add a permission → Dynamics 365 Business Central → Delegated permissions, tick Financials.ReadWrite.All (and user_impersonation). Click Grant admin consent if your organisation does not let users consent themselves.
4. Under Certificates & secrets → New client secret, copy the secret Value. It is shown once; the Secret ID is not what you need.
5. Fill in MICROSOFT_CLIENT_ID (the Application (client) ID), MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID and BC_ENVIRONMENT, then install the connector.
6. Click Authorize with Provider and sign in with a Business Central user. Access tokens are renewed automatically.
7. Run bc_list_companies. Every other tool works inside one company and takes its id.

Tenant and environment: MICROSOFT_TENANT_ID is your Directory (tenant) ID or a domain such as contoso.onmicrosoft.com. common and organizations do not work here, because the tenant is part of the Business Central address. BC_ENVIRONMENT is the environment name exactly as the Business Central admin center lists it: Production for most live tenants, Sandbox or your own name for a test environment. bc_list_environments shows the names. Try the connector in a sandbox first: in Production, the customers and documents it creates are real.

Same permissions as the user: every call runs as the user who signed in, with that user's Business Central licence and permission sets. The AI sees and changes exactly what that user may.

What it reads and writes: customers, vendors, items, sales quotes, orders and invoices, purchase invoices, general ledger entries, the chart of accounts, dimensions and employees, plus any other standard API v2.0 resource through bc_query, such as contacts, purchase orders, credit memos, aged receivables and payables or the trial balance. It creates customers and sales quotes and orders with their lines, and updates customers. Documents stay open drafts: nothing is released, shipped, invoiced or posted. The AI confirms customer, items, quantities and prices with you before it creates a document.

Switched off at install: bc_delete_customer, bc_make_order_from_quote, bc_delete_sales_quote and bc_delete_sales_order. Deleting a record or turning a quote into an order cannot be undone, so switch these on per tool only if you need them.

Limits: Business Central allows about 6,000 API calls per user in 5 minutes; beyond that it asks the connector to wait.

Common errors: 401 means the authorization was revoked or the client secret expired: paste a new secret if needed and authorize again. 403: the user lacks a licence or permission set, or admin consent is missing. 404 NoEnvironment: BC_ENVIRONMENT or MICROSOFT_TENANT_ID is wrong. 412: someone changed the record since it was read, so the AI reads it again.

Business Central online only: on-premises installations are not covered, and older NAV installations have their own Dynamics NAV connector. Custom APIs published by extensions are not reached.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Cursor

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart Cursor.
3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
4. Start chatting: the agent can now call the Dynamics 365 Business Central tools.

Available tools

Example prompts

• "Which customers have overdue invoices, and what is the total per customer?"
• "Show this month's sales orders that are not fully shipped yet."
• "Create a sales quote for Adatum Corporation with 10 units of item 1896-S, and show it to me before you save it."
• "What did we post on the revenue accounts in September, by department?"

FAQ

Does Cursor support custom MCP servers on the free tier? Yes, MCP is available on Hobby, Pro and Business plans.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT