Part 2 – Build & Ship a “Docs Agent” to Microsoft Teams

(Companion guide to “Spin-Up the Microsoft Learn MCP Server”)

Start with Microsoft Learn MCP setup in Copilot Studio. A custom connector is no longer required for that setup. This continuation uses screenshots from the original walkthrough; consult Microsoft’s current Teams publishing guidance for the current controls and availability options.

What you’ll build

A Copilot Studio agent that queries the Microsoft Learn MCP server for live docs, then answers teammates inside a Teams chat or Meeting.

Prerequisites

Need	Notes
Microsoft Learn MCP tool configured in the agent	Follow the linked Part 1 setup and confirm the agent can use the tool before continuing.
Access to Copilot Studio	Use the current setup guidance for your agent experience. The screenshots below show the original interface.
Teams admin rights (or approval from your Teams Admin)	For organization-wide distribution, coordinate with your Teams administrator and follow the current approval requirements.
Licensing and capacity	Check the current Copilot Studio licensing requirements for your scenario with your administrator.

Icons to Download (optional)

Below are icons you can use for the Agent and the MCP custom connector.

1 – Create the Agent in Copilot Studio

In this example I am going to use the existing agent I created from Part 1.

1. Modify or create the agent with a meaningful name, description, and icon.
   (You can use the one I provided from above or use your own)
2. Name: MS Docs Agent
3. Description: MS Docs Agent is your on-demand mentor for Microsoft technologies—built with Copilot Studio and powered by the Microsoft Learn MCP server. Every answer comes from the live, authoritative docs that Microsoft publishes each day, so you never rely on stale model memories or web-scraped content.
4. Orchestration = Enabled
   
   
5. Configure instructions using the current Microsoft Learn MCP setup guidance linked above. The blank-instructions advice in the original walkthrough reflected that earlier setup; it should not be treated as a requirement now.
6. Web Search – This should be Disabled. We only want the agent to query the docs which it does through the MCP server.
7. Knowledge should be empty, the only thing we want this agent to do is query the Docs MCP server, so this should be the only Tool that the agent has access to.
8. For this focused example, use the Microsoft Learn MCP tool configured in Part 1. The screenshot below shows the original connector setup.
   

Add Suggested Prompts

When users interact with the agent in M365 chat (Copilot) we can show suggested prompts to help guide the user in what is possible with this agent. Here are a bunch of samples you can give your agent:

Title	Prompt
Dev Env for Power Apps	Set up a developer environment for Power Apps—step-by-step.
Rollup vs Formula	Rollup fields vs Formula columns in Dataverse—when to use each?
Flow 502 Fix	Power Automate flow fails with 502 Bad Gateway—how do I resolve it?
Cert Path Finder	Fastest certification path for a Dynamics 365 functional consultant.
PL-200 Module List	List every Microsoft Learn module covered by the PL-200 exam.
Managed Env Enable	Turn on managed environments and approval gates in Power Platform.
Finance DLP Policy	Best-practice DLP setup for finance data in Power Platform.
Power Fx Date Filter	Sample Power Fx to filter a gallery to today’s records.
OpenAI Flow Sample	Minimal example: call Azure OpenAI from Power Automate.
Secure Env Vars	Secure environment variables with Azure Key Vault in flows.
Pipeline Checklist	Checklist to deploy a solution through Power Platform pipelines.
PCF Chart Control	Build a PCF control that renders a chart on a model-driven form.
New PA Features	Summarize new Power Apps features announced this month.
Preview Connectors	List preview connectors added to Power Automate in the last 30 days.
Explain to a Child	Explain Dataverse to a five-year-old.

You can only add 6 Suggested Prompts. So choose carefully.

Agent Settings

Next we want to configure some settings on the agent.

1. Click the Settings button on the top right.
   
   
2. (Optional) If you want the agent to have reasoning capabilities > Under Generative AI turn on: Deep reasoning
   **Note that this is a premium feature**
   
   
3. Scroll down to Knowledge, make sure Use general knowledge and Use information from the Web are both OFF
   
   
4. Make sure to click Save once done.
   

Turn Off Pointless Topics

Next we will turn off the topics we don’t want the agent to use.

1. Click on Topics tab > Under Custom > Only leave Start Over topic On.
   
   
2. Under System > Turn Off:
   – End of Conversation
   – Escalate
   – Fallback
   – Multiple Topics Matched
   
   
3. Next, lets modify the Conversation Start to make it sound better.
   Click Conversation Start topic > Modify the Message node:
   
   
4. Click Save.

Now we are ready to Publish and Package for Teams!

Publish & Package for Teams

Next we need to Publish our agent.

1. Click on the Channels tab > Click Publish
   
   
2. Once your agent is published > Click on the Teams and Microsoft 365 Copilot channel.
   
   
3. A sidebar opens > Check the Make agent available in Microsoft 365 Copilot > Click Add channel.
   
   
4. After the channel has been added > Click Edit details.
   
   
5. This is where we configure the agent in Teams. We will modify the icon, give a short description, long description and allow for the agent to be added to a team and meeting chats.
   Under Teams settings > Check both:
   – Users can add this agent to a team
   – Use this agent for group and meeting chats
   
   
6. Click Save

Submit Agent for Approval

Now because we want our organization to easily find and use this agent. We will submit the agent to the Agent Store. To do this follow these steps:

1. First Publish your agent, to make sure you have the newest version you are pushing to Teams admin for approval.
2. Next click on the Channels tab > Select the Teams and Microsoft 365 Copilot channel.
3. Now click Availability options.
   
   
4. Now we will configure the Show to everyone in my org.
   
   
5. Than click Submit for admin approval.
   
   Now we will look at what a Teams Admin has to do.

Approve Agent App (As a Teams Admin)

A Microsoft Teams Admin will have to approve the Agent app before your org can use it. As a Teams Admin follow these steps:

1. Navigate to https://admin.teams.microsoft.com/policies/manage-apps
   (Click on Manage apps under Teams apps)
2. Search for your agent name in the search bar
   
   
3. Click the agent > Publish.
   
   
4. Approval depends on what changes. Microsoft’s Teams publishing guidance distinguishes agent-detail changes, such as the icon and descriptions, from content updates. Check the current approval requirements before resubmitting an already approved agent.

How to Use the Agent

Once your agent is approved by an Admin. You can easily find it in the Agent Store. Another easy way to get to your agent is to open it from Copilot Studio:

1. Click Channels tab > Select Teams and Microsoft 365 Copilot channel > Click See agent in Teams.

You will be brought to Teams with the agent open. You can now add it:

Adding Agent to a Meeting or Chat

There are a few ways to add the agent to a meeting. One easy way is to @mention the agent in the chat.

**Note to start typing the name of the agent, and it should show up**

Troubleshooting

There are a few things to note that I ran into:
1) If your getting an error on the MCP Server, remove all custom instructions

2) Sometimes your agents details can be cached and showing old metadata. In this case you can resubmit the app approval.

3) Always test the Agent inside Copilot Studio Test Pane with tracking topics and Activity Map turned On.