Hidden
This guide explains how to make MAiDATA available in Microsoft Teams and Microsoft 365 Copilot. Microsoft Copilot connects to MCP servers through agents built in Microsoft Copilot Studio, so the integration consists of a dedicated MAiDATA agent created in your Microsoft tenant and connected to the MAiDATA MCP server.
The setup is performed once by your administrators. Users then open the MAiDATA agent in Teams or Microsoft 365 Copilot and sign in with their own MAiDATA account.
Before you begin
Administrators need:
Access to an Azure subscription with permission to create resource groups.
The Power Platform administrator role in the Power Platform admin center.
Access to Microsoft Copilot Studio.
The connection details from OAKS, delivered through a secure channel: MAiDATA server URL, OAuth client ID, client secret, authorisation, token and refresh URLs, scopes, and agent instructions.
Each user needs a MAiDATA account. To request accounts, see Support.
Billing
Copilot Studio agents are metered by Microsoft in Copilot Credits. The recommended setup links the agent’s Power Platform environment to a pay-as-you-go billing plan, billed monthly in arrears to your Azure subscription. Microsoft’s Copilot Credit charges are separate from the MAiDATA subscription. Consult Microsoft’s published Copilot Studio pricing for current rates.
Choosing regions
Select regions in this order of priority: data-residency or compliance requirements, user location, location of your existing Microsoft environment, and service availability. For an organisation in the Czech Republic without special requirements:
Setting | Recommended value |
Resource group region | (Europe) West Europe |
Billing plan region | Europe |
Environment region | European Union & EFTA |
The billing plan and the environment must be in matching regions.
Setup overview
Step | Where | Action |
1 | Azure portal | Create a resource group, for example |
2 | Power Platform admin center | Create a pay-as-you-go billing plan linked to the resource group. |
3 | Power Platform admin center | Create an environment billed to that plan, for example |
4 | Copilot Studio | Create the MAiDATA agent in the new environment. |
5 | Copilot Studio | Add the MAiDATA MCP connection to the agent. |
6 | Copilot Studio | Publish the agent to Microsoft Teams and Microsoft 365 Copilot. |
7 | Power Platform admin center | Add users to the environment with the Basic User role. |
8 | Copilot Studio | Share the agent with the users. |
9 | Power Platform admin center | Set the monthly cost limit for the agent. |
10 | Teams or Microsoft 365 Copilot | Test the connection. |
Step 1 — Create a resource group
In the Azure portal, open Resource groups and select Create.
Select your subscription, enter the resource group name and choose the region (see Choosing regions).
Select Review + create, then Create.
Step 2 — Create a billing plan
In the Power Platform admin center, open Licensing → Billing plans → New billing plan.
Enter a name, for example
<COMPANY>-COPILOT-PAYG, then select your Azure subscription and the resource group from Step 1.Under Meter, select Dataverse and Copilot Studio, and select Next.
Select the region and select Save.
Step 3 — Create the environment
Open Manage → Environments → New.
Enter the name, select the type (Sandbox for testing, Production for live use) and select the region.
Under Change default settings, set Add a Dataverse data store? to Yes and Pay-as-you-go with Azure? to Yes.
Under Billing policy, select the billing plan from Step 2, then select Next and Save.
Wait until the environment shows State: Ready.
Step 4 — Create the agent
Open Copilot Studio and select the environment from Step 3 in the environment selector.
Create a new agent named MAiDATA.
Enter a description and paste the agent instructions supplied by OAKS.
Step 5 — Add the MAiDATA MCP connection
In the agent, open Tools → Add a tool → Model Context Protocol (MCP).
Enter MAiDATA as the server name, the description below and the server URL
https://www.maidata.oaks.cz/mcp.Under Authentication, select OAuth 2.0, and under Configuration type, select Manual. Enter the client ID, client secret, authorisation URL, token URL, refresh URL and scopes supplied by OAKS.
Select Add and test the tool in the agent’s Preview panel.
Server description:
MAiDATA gives you direct, conversational access to Czech pharmaceutical market data, covering reimbursed medicinal products, SÚKL distribution and eRecept flows, and medical devices. Ask questions in plain language and receive any output based on your need in seconds.
Step 6 — Publish the agent
Select Publish and wait for the status Published.
Under Channels, add Microsoft Teams and Microsoft 365 Copilot.
Step 7 — Add users to the environment
In the Power Platform admin center, open the environment and select Settings → Users + permissions → Users → Add user.
Add each user and assign the Basic User role. Maker or author roles are not required.
Step 8 — Share the agent
In Copilot Studio, open the agent, select Share and add each user as a user of the agent (not as a co-owner or editor).
Step 9 — Set the cost limit
In the Power Platform admin center, open Licensing → Copilot Studio → Manage agents.
Open the … menu next to the MAiDATA agent and select Set limit.
Configure the limit:
Control | Recommended setting |
Capacity limit | The agreed number of Copilot Credits per month |
Stop usage | Turn off the agent when consumption reaches 100% |
Overage notification | Notify administrators at 80% |
Step 10 — Test the connection
With a user account from Steps 7 and 8, open the MAiDATA agent in Microsoft Teams or Microsoft 365 Copilot.
Ask a question that requires MAiDATA data.
When Connection required appears, select Set up connection, sign in with the MAiDATA account, then select Retry.
Confirm that the agent returns MAiDATA data.
Using MAiDATA in Copilot
Users open the MAiDATA agent in Teams or Microsoft 365 Copilot and ask questions in plain language. The agent calls MAiDATA, receives the result table, the generated SQL and the source metadata, and formulates the answer.
Removing access
Remove a user: stop sharing the agent with the user or remove the user from the environment.
Disable the integration: disable the MAiDATA tool or unpublish the agent in Copilot Studio, apply Power Platform data policies, or delete the environment.
Disable a MAiDATA account: contact OAKS through Support.
Data handling in Microsoft Copilot
The agent, its configuration, connections and conversation data reside in the Power Platform environment in your tenant, in the region you selected. MAiDATA receives only the data questions the agent sends through the MAiDATA tools and has no access to your e-mails, files, Teams messages or other Microsoft 365 content. See Security and data handling.
Related pages
Getting started
Connect your assistant
Reference
Security and privacy
