Back to Blog
Published:
Last Updated:
Fresh Content
Copilot BoundaryChapter 14

Which environments can run the Dynamics 365 ERP MCP server?

5 min read
1,046 words
high priority
Ali Ahmed

Ali Ahmed

AI Solutions Engineer, Cognilium AI

Stacked concrete tiers of a building

TL;DR

Tier 2 or above, or a Unified Developer Environment, and not a Cloud Hosted Environment. Plus three minimum versions and an allow-list your platform needs.

Tier 2 or above, or a Unified Developer Environment — and explicitly not a Cloud Hosted Environment. That single exclusion is the one that catches teams out, because a Cloud Hosted Environment is often exactly where a developer would try this first.

There are four other prerequisites, all published, and none of them is a licence.

Which environment tier is required, and which is ruled out?

Microsoft states both halves in one sentence:

"Your environment is Tier 2 or above, or a Unified Developer Environment. The MCP server isn't supported on Cloud Hosted Environments (CHE)."

Read the exclusion as a hard stop rather than a performance note. A Cloud Hosted Environment is a legitimate, commonly used development environment, and it will not run this. If your proof-of-concept plan starts on a CHE, it needs to move before it starts.

The practical consequence is a sequencing one. Tier 2 environments are shared, governed and finite in most organisations, so access to a sandbox becomes a scheduling dependency for an agent project rather than something a developer arranges on the day.

Which product versions support it?

Three floors, and any one of them satisfies the requirement:

Minimum version
10.0.47
10.0.46 PQU-2
10.0.45 PQU-7

Microsoft's phrasing is "The product version of Dynamics 365 finance and operations apps must be at least" those three — so a proactive quality update on an older release qualifies you without a full version move.

That is worth checking before anyone schedules an upgrade for this. A PQU on 10.0.45 or 10.0.46 is a materially smaller change than moving to 10.0.47, and it reaches the same starting line.

One version note points the other way. The retiring static server "is still available in finance and operations apps environments with version 10.0.2263.17 and greater" — a different numbering series entirely, and a different server. What happens to that one on 1 October is its own question.

Is there anything to switch on?

Almost certainly not, and this is the prerequisite most people over-plan:

"Enable the Dynamics 365 ERP Model Context Protocol server feature in Feature Management if not already enabled. The MCP server is enabled by default."

Enabled by default means the feature-management step is a verification, not a task. Check it, and expect to change nothing.

Note the feature's full name as Microsoft writes it — Dynamics 365 ERP Model Context Protocol server, spelled out, not abbreviated. Feature Management is searched by string, so the abbreviation will not find it.

And Feature Management itself is one of the pages the server cannot reach, which is a deliberate boundary rather than an oversight — an agent cannot turn its own features on.

Does the agent platform need registering?

Yes, and this is the step with no default:

"Add the agent platform on which you're building your agent in the Allowed MCP Clients page."

An allow-list is an explicit, per-client decision. Copilot Studio, Microsoft Foundry and non-Microsoft clients each have to be added; nothing arrives permitted. It is also the natural governance point — the list of platforms that may reach your ERP is a short, reviewable artefact, which is a rare thing in an integration story.

Plan for it as an approval with an owner, not as a checkbox during a build sprint.

Can you put it behind the in-app Copilot?

Not yet — and the wording of this limit matters more than most, because nothing stops you trying:

"Adding the Dynamics 365 ERP MCP server as a tool in the Copilot for finance and operations apps agent, enabling it for use with the sidecar chat panel in the client, isn't yet supported. Although you're not blocked from adding the MCP server to the agent, you might experience errors in the execution."

Read the last clause twice. The platform permits the configuration and the documentation says it is unsupported, which is the most expensive combination available: it will appear to work in a demo and it carries no commitment.

Microsoft closes the door explicitly: "Microsoft support doesn't guarantee assistance for resolving errors or problems for these scenarios."

