{"title":"Connect to Business Central MCP server with GitHub Copilot CLI and non-Microsoft hosts","url":"https://jonas-paprotka.de/docs/dev-itpro/ai/use-mcp-server-non-microsoft/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/ai/use-mcp-server-non-microsoft, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/ai/use-mcp-server-non-microsoft","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to connect non-Microsoft MCP hosts like ChatGPT and Claude to Business Central MCP server with step-by-step guidance and prerequisites.","date":"2026-10-02","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Connect to Business Central MCP server with GitHub Copilot CLI and non-Microsoft hosts","slug":"connect-to-business-central-mcp-server-with-github-copilot-cli-and-non-microsoft-hosts","at":0,"chars":11482},{"level":2,"title":"Prerequisites","slug":"prerequisites","at":681,"chars":892},{"level":2,"title":"Determine the redirect URI","slug":"determine-the-redirect-uri","at":1573,"chars":861},{"level":2,"title":"Register an application in Microsoft Entra ID","slug":"register-an-application-in-microsoft-entra-id","at":2434,"chars":2518},{"level":2,"title":"Connect the MCP host to the Business Central MCP server","slug":"connect-the-mcp-host-to-the-business-central-mcp-server","at":4952,"chars":3890},{"level":3,"title":"Claude Code example","slug":"claude-code-example","at":7250,"chars":550},{"level":3,"title":"GitHub Copilot CLI example","slug":"github-copilot-cli-example","at":7800,"chars":1042},{"level":2,"title":"Check available configurations and tool parameters","slug":"check-available-configurations-and-tool-parameters","at":8842,"chars":1586},{"level":2,"title":"Record and retrieve Microsoft Entra app registrations for MCP hosts","slug":"record-and-retrieve-microsoft-entra-app-registrations-for-mcp-hosts","at":10428,"chars":806},{"level":2,"title":"Related information","slug":"related-information","at":11234,"chars":248}],"text":"# Connect to Business Central MCP server with GitHub Copilot CLI and non-Microsoft hosts\n> APPLIES TO: Business Central online\nThis article explains how to connect MCP hosts that don't have built-in Business Central support, like GitHub Copilot CLI, Claude, and ChatGPT, to the Business Central MCP server. You connect these MCP hosts directly to the Business Central MCP server URL. This approach requires a registered application in Microsoft Entra ID and manual client configuration. You can use an existing application that meets the requirements or register a new application.\nLearn more about the MCP server in Model Context Protocol (MCP) in Business Central<mcp-overview>.\n## Prerequisites\n If the MCP host doesn't support omitting TenantId, you have the Microsoft Entra tenant ID for the Business Central environment.\n You have access to a Microsoft Entra application for the MCP host. Choose one of these paths:\n   Use an existing application: Get its application (client) ID. The application must include the MCP host's redirect URI and the delegated Financials.ReadWrite.All permission for Dynamics 365 Business Central. A tenant administrator must grant consent for the permission.\n   Register a new application: You need an account in the Microsoft Entra tenant with at least the https://learn.microsoft.com/entra/identity/role-based-access-control/permissions-reference#application-developer role. You must also be a tenant administrator or have access to one who can grant consent for the required permission. Follow the registration steps in this article.\n## Determine the redirect URI\nIf you use an existing application that already includes the MCP host's redirect URI and required permission, skip to #connect-the-mcp-host-to-the-business-central-mcp-server.\nBefore you register an application in Microsoft Entra ID, determine the redirect URI for the MCP host. The redirect URI, also known as the callback URL, can be different for each MCP host.\nCheck the MCP host's documentation for the required redirect URI. Many MCP hosts use a local HTTP port in the URI, such as `http://localhost:<port>/callback`.\nFor example:\n With Claude Code, the redirect URI is `http://localhost:<port>/callback`, like `http://localhost:33418/callback`.\n With GitHub Copilot CLI, use `http://localhost:<port>`, like `http://localhost:33418`.\nThe port you choose must match the redirect port in the MCP host connection configuration.\n## Register an application in Microsoft Entra ID\n> NOTE\n> Why is this needed? The MCP specification supports Dynamic Client Registration (DCR), which allows clients to register themselves automatically with an authorization server. However, Microsoft Entra ID doesn't support DCR, so you must register an application for authentication.\nA user with the Application Developer role can register the application. A tenant administrator must grant consent for the Business Central API permission. You can use the same app registration for different clients.\n1. Sign in to the Microsoft Entra admin center<https://entra.microsoft.com>.\n1. Create the app registration:\n 1. Browse to Microsoft Entra ID > App registrations > New registration.\n 1. In the Name field, enter a meaningful name for the app, for example BC MCP - Claude.\n 1. Set the Supported account types field to Multiple Entra ID tenants and then select Allow all tenants.\n 1. Select Register.\n 1. The app's Overview page is displayed. Copy the Application (client) ID for later.\n See Register an application in Microsoft Entra ID<https://learn.microsoft.com/entra/identity-platform/quickstart-register-app>.\n1. Add the redirect URI of the MCP host to the app registration.\n Use the redirect URI that you determined earlier. See #determine-the-redirect-uri.\n 1. Select Authentication > + Add Redirect URI > Mobile and desktop applications platform.\n 1. In the Add Redirect URI pane, enter the MCP host's redirect URI.\n See How to add a redirect URI to your application<https://learn.microsoft.com/entra/identity-platform/how-to-add-redirect-uri>.\n1. Add API permissions to Business Central.\n 1. Select API permissions > + Add permission.\n 1. On the Microsoft APIs tab, select Dynamics 365 Business Central > Delegated permissions.\n 1. Select the Financials.ReadWrite.All checkbox, and then select Add permissions.\n 1. If you're a tenant administrator, select Grant admin consent for your tenant. Otherwise, ask a tenant administrator to complete this step.\n See Configure app permissions for a web API<https://learn.microsoft.com/entra/identity-platform/quickstart-configure-app-access-web-apis>.\n1. (Optional) Record information about the registered app in the Model Context Protocol (MCP) Server Entra Applications page in Business Central. See Record and obtain Microsoft Entra app registrations for MCP hosts<#record-and-retrieve-microsoft-entra-app-registrations-for-mcp-hosts>.\n This step is for convenience only and isn't required for app registration.\n## Connect the MCP host to the Business Central MCP server\nAfter an app is registered for MCP hosts, you can connect clients to the Business Central MCP server. Refer to your MCP host's documentation for the specific configuration steps for connecting to MCP servers. Use the following information as needed:\nSetting|Value\nBusiness Central MCP server URL|`https://mcp.businesscentral.dynamics.com`\nTransport|Streamable HTTP. HTTP/SSE transport isn't supported.\nClient ID|The application (client) ID of the registered app in Microsoft Entra used for authentication.\nProvide the following information as needed to connect to the Business Central environment and MCP server configuration:\nHTTP header|Description|Example\nTenantId|The Microsoft Entra tenant to use. Required unless the MCP host supports omitting it.|`aaaabbbb-0000-cccc-1111-dddd2222eeee`\nEnvironmentName|The Business Central environment to use. Required unless the MCP host supports omitting it.|Production\nCompany|The company to use. Required unless the MCP host supports omitting it.|`CRONUS USA, Inc.` (ASCII)<br><br>`=?base64?Q3JvbnVzIMOFcmh1cyBBL1M=?=` (Base64-encoding of `CRONUS Århus A/S`)\nConfigurationName|Optional. The MCP server configuration in the environment to use. If omitted or empty, the server uses the current default configuration.|SalesTeamConfig<br><br>`=?base64?w4VyaHVzU2FsZXNUZWFtQ29uZmln?=` (Base64-encoding of `ÅrhusSalesTeamConfig`)\n> NOTE\n> MCP hosts that support headerless Business Central connections can omit TenantId, EnvironmentName, Company, and ConfigurationName. For example, Visual Studio Code with GitHub Copilot supports omitting all four headers.\n> If the Company or ConfigurationName values contain non-ASCII characters (for example, `ø`, `æ`, or `å`), encode the values by using Base64 (UTF-8).\n> The encoded value must use the format `=?base64?<encodedvalue>?=`. See Base64 decoding in the MCP HTTP standard<https://modelcontextprotocol.io/seps/2243-http-standardization#base64-decoding>.\n> In Copilot Studio, you don't need to manually encode these values because the platform handles the encoding.\nThe following examples show how a configuration can look in different MCP hosts. Replace the sample values with the applicable header values, client ID, and redirect port for your setup.\n### Claude Code example\n```json\n{\n   \"mcpServers\": {\n      \"businesscentral\": {\n         \"type\": \"http\",\n         \"url\": \"https://mcp.businesscentral.dynamics.com\",\n         \"headers\": {\n            \"TenantId\": \"aaaabbbb-0000-cccc-1111-dddd2222eeee\",\n            \"EnvironmentName\": \"Production\",\n            \"Company\": \"CRONUS USA, Inc.\",\n            \"ConfigurationName\": \"SalesTeamConfig\"\n         },\n         \"oauth\": {\n            \"clientId\": \"bbbbcccc-1111-dddd-2222-eeee3333ffff\",\n            \"callbackPort\": 33418\n         }\n      }\n   }\n}\n```\n### GitHub Copilot CLI example\nGitHub Copilot CLI supports omitting TenantId and Company but requires EnvironmentName. This example omits TenantId so the server determines the tenant from the signed-in identity. It omits Company so the agent can select an accessible company at runtime.\n```json\n{\n   \"mcpServers\": {\n      \"businesscentral\": {\n         \"type\": \"http\",\n         \"url\": \"https://mcp.businesscentral.dynamics.com\",\n         \"headers\": {\n            \"EnvironmentName\": \"Production\",\n            \"ConfigurationName\": \"SalesTeamConfig\"\n         },\n         \"tools\": [\n            \"*\"\n         ],\n         \"oauthClientId\": \"bbbbcccc-1111-dddd-2222-eeee3333ffff\",\n         \"oauthRedirectPort\": \"33418\",\n         \"oauthPublicClient\": true\n      }\n   }\n}\n```\n> NOTE\n> Because this example omits Company, Business Central uses dynamic tool mode for API tools. The MCP host can use list_companies to discover available companies, then use bc_actions_search, bc_actions_describe, and bc_actions_invoke with the required company parameter.\n## Check available configurations and tool parameters\nNon-Microsoft hosts can use the MCP protocol responses and the Business Central configuration endpoint to determine how to connect.\n `GET /$configurations`: Returns the active MCP server configurations for the authenticated tenant. The response includes fields such as name, description, default, enableApiTools, enableDynamicToolMode, discoverReadOnlyObjects, and enableAlQueryTools.\n MCP initialize: Returns server capabilities. Hosts that support Business Central headerless connections advertise and receive the `x-ms-headerless` experimental capability.\n MCP `tools/list`: Returns the tools for the supplied header context. When TenantId is absent, the server determines the tenant from the signed-in identity. When a host supports omitting Company and the header is absent, API tools use dynamic tool mode, operational tool schemas include the required company parameter, and the server includes the list_companies tool. When the host negotiates `x-ms-headerless`, tool schemas include the required environmentName parameter. If `tools/list` returns list_environments, use it to discover available environments.\nInclude TenantId unless your MCP host supports determining the tenant from the signed-in identity. Include EnvironmentName unless your MCP host supports Business Central headerless connections or provides its own environment picker. Include Company unless the host supports selecting a company at runtime. Including headers pins their values and avoids supplying environment and company parameters with each call.\n## Record and retrieve Microsoft Entra app registrations for MCP hosts\nIt's useful to record the application (client) ID of Microsoft Entra apps used for MCP host authentication. Users need this information to set up the connection from the MCP host to Business Central MCP server. Recording the information in Business Central is optional.\n1. Sign in to Business Central<https://businesscentral.dynamics.com/>.\n1. Search for and open the Model Context Protocol (MCP) Server Configurations<https://businesscentral.dynamics.com/?page=8350> page.\n1. Select Advanced > Entra Applications.\n The Model Context Protocol (MCP) Server Entra Applications page lists apps registered in Microsoft Entra for authenticating MCP host users.\n Copy the Client ID as needed, or select New to record another registered app.\n## Related information\nConfigure Business Central MCP Server<configure-mcp-server>\nUse Business Central MCP server with Visual Studio Code<use-mcp-server-in-vscode>\nUse Business Central MCP server with Copilot Studio<create-agent-in-copilot-studio>"}