{"title":"Create agents in Copilot Studio that connect to Business Central","url":"https://jonas-paprotka.de/docs/dev-itpro/ai/create-agent-in-copilot-studio/","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/create-agent-in-copilot-studio, 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/create-agent-in-copilot-studio","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":"Create conversational agents in Copilot Studio that use Business Central data and automate business processes with natural language.","date":"2026-10-02","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Create agents in Copilot Studio that connect to Business Central","slug":"create-agents-in-copilot-studio-that-connect-to-business-central","at":0,"chars":13858},{"level":2,"title":"Overview","slug":"overview","at":306,"chars":2483},{"level":3,"title":"Connection options","slug":"connection-options","at":1703,"chars":1086},{"level":2,"title":"Prerequisites","slug":"prerequisites","at":2789,"chars":208},{"level":2,"title":"Create agents that use Business Central connector","slug":"create-agents-that-use-business-central-connector","at":2997,"chars":4502},{"level":3,"title":"Prerequisites for the connector","slug":"prerequisites-for-the-connector","at":3050,"chars":805},{"level":3,"title":"Exercise: Build an agent to find and create customers","slug":"exercise-build-an-agent-to-find-and-create-customers","at":3855,"chars":3064},{"level":3,"title":"Tips and best practices when using connector","slug":"tips-and-best-practices-when-using-connector","at":6919,"chars":580},{"level":2,"title":"Create agents that connect to the Business Central MCP server","slug":"create-agents-that-connect-to-the-business-central-mcp-server","at":7499,"chars":5895},{"level":3,"title":"Prerequisites for the MCP server","slug":"prerequisites-for-the-mcp-server","at":7697,"chars":754},{"level":3,"title":"Create the agent","slug":"create-the-agent","at":8451,"chars":3247},{"level":3,"title":"Tips and best practices for using the MCP server","slug":"tips-and-best-practices-for-using-the-mcp-server","at":11698,"chars":995},{"level":3,"title":"Troubleshoot tool discovery","slug":"troubleshoot-tool-discovery","at":12693,"chars":701},{"level":2,"title":"Related information","slug":"related-information","at":13394,"chars":464}],"text":"# Create agents in Copilot Studio that connect to Business Central\n> APPLIES TO: Business Central online\nThis article explains how to build, configure, and publish agents in Copilot Studio that integrate with Business Central using either the Business Central connector or the Business Central MCP server.\n## Overview\nCopilot Studio is a graphical, low-code tool for building agents and agent flows. You can use it to create conversational agents that understand and act on your business processes and data model in Business Central. Agents present Business Central data (customers, orders, invoices, and inventory) and business logic to users via natural language. Agents can automate tasks such as creating sales orders, checking credit, or posting payments, and trigger approvals or flows.\nBusiness Central provides two model-aware tools that agents can use to interact directly with Business Central environments: Business Central MCP (Model Context Protocol) server and Business Central Connector for Power Platform. These tools let agents read and write records, call custom APIs exposed by AL extensions, and apply server-side business logic such as pricing, discounts, and validation rules.\n![Shows how agents work between Business Central and Copilot Studio]<https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/media/integrate-copilot-studio.svg#lightbox>\nAfter you create an agent, you can publish agents into multiple platforms or channels, like live websites and Microsoft Copilot, or messaging platforms like Teams and Facebook.\nLearn more about Copilot Studio and agents in https://learn.microsoft.com/microsoft-copilot-studio/fundamentals-what-is-copilot-studio.\n### Connection options\nChoose a connection option based on the tasks that the agent must perform:\nOption|Best for|How the agent accesses Business Central|Considerations\nBusiness Central connector|Standard integration and low-code automation|You add predefined connector actions, such as finding, creating, or updating records, as individual tools.|The connector simplifies API access but offers less flexibility for advanced scenarios.\nBusiness Central MCP server|AI-driven workflows that discover and coordinate multiple tools|The agent uses tools generated from configured API pages and API queries in Business Central.|MCP configurations control the available APIs and permitted operations.\nBoth|Agents that need MCP discovery and explicitly configured connector actions|The agent uses tools from both connection options.|You can use a connector action when an API tool needs a custom description or explicit configuration.\nThe connector and MCP server act with the signed-in user's Business Central permissions. You can use either option independently or combine them in one agent.\n## Prerequisites\n You have a Copilot Studio user license with available Copilot Credits capacity for use. See Copilot Studio licensing<https://learn.microsoft.com/microsoft-copilot-studio/billing-licensing>.\n## Create agents that use Business Central connector\n### Prerequisites for the connector\n You have a Business Central account with permission to access the companies and data that the agent uses.\n You can create a Business Central connection in Copilot Studio.\nYou can use the Business Central connector actions, like `Create Record` or `List Companies`, in your agent by adding them as tools. Tools are the building blocks that enable your agent to interact with external systems, in this case, Business Central. For example, if you want to create an agent that lists, creates, and updates items in Business Central, add the `Find records`, `Create Record`, and `Update Record` actions as tools to the agent.\nLearn more about the connector and its actions in Dynamics 365 Business Central Connector<https://learn.microsoft.com/connectors/dynamicssmbsaas/>.\n### Exercise: Build an agent to find and create customers\nFollow the steps in this exercise to create an agent that uses the Dynamics 365 Business Central connector. The agent lets users get information about customers in Business Central and create new ones by providing instructions in plain language. The agent uses one read action `Find records (V3)` and one write action `Create record (V3)` of the Business Central connector. You can extend it by adding more connector actions (like `Update record (V3)`, `Delete record (V3)`) and refining the prompt-handling to cover more business scenarios.\n1. Create new or open existing agent.\n 1. Sign in to Copilot Studio<https://copilotstudio.microsoft.com/>.\n 1. In the left-side navigation pane, select Agents.\n 1. Select the agent you want to modify or select New agent to create a new agent.\n Learn more about creating agents in Create an agent in Copilot Studio<https://learn.microsoft.com/microsoft-copilot-studio/authoring-first-bot?tabs=web#create-an-agent>.\n1. Add the Business Central connector actions as tools.\n 1. On the Tools tab of the agent page, select + Add a tool.\n 1. Under the Search for tool box, choose Connector, then search for \"Dynamics 365 Business Central\".\n 1. Select the connector action `Find records (V3)`. The Add tool page opens.\n 1. If the Connection box displays the `Not connected`, select the box, select Create new connection and sign in to Business Central with a valid account.\n 1. Select Add to agent. You return to the agent Overview tab.\n 1. Repeat to add the connector action `Create record (V3)`. This agent uses this action to create a Customer record.\n See Use connectors in Copilot Studio<https://learn.microsoft.com/microsoft-copilot-studio/advanced-connectors>.\n1. Configure the tools.\n 1. On the Tools tab of the agent page, select the `Find records (V3)` to open the tool for editing.\n 1. Go to Inputs and configure the required input values:\n  Input name|Fill using|Value\n  -|-|-\n  Environment|Custom value|Set to Business Central environment, for example, PRODUCTION\n  Company|Custom value|Set to Business Central environment, for example, `CRONUS USA, Inc.`\n  API category|Custom value|V2.0\n  Table name|Custom value|customers\n 1. Select Save.\n 1. Repeat for the `Create record (V3)` tool.\n See https://learn.microsoft.com/microsoft-copilot-studio/advanced-plugin-actions#view-and-make-changes-to-your-tool-configuration.\n1. Test the agent.\n 1. Select Test in the upper-right corner of any page to open the Test your agent pane.\n 1. In the field at the bottom, enter text that explains what you want the agent to do, for example:\n   `List customers`\n   `Show my top customer`\n   `Create a customer named jesse homer with email jesse.homer@contoso.com`\n 1. Wait for the response.\n 1. Make necessary changes and save.\n See Test your agent<https://learn.microsoft.com/microsoft-copilot-studio/authoring-test-bot>.\n1. Publish and deploy the agent.\n See Publish agents<https://learn.microsoft.com/microsoft-copilot-studio/publication-fundamentals-publish-channels>.\n### Tips and best practices when using connector\n Permissions: The connection uses the signed-in account's Business Central permissions; ensure the account can read companies and create customers.\n Validation: Use server-side validation rules in Business Central (pricing/validation). The connector surfaces errors; handle these errors in agent responses.\n Inputs: Validate and sanitize user input before calling Create record (that is, ensure required fields are present).\n Logging: Use the agent's execution logs to troubleshoot tool calls and to see request/response payloads.\n## Create agents that connect to the Business Central MCP server\nThe Business Central MCP server enables agents in Copilot Studio to access Business Central data and capabilities through MCP tools.\n### Prerequisites for the MCP server\nBefore you connect an agent to the Business Central MCP server, make sure that:\n The Business Central MCP server is enabled in the Business Central environment.\n You have a Business Central account with permission to use the API objects and data that the agent accesses.\n If the agent only needs to read data from eligible API pages and API queries, you don't need to create an MCP server configuration. The built-in default configuration provides this access. To let the agent create, update, or delete data or invoke API actions, configure the required operations on the MCP server. See configure-mcp-server.\nFollow these steps to create an agent in Copilot Studio that connects to the Business Central MCP server.\n### Create the agent\n1. Create a new agent or edit an existing agent\n Sign in to Copilot Studio and create an agent in Copilot Studio or open an existing agent. See Create and delete agents<https://learn.microsoft.com/microsoft-copilot-studio/authoring-first-bot>.\n1. Connect the agent to the Business Central MCP server\n Add Dynamics 365 Business Central MCP Server as a tool for the agent. If a connection isn't already established, create a connection and sign in to Business Central.\n See https://learn.microsoft.com/microsoft-copilot-studio/add-tools-custom-agent.\n Configure the following inputs for the Business Central MCP server:\n Field|Description\n Environment|The Business Central environment that the agent connects to.\n Company|The company in Business Central that the agent connects to.\n MCP Server Configuration|Optional. The MCP server configuration that determines the API objects and operations available to the agent. Leave this field blank to use the current default configuration.\n> NOTE\n> Copilot Studio determines the tenant from the signed-in connection. Environment and Company are required. MCP Server Configuration is optional.\nThe tools available to the agent depend on the MCP server configuration:\n If you leave MCP Server Configuration blank, the agent uses the current default configuration. The built-in default configuration uses dynamic tool mode and provides read-only access to eligible API pages and API queries.\n If you select a configuration that uses dynamic tool mode, the agent uses the bc_actions_search, bc_actions_describe, and bc_actions_invoke system tools to discover and invoke available API operations.\n If you select a configuration that doesn't use dynamic tool mode, tools for the API objects included in the configuration are exposed individually.\n If Data Query Tools (Preview) is enabled for the configuration, the agent also has access to bc_data_find_tables, bc_data_get_table_schema, bc_data_get_table_relations, and bc_data_query.\n  Learn more about Business Central MCP server configurations, permissions, dynamic tool mode, and how Business Central API objects are exposed as MCP tools in configure-mcp-server.\n1. Add instructions.\n Add instructions that describe how the agent should use the available Business Central tools. For example:\n ```text\n You are a Business Central agent. The user will ask a question, ask you to perform a task, or ask you to retrieve data.\n\n Start with a brief plan, and then use the available tools to retrieve the relevant information. Explain the actions you take and summarize the result for the user.\n\n Prefer using semantic search when searching for available actions.\n ```\n See Write agent instructions<https://learn.microsoft.com/microsoft-copilot-studio/authoring-instructions>.\n1. Preview and test the agent\n Preview the agent to verify that it can access the expected Business Central data and operations.\n See Test an agent<https://learn.microsoft.com/microsoft-copilot-studio/agents-experience/authoring-test-bot>.\n1. Publish the agent\n When the agent works as expected, publish it and make it available through the appropriate channels.\n See https://learn.microsoft.com/microsoft-copilot-studio/agents-experience/publication-publish-agent.\n### Tips and best practices for using the MCP server\nTo improve results when using the Business Central MCP server with Copilot Studio:\n Use a model that supports tool use and complex business tasks. See Agent models in Business Central<ai-agent-models>.\n Give the agent clear instructions about how to use the Business Central tools.\n Ensure the signed-in user has the Business Central permissions required for the data and operations that the agent uses.\n After you change the MCP server configuration, refresh the available tools in Copilot Studio to reflect the current configuration.\n To get a list of available API pages in a Business Central environment, open the Page Metadata virtual table (ID 2000000138) in the Business Central web client by using the following URL, customized for the environment the agent connects to:\n  ```http\n  https://businesscentral.dynamics.com/<tenant ID>/<environment name>?table=2000000138\n  ```\n  Filter the list by Page Type = API and APIVersion = v2.0.\n### Troubleshoot tool discovery\nIf the expected Business Central tools aren't available to the agent:\n Verify that the signed-in user can access the selected environment and company.\n Verify that the user has permission to access the API objects exposed by the MCP server configuration.\n Verify that you selected the expected MCP server configuration or set the appropriate configuration as the default.\n Refresh the available tools after changing the MCP server configuration.\n Copilot Studio handles Base64 encoding for non-ASCII Company and ConfigurationName values. If you use a client that doesn't, ensure you encode non-ASCII headers by using MCP Base64 encoding syntax (`=?base64?<base64>?=`).\n## Related information\nModel Context Protocol (MCP) in Business Central<mcp-overview>\nConfigure Business Central MCP Server<configure-mcp-server>\nDynamics 365 Business Central connector<https://learn.microsoft.com/connectors/dynamicssmbsaas/>\nCopilot Studio overview<https://learn.microsoft.com/microsoft-copilot-studio/fundamentals-what-is-copilot-studio>\nTransparency note: Semantic Metadata Search in Business Central<transparency-note-semantic-metadata-search>"}