[toc]
Introduction
The Cupix Compass Model Context Protocol (MCP) server lets a Microsoft Copilot Studio agent read your CupixWorks project data and answer questions about it in natural language. This article walks a Team Admin through connecting the Compass MCP server to a Copilot Studio agent, enabling its tools, testing it, and publishing it to Microsoft Teams and Microsoft 365 Copilot.
Note: Team Admin permission is required to create a Compass agent for your team.
Prerequisites
Before you start, make sure you have:
- A Microsoft 365 Copilot license assigned to the Team Admin.
- The Environment Maker or Agent Author role in the target Copilot Studio environment.
- Team Admin permission in CupixWorks.
- Your Cupix team domain and a Cupix account (email and password) with access to CupixCompass.
- Access to the mailbox for that Cupix account. Sign-in requires a verification code sent by email.
How It Works
The setup has six stages. The steps below map to them in order.
| Stage | What happens |
|---|---|
| License | Assign a Microsoft 365 Copilot license to the Team Admin. |
| Role | Grant that admin the Environment Maker or Agent Author role in the Copilot Studio environment. |
| Create | The admin creates a new agent in Copilot Studio. |
| Connect | Add the Compass MCP server as a tool and authenticate with Cupix. |
| Test | Run a test prompt to confirm the tools respond. |
| Publish | Publish the agent to Teams and Microsoft 365 Copilot for the team to use. |
Create the Agent
1. Create an agent
- Go to https://copilotstudio.microsoft.com/ and sign in.
- Click New agent, then give the agent a name.
Add the Compass MCP Server
2. Add a tool
- On the agent page, under Tools, add a tool. In the Add a tool dialog, click Add.
3. Select Model Context Protocol
- Select Model Context Protocol (MCP).
4. Enter the server details
- Fill in the fields using the values below.
- Set Configuration type to Dynamic (with discovery), then click Add.
| Field | Value |
|---|---|
| Server name | Any string |
| Server description | Any string |
| Server URL | The MCP server URL for your region - see the table below |
| Authentication | OAuth 2.0 |
| Configuration type | Dynamic (with discovery) |
| Region | MCP server URL |
|---|---|
| US | https://mcp.cupix.works/mcp |
| AU | https://mcp.cupix-au.works/mcp |
Note: With Dynamic (with discovery), Copilot Studio reads the OAuth settings from the Compass server through Dynamic Client Registration (DCR). The Dynamic and Manual options ask you to enter an Authorization URL and a Token URL by hand, which is no longer needed. If you are not sure which region your team is in, contact your Cupix Customer Success Manager.
Connect Your Cupix Account
5. Create a new connection
- In Select a connection, open the Connection list and click Create new connection.
6. Confirm the connection
- Optionally enter a display name, then click Create. A CupixWorks sign-in window opens.
7. Sign in to CupixWorks
- Enter your team domain and click Next.
- Enter your Cupix email and password, then enter the verification code sent to that address.
8. Add the tool
- When Connection shows your connection, click Add.
Confirm the Tool
9. Check that the tool is listed
The Compass MCP server now appears under Tools on the agent page. The agent can call it in conversations.
Test the Agent
10. Run a test prompt in Preview
- Open the Preview tab at the top of the agent page.
- Enter a prompt such as List my projects in my team. The agent calls the matching Compass tool and returns your data.
Publish to Teams and Microsoft 365 Copilot
11. Publish the agent
- Click Publish at the top right of the agent page, then click Publish agent.
12. Add a channel
- When Your agent is published appears, click Add channels to make the agent available to people, or Done to add channels later.
Use the Microsoft guides below to roll the agent out to Teams and Microsoft 365 Copilot.
| Task | Microsoft guide |
|---|---|
| Channels > Teams and Microsoft 365 Copilot > Make agent available > Add channel | Connect an agent to Teams and Microsoft 365 Copilot |
| See agent in Teams > Add | Install an agent in Teams and Microsoft 365 Copilot |
| Grant the "User - can use the agent" permission to users or security groups | Share an agent for chat |
| Availability options > Copy link | Share a link so others can install an agent |
| Expose the agent to shared users in the Teams App Store | Show to shared users in Teams |
| Submit for admin approval to deploy across the organization | Submit an agent for admin approval |
Troubleshooting
The agent replies that it needs a connection
If the agent replies with the message below, the connection is not authenticated yet. Click Open connection manager in the message.
“Let’s get you connected first, and then I can find that info for you. Open connection manager to verify your credentials. Once the connection is ready, retry your request.”
In Manage your connections, find the Compass connection. If the status is Not Connected, click Connect and sign in again.
Return to the chat and click Retry. The agent runs the prompt again using the restored connection.