So the in-app sidecar is not a delivery target for an MCP agent today. If the requirement is a chat experience inside the client, that is a different architecture decision — and the honest answer is to make it deliberately rather than discover it after a build.

When is the server unavailable?

During servicing, and the failure is not graceful. It is limitation nine of ten:

"The MCP server is unavailable during environment downtime, such as servicing windows. Any MCP requests that agents make during these servicing windows fail."

"Fail" is the published word — not queue, not retry, not degrade. An autonomous agent running on a schedule will meet this eventually, so the retry and alerting behaviour belongs in the design rather than in a later hardening pass.

One more environmental constraint is worth knowing before you promise a rollout: the server "supports only US English (en-us)", and while form labels and values follow the authenticated user's locale, "the MCP responses always provide metadata and guidance in English."

About Cognilium Cognilium builds AI optimization apps for Microsoft Dynamics 365 — companion apps that optimize the pricing, inventory, warehouse and planning decisions your ERP manages but can't optimize. Dynamics is your system of record. Cognilium is your system of intelligence. https://cognilium.ai · https://www.linkedin.com/company/37180269/

Agentic ERP. We build turnkey AI optimization apps for Dynamics 365 — sidecar applications that run in your own Azure tenancy and solve the calculations a standard ERP is not built to compute. Built on Azure OpenAI, Microsoft Fabric and Copilot Studio. We build these on request, against your data and your environment.

More on the boundary between what Copilot does and what you build: Agentic ERP on Dynamics 365.

If you are checking whether your environments can carry an agent project, that is a 15-minute call with a definite answer. Bring your tier and version.

Sources

Sources and fact-check
#§ClaimTierSourceVerdict
11Tier 2 or above / Unified Developer Environment; CHE not supportedT1 — verbatimcopilot-mcp, PrerequisitesPASS — load-bearing
21Tier 2 access is a scheduling dependencyT2 — ours, an operational reading, stated as consequence not as Microsoft's claim—PASS
32The three minimum versionsT1 — verbatim, reproduced exactlySame sectionPASS — load-bearing
42A PQU on an older release satisfies the floorT1 — read off the list, which names PQU levels as alternatives to 10.0.47Same listPASS
52Static server available on 10.0.2263.17 and greaterT1 — verbatimSame page, Note under PrerequisitesPASS
63Feature name and "The MCP server is enabled by default."T1 — verbatim, feature name character-exactSame sectionPASS — load-bearing
73Feature Management is itself an excluded formT1Same page, limitation 7 — FeatureManagementWorkspacePASS
84Allowed MCP Clients allow-list requirementT1 — verbatim, page name character-exactSame sectionPASS — load-bearing
94Nothing is permitted by defaultT2 — ours, read from the requirement to add a platform; not stated as a Microsoft sentence—PASS
105Servicing-window unavailability and "fail"T1 — verbatimSame page, limitation 9PASS — load-bearing
115US English only, with the locale nuance intactT1 — verbatimSame page, limitation 1PASS
125aSidecar not yet supported; "you're not blocked from adding"; errors possibleT1 — verbatimSame page, limitation 10PASS — load-bearing
135a"Microsoft support doesn't guarantee assistance for resolving errors or problems for these scenarios."T1 — verbatimSame limitationPASS — load-bearing
145aPermitted-but-unsupported is the expensive combinationT2 — ours, an argument, labelled as a reading in the body—PASS

Tier summary: 11 × T1 (10 verbatim, 1 read off a list), 3 × T2 — 0 × T4.

Absence claims: none. Every constraint here is a published positive — a supported tier, a version floor, a default state, an allow-list, a failure mode. Nothing is asserted about what Microsoft has not documented.

Share this article

The work behind this series

What Microsoft ships, what it does not, and the layer we build where a general assistant runs out.

Ali Ahmed

Ali Ahmed

AI Solutions Engineer, Cognilium AI

Ali Ahmed is an AI Solutions Engineer at Cognilium AI.

