MAiDATA

Hidden

Connect from Microsoft Copilot

Connect from Microsoft Copilot

Connect from Microsoft Copilot

Create the MAiDATA agent in Copilot Studio.

Create the MAiDATA agent in Copilot Studio.

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 rg-<company>-copilot.

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 MAiDATA-<Company>.

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

  1. In the Azure portal, open Resource groups and select Create.

  2. Select your subscription, enter the resource group name and choose the region (see Choosing regions).

  3. Select Review + create, then Create.

Step 2 — Create a billing plan

  1. In the Power Platform admin center, open Licensing → Billing plans → New billing plan.

  2. Enter a name, for example <COMPANY>-COPILOT-PAYG, then select your Azure subscription and the resource group from Step 1.

  3. Under Meter, select Dataverse and Copilot Studio, and select Next.

  4. Select the region and select Save.

Step 3 — Create the environment

  1. Open Manage → Environments → New.

  2. Enter the name, select the type (Sandbox for testing, Production for live use) and select the region.

  3. Under Change default settings, set Add a Dataverse data store? to Yes and Pay-as-you-go with Azure? to Yes.

  4. Under Billing policy, select the billing plan from Step 2, then select Next and Save.

  5. Wait until the environment shows State: Ready.

Step 4 — Create the agent

  1. Open Copilot Studio and select the environment from Step 3 in the environment selector.

  2. Create a new agent named MAiDATA.

  3. Enter a description and paste the agent instructions supplied by OAKS.

Step 5 — Add the MAiDATA MCP connection

  1. In the agent, open Tools → Add a tool → Model Context Protocol (MCP).

  2. Enter MAiDATA as the server name, the description below and the server URL https://www.maidata.oaks.cz/mcp.

  3. 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.

  4. 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

  1. Select Publish and wait for the status Published.

  2. Under Channels, add Microsoft Teams and Microsoft 365 Copilot.

Step 7 — Add users to the environment

  1. In the Power Platform admin center, open the environment and select Settings → Users + permissions → Users → Add user.

  2. 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

  1. In the Power Platform admin center, open Licensing → Copilot Studio → Manage agents.

  2. Open the … menu next to the MAiDATA agent and select Set limit.

  3. 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

  1. With a user account from Steps 7 and 8, open the MAiDATA agent in Microsoft Teams or Microsoft 365 Copilot.

  2. Ask a question that requires MAiDATA data.

  3. When Connection required appears, select Set up connection, sign in with the MAiDATA account, then select Retry.

  4. 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