Connecting Fracttal One with Microsoft Copilot Studio allows you to query your maintenance data in natural language within the Microsoft 365 ecosystem, without leaving Copilot. The connection is made from an agent created in Copilot Studio, using the MCP (Model Context Protocol) with OAuth 2.0 authentication, and the agent accesses Fracttal with the same permissions as the authenticated user.
Requirements
Active Fracttal One account with administrator permissions or access to Settings.
Access to the API Connections section within Fracttal One.
Microsoft Copilot Studio license with maker permissions in the Power Platform environment.
A permission group defined in Fracttal One with the data scope you want to expose to the agent.
Fracttal One connection data
These values are fixed and you will use them during the configuration in Copilot Studio.
| Field | Value |
|---|---|
| MCP server URL | https://one.fracttal.com/mcp/oauth/fracttal-one |
| Authorization URL | https://one.fracttal.com/oauth/authorize |
| Token URL | https://one.fracttal.com/oauth/token |
| Refresh URL | https://one.fracttal.com/oauth/token |
| Scopes | Leave empty. Fracttal One controls the scope through the permission group. |
Note: The authorization and token URLs are at the root of the domain. They do not include /api/ or /mcp/ in the path.
Step by step
Create the MCP server in Copilot Studio
In your agent, go to Tools › Add a tool › New tool › Model Context Protocol.
Fill in the fields:
| Field | Value |
|---|---|
| Name | Fracttal One (or any name you prefer) |
| Server description | A clear description of what the server does. The agent uses this text to decide when to query Fracttal One. |
| Server URL | https://one.fracttal.com/mcp/oauth/fracttal-one |
| Authentication | OAuth 2.0 |
| Type | manual |
Important: The Type field offers three options and only manual works with Fracttal One. The Dynamic detection option tries to locate the configuration automatically and the Dynamic option tries to register the client on its own, which Fracttal One rejects for security reasons.
Create the OAuth consumer in Fracttal One
In another tab, log in to Fracttal One. In the upper right corner, click the user menu and select Settings. In the side menu, select API Connections and then click the OAuth Consumers tab.
Click the (+) button to add a new consumer and fill out the form:
| Field | Value |
|---|---|
| Authorization type | Authorization code |
| Name | The connection name you prefer (e.g., COPILOT MCP) |
| Redirect URL | https://global.consent.azure-apim.net/redirect (temporary value, you will replace it in Step 5) |
| Permission Group | Select the desired permission group. However, the system will use the permissions of the authenticated user. |
Once the form is completed, click the Save icon in the upper right corner.
Copy the generated key and secret
Upon saving, Fracttal One automatically generates a Key and a Secret for the consumer.
Important: The Secret is shown only once and grants read and write access to the data of the selected permission group. Save both values in a password manager and do not share them in screenshots or messages. If the secret is exposed, create a new consumer and replace the credentials.
Complete the manual authentication in Copilot Studio
Return to the Copilot Studio window, with Type set to manual, and fill in the fields:
| Field | Value |
|---|---|
| Client ID | Paste the Key generated in Step 3 |
| Client secret | Paste the Secret generated in Step 3 |
| Authorization URL | https://one.fracttal.com/oauth/authorize |
| Token URL template | https://one.fracttal.com/oauth/token |
| Refresh URL | https://one.fracttal.com/oauth/token |
| Scopes | Leave empty |
Click Create. Copilot Studio generates a unique Redirect URL that combines the Azure base URL with a connector identifier suffix.
Synchronize the redirect URL in Fracttal One
Copy the full redirect URL generated by Copilot Studio. Go back to Fracttal One, open the OAuth consumer created in Step 2, replace the Redirect URL field value with the full URL including the suffix, and click Save.
Important: Fracttal One compares the redirect URL character by character. If the consumer keeps the base URL, authorization will fail with a redirect URL mismatch error. If the error persists, try adding or removing the trailing slash (/).
Connect and authorize
On the Add tool screen in Copilot Studio, expand the Connection selector and choose to create the connection. A Fracttal One authorization window opens, where you must log in and confirm access permissions.
After authorizing, a green indicator appears next to the connection name and the Add and configure button becomes available.
Validate the connection with a real query
In the agent configuration, confirm that generative orchestration is enabled. Without it, the agent recognizes Fracttal One tools but does not execute them.
Ask a simple and verifiable question and compare the result with what you see in Fracttal One.
Done! You now have Fracttal One connected to your Microsoft Copilot agent.
Notes:
Using this integration may involve consumption, limits, or charges associated with Microsoft services. These costs and conditions are determined exclusively by Microsoft.
The agent may request confirmation before performing write actions (create, modify, or delete records). Always review proposed actions before confirming them.
The user is responsible for validating and monitoring actions, automations, and results generated through third-party platforms connected to Fracttal, including those derived from instructions, configurations, prompts, or flows defined in those platforms.