Applied AI AgentsAgentic SystemsRetrieval-Augmented Generation (RAG)LLM Product Engineering
Next in this series
Does the Dynamics 365 ERP MCP server truncate results?
Chapter 15 · 5 min
In short

Key takeaways

  • A sandbox tier at or above the documented minimum, or a Unified Developer Environment, is required — and Cloud Hosted Environments are explicitly excluded, which is the prerequisite that most often forces a plan to change.
  • Three version floors satisfy the requirement, and a proactive quality update on an older release qualifies without a full version move.
  • The agent platform must be added to an allow-list, and nothing is permitted by default. Treat it as an approval with an owner.
  • The server is unavailable during servicing windows and requests made then fail — design the retry behaviour rather than discovering it.
  • Two defaults are easy to miss: the feature itself is on by default, so feature management is a check rather than a task — and metadata and guidance are US English only, whatever locale the user runs.
  • The in-app Copilot sidecar is not a supported home for an MCP agent yet — the configuration is permitted, unsupported, and outside Microsoft's support guarantee.
What goes wrong

Common mistakes to avoid

  • Starting a proof of concept on a Cloud Hosted Environment. It is unsupported, and it is the default place a developer would begin.
  • Scheduling a version upgrade before checking the quality-update route. A PQU on an older release reaches the same starting line.
  • Planning time to enable a feature that ships enabled.
  • Leaving the allow-list to the build sprint. It is a governance decision about what may reach your ERP, and it has an approver.
  • Assuming a scheduled agent degrades politely during servicing. Microsoft's word is fail.
  • Treating "not blocked" as "supported". The sidecar configuration is allowed by the platform and disclaimed by the documentation.

Terms in this article

Definitions in the Cognilium glossary.

Frequently Asked Questions

Find answers to common questions about the topics covered in this article.

Read the exclusion as a hard stop rather than a performance note. A Cloud Hosted Environment is a legitimate, commonly used development environment, and it will not run this. If your proof-of-concept plan starts on a CHE, it needs to move before it starts.
Microsoft's phrasing is "The product version of Dynamics 365 finance and operations apps must be at least" those three — so a proactive quality update on an older release qualifies you without a full version move.
Almost certainly not, and this is the prerequisite most people over-plan:
An allow-list is an explicit, per-client decision. Copilot Studio, Microsoft Foundry and non-Microsoft clients each have to be added; nothing arrives permitted. It is also the natural governance point — the list of platforms that may reach your ERP is a short, reviewable artefact, which is a rare thing in an integration story.
Not yet — and the wording of this limit matters more than most, because nothing stops you trying:
During servicing, and the failure is not graceful. It is limitation nine of ten:

Still have questions?

Get in touch with our team for personalized assistance.

Contact Us

Still have a question this did not answer?

The person who wrote this article answers these. Describe your setup and what you are stuck on — you will get a straight answer, including where we think the approach is wrong.

Related Articles

Continue exploring related topics and insights from our content library.

Data tools, form tools or action tools — which does your ERP agent need?
6 min
1
Ali Ahmed
September 9, 2026

Data tools, form tools or action tools — which does your ERP agent need?

Three tool families on the Dynamics 365 ERP MCP server, in the priority order Microsoft publishes: data tools for CRUD, form tools for what the app decides.

words
Read Article
Does the Dynamics 365 ERP MCP server truncate results?
5 min
2
Ali Ahmed
September 9, 2026

Does the Dynamics 365 ERP MCP server truncate results?

Form state carries at most twenty-five rows, and the warning is an instruction a builder can delete. The cap is on the form path, not the data path.

words
Read Article
Which model should a Dynamics 365 ERP agent run on?
5 min
3
Ali Ahmed
September 9, 2026

Which model should a Dynamics 365 ERP agent run on?

Microsoft names one recommended model for ERP MCP agents, one fallback and one to avoid. The recommended one is external, so an admin must approve it first.

words
Read Article

Explore More Insights

Discover more expert articles on AI, engineering, and technology trends.

Questions on this?

Talk to an engineer

Schedule a call