What you'll learn
How to add Cloverleaf as an MCP tool to an agent in Copilot Studio
How to publish that agent to Teams and Microsoft 365 Copilot
How to find, use, and sign in to Cloverleaf the first time, as an end user
How to verify the connection is working
Who can do this
Building the agent
A Copilot Studio maker or admin in your Microsoft 365 tenant. Your Cloverleaf organization admin also needs to have MCP enabled first — see Step 1 below.
Using the agent
Anyone with a Microsoft 365 Copilot license, once the agent has been published to your organization. Nothing to set up beyond signing in the first time.
Why connect Cloverleaf to Copilot?
Copilot is a general-purpose AI assistant with no knowledge of how you or your teammates think, communicate, or work best. Connecting the Cloverleaf Model Context Protocol (MCP) server gives Copilot access to your real assessment results and coaching insights — DISC, 16 Types, Motivating Values, and more.
That means coaching guidance you get inside Copilot is grounded in actual behavioral data rather than generic advice. Once connected, you can ask Copilot to help you prep for a 1:1, navigate a difficult conversation, or understand how two people work together, and get responses informed by your Cloverleaf Relationship Profiles.
Unlike Claude and ChatGPT, Microsoft doesn't have a public directory of MCP connectors yet, so Cloverleaf isn't something you pick from a list — a Copilot Studio maker adds it to an agent directly using its server URL, the same way you would in Claude Code or another MCP client.
Admin Setup
Step 1: Enable MCP in Cloverleaf
Before anyone can connect Copilot to Cloverleaf, a Cloverleaf organization admin needs to switch on the MCP integration. This is a one-time setting that applies to your whole organization, and it's separate from the Copilot Studio setup below.
In Cloverleaf, open your Organization Settings and go to Configuration > Integrations.
Find the Model Context Protocol (MCP) card.
Click Enable on the MCP card. Once it's on, the button switches to Disable — that's how you know MCP is active for your organization.
Only organization admins can see and change this setting. If you don't have access, ask a Cloverleaf admin in your organization to turn it on.
Step 2: Add Cloverleaf as an MCP tool in Copilot Studio
Copilot Studio needs an explicit Client ID and Client secret for Cloverleaf — unlike Claude and ChatGPT, it doesn't register a client automatically. Request OAuth credentials for your Copilot Studio agent from your Cloverleaf account team before you start.
The Copilot Studio agent builder — open an existing agent or create a new one, then find Tools in the right-hand panel.
In Copilot Studio, open the agent you want to add Cloverleaf to, or create a new one.
In the right-hand panel, find Tools and click +.
In the Add a tool dialog, filter to Model Context Protocol (MCP).
The Add a tool dialog, filtered to the Model Context Protocol (MCP) category.
Click + Add to define a new MCP server — Cloverleaf won't already be listed unless someone in your tenant has added it before.
In the Add MCP server dialog, fill in the fields below.
Field | Value |
Server name | Cloverleaf |
Server description | Cloverleaf Platform MCP |
Server URL | |
Authentication | OAuth 2.0 |
Configuration type | Manual |
Client ID | from your Cloverleaf account team |
Client secret | from your Cloverleaf account team |
Authorization URL | |
Token URL | |
Refresh token URL | |
Scopes | openid profile email offline_access mcp:full |
Server name, description, URL, and authentication set on the Add MCP server dialog.
Scrolled down: Client ID, Client secret, and the OAuth URLs and scopes.
Use Manual rather than Dynamic (with discovery) — dynamic discovery isn't reliable for Cloverleaf yet and can hang without connecting.
Click Add. Copilot Studio prompts you to create a connection — give it a display name and click Create.
Naming and creating the connection for the Cloverleaf MCP server.
Cloverleaf now appears in your agent's Tools list with a status of Ready.
The Cloverleaf tool showing Ready in Copilot Studio's Tools list.
Step 3: Publish the agent to Teams and Microsoft 365 Copilot
Click Publish in the top right of the agent builder.
In the Publish agent dialog, select the Teams + Microsoft 365 channel.
Under Turn on Microsoft 365, check Make agent available in Microsoft 365 Copilot.
Publishing to the Teams + Microsoft 365 channel, with availability in Microsoft 365 Copilot turned on.
Click Save and publish.
It can take a few hours for the agent to show up for everyone in your organization after publishing, so don't be surprised if it isn't visible to teammates right away.
You'll know the agent is set up when — the Cloverleaf tool shows Ready under Tools in the agent builder, and the agent's publish status shows Published with the Teams + Microsoft 365 channel turned on.
If Model Context Protocol (MCP) isn't available as a tool type yet
Some Copilot Studio environments haven't rolled out native MCP tools yet. If you don't see Model Context Protocol (MCP) as a category in the Add a tool dialog, you can add Cloverleaf as a Custom Connector instead, using a Generic OAuth 2 connection with the same server URL and OAuth values from the table above. Reach out to your Cloverleaf account team if you'd like help setting this up.
Everyone
Using Cloverleaf in Copilot, as an end user
Once your organization's agent is published, using it takes about a minute. Sign-in only happens once — after that, Copilot remembers you.
Step 1: Find the Cloverleaf agent
Your organization's agent may be named differently — at Cloverleaf, our internal agent is called Cloverleaf Internal. Swap in your own agent's name below.
Go to m365.cloud.microsoft/chat.
In the left rail, under Agents, look for your organization's Cloverleaf agent. If you don't see it, click More agents to open the Agent Store and search for it by name.
Searching “Cloverleaf” in the Agent Store — your organization may have more than one Cloverleaf agent listed.
Click the agent to open it.
The agent's landing page, with suggested conversation starters like “My daily coaching,” “Ask your coach,” and “DISC profile.”
Step 2: Start a conversation
Type a question, or click one of the suggested prompts (for example, DISC profile → “Render my DISC profile”). Copilot shows what it's about to do and asks you to confirm before it calls a Cloverleaf tool for the first time in a conversation — click Confirm.
Copilot asking to confirm the tool call — here, rendering a DISC profile widget — before it runs.
Step 3: Sign in when prompted
The first time you use a Cloverleaf tool, Copilot asks you to sign in.
Copilot prompting you to sign in before it can process the request.
Click Sign in to Cloverleaf.
A sign-in window opens and asks you to authorize Cloverleaf. Review the permissions and click Authorize.
The Cloverleaf authorization window — review the permissions, then click Authorize.
Close the window once you're signed in. Copilot picks up automatically and runs your original request.
You'll know it worked when — Copilot shows your real Cloverleaf data instead of asking you to sign in again. You only need to do this once; Copilot remembers your sign-in for future chats.
Real DISC score data returned after signing in — scores, style, and what it means, pulled from your actual Cloverleaf assessment.
What can I do once connected?
With the connector active, you can ask Copilot questions like:
You, in Copilot“What does my Cloverleaf DISC profile say about how I show up under pressure?”
You, in Copilot“Give me my coaching for today.”
You, in Copilot“Help me prep for a 1:1 with [teammate name].”
You, in Copilot“How should I give [teammate name] feedback about a missed deadline so it actually lands?”
You, in Copilot“Show me the relationship dynamics between me and [teammate name].”
Copilot will pull your real assessment data and interpreted personality dynamics directly into the conversation.
Troubleshooting
Symptom | Likely cause | What to do |
Cloverleaf doesn't appear in the Add a tool search in Copilot Studio | Not added to your environment yet, or MCP tools aren't rolled out | Follow Step 2 above to add it as a new MCP server, or use the Custom Connector fallback |
Copilot keeps re-asking you to “connect” in a loop, with no error | A stale or mismatched OAuth session | Sign out of Cloverleaf at app.cloverleaf.me (profile menu → Sign Out), then retry the request in Copilot so it re-prompts sign-in |
The tool call returns blank or generic answers instead of your data | Same as above, or the sign-in didn't complete | Retry, and make sure you fully complete the sign-in page before closing the popup |
You don't see the Cloverleaf agent in your agent list at all | Not yet propagated to your account, not published to your organization, or wrong tenant | Check More agents and search by name. If it's still missing, confirm with your Copilot Studio admin that the agent has been published — propagation can take a few hours |
If none of these fix it, contact your Cloverleaf account team or your internal IT/Copilot Studio admin with a screenshot of what you see.
