Skip to main content

How do I connect Cloverleaf to Microsoft Copilot?

Cloverleaf connects to Microsoft Copilot through an agent built in Copilot Studio using the Model Context Protocol (MCP). Connecting it brings your real coaching data — DISC profile, daily coaching, teammate insights, and more — into Copilot.

J
Written by Josh Tomaino

What you'll learn

  1. How to add Cloverleaf as an MCP tool to an agent in Copilot Studio

  2. How to publish that agent to Teams and Microsoft 365 Copilot

  3. How to find, use, and sign in to Cloverleaf the first time, as an end user

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

  1. In Cloverleaf, open your Organization Settings and go to Configuration > Integrations.

  2. Find the Model Context Protocol (MCP) card.

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

IMG_AGENT_BUILDER

The Copilot Studio agent builder — open an existing agent or create a new one, then find Tools in the right-hand panel.

  1. In Copilot Studio, open the agent you want to add Cloverleaf to, or create a new one.

  2. In the right-hand panel, find Tools and click +.

  3. In the Add a tool dialog, filter to Model Context Protocol (MCP).

IMG_ADD_TOOL

The Add a tool dialog, filtered to the Model Context Protocol (MCP) category.

  1. Click + Add to define a new MCP server — Cloverleaf won't already be listed unless someone in your tenant has added it before.

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

IMG_MCP_DETAILS

Server name, description, URL, and authentication set on the Add MCP server dialog.

IMG_MCP_OAUTH

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.

  1. Click Add. Copilot Studio prompts you to create a connection — give it a display name and click Create.

IMG_CREATE_CONNECTION

Naming and creating the connection for the Cloverleaf MCP server.

  1. Cloverleaf now appears in your agent's Tools list with a status of Ready.

IMG_TOOL_READY

The Cloverleaf tool showing Ready in Copilot Studio's Tools list.


Step 3: Publish the agent to Teams and Microsoft 365 Copilot

  1. Click Publish in the top right of the agent builder.

  2. In the Publish agent dialog, select the Teams + Microsoft 365 channel.

  3. Under Turn on Microsoft 365, check Make agent available in Microsoft 365 Copilot.

IMG_PUBLISH

Publishing to the Teams + Microsoft 365 channel, with availability in Microsoft 365 Copilot turned on.

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

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

IMG_AGENT_STORE

Searching “Cloverleaf” in the Agent Store — your organization may have more than one Cloverleaf agent listed.

  1. Click the agent to open it.

IMG_AGENT_LANDING

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.

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

IMG_SIGNIN_PROMPT

Copilot prompting you to sign in before it can process the request.

  1. Click Sign in to Cloverleaf.

  2. A sign-in window opens and asks you to authorize Cloverleaf. Review the permissions and click Authorize.

IMG_OAUTH_POPUP

The Cloverleaf authorization window — review the permissions, then click Authorize.

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

IMG_RESULT_SUCCESS

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.

Did this answer your question?