Post

Five Minutes to Your First MCP Connector in Copilot Studio

Create your first MCP connector in Copilot Studio in five minutes, then understand what was created behind the scenes: custom connectors, connection references, and solution structure.

Five Minutes to Your First MCP Connector in Copilot Studio

Every MCP tutorial seems to start the same way: “First, build an MCP server.” But what if you just want to see an MCP server working in Copilot Studio, without an existing connector and without writing a single line of code?

You can connect a Copilot Studio agent to an existing, publicly available MCP server in about five minutes. No server setup, no authentication, no deployment. Just paste a URL and go. Along the way, we’ll look at what Copilot Studio actually creates behind the scenes and why it matters for managing your agent across environments.

What We’re Connecting

DeepWiki provides a free, public MCP server that lets you query documentation for any public GitHub repository. No API key required. It exposes three tools:

Tool What it does
read_wiki_structure Lists documentation topics for a GitHub repo
read_wiki_contents Retrieves the actual documentation content
ask_question Answers questions about a repo using AI-grounded context

DeepWiki uses the Streamable HTTP transport, which is what Copilot Studio’s MCP integration requires.

Step 1: Add the MCP Server to Your Agent

In Copilot Studio, open your agent (or create a new one) and navigate to Tools.

  1. Click Add a tool
  2. Select Model Context Protocol
  3. Enter the server URL: https://mcp.deepwiki.com/mcp
  4. Give it a name like “DeepWiki”
  5. Set the Server description to “DeepWiki provides information about GitHub repositories”
  6. Leave Authentication as None
  7. Click Create

Adding the DeepWiki MCP server URL in the MCP configuration dialog

For more detail about MCP onboarding wizard, see the official documentation.

Step 2: Select Tools for Your Agent

  1. In the Connection dropdown, click Create connection, then click Create, then click Add and configure
  2. Review the tools that the MCP server provides. You’ll see the three DeepWiki tools listed. Tools can be individually disabled as needed.

DeepWiki MCP tools available to the agent

Step 3: Test It

  1. Open the Test pane and try a prompt like: “What is the BotFramework-WebChat repo about?”
  2. On first use, you’ll need to enable the connection. Click Open connection manager, then click Connect, then click Submit. Back in the test panel, click Retry and the prompt will now continue.
  3. The agent will now call the DeepWiki MCP tools and return a grounded answer based on the repository’s documentation.

Agent responding to a question using the DeepWiki MCP tools

That’s it. You have a working MCP connector configured as a tool for your agent.

What happened under the hood?

When you added the MCP server through the wizard, Copilot Studio created a custom connector in your Power Platform environment under the hood. This connector contains an OpenAPI specification that routes requests to the MCP server’s /mcp endpoint using the Streamable HTTP protocol.

You can view and edit this connector in the current solution. From the agent details page, click the menu, select View solution, and then find the “DeepWiki” Custom Connector. If you want to inspect the generated spec or make changes, click on the custom connector, then click Edit. This is exactly what you’d do if you needed to add custom headers to your connector.

The DeepWiki custom connector in the solution view

But the wizard created more than just a custom connector. Look at the solution contents and you’ll also find a connection reference.

Three distinct things associated with the custom connector

  1. Custom connector: the API definition itself. It describes the MCP server’s endpoint, transport, and authentication. Think of it as the template.
  2. Connection reference: a solution-aware pointer that says “this agent needs a connection for the DeepWiki custom connector.” It doesn’t contain credentials or a live connection. It’s a pointer that gets resolved per-environment.
  3. Connection: the actual runtime connection you created when you clicked “Create connection” in Step 2. Each connection is specific to an environment and associated a specific user. It’s not part of the solution.

Why do the solution component details matter?

When you use pipelines or manual export/import to more your solution into another environment (say, test or production), the custom connector and connection reference are included in the solution. However the connection does not. Someone in the target environment will need to create a new connection and map it to the connection reference. This is standard Power Platform ALM, but if you’re coming from an M365 background, it’s easy to miss.

This same pattern applies to A2A (Agent-to-Agent) connectors. When you connect to an external agent over the A2A protocol, Copilot Studio creates a custom connector and connection reference in exactly the same way. Everything in this section applies to A2A.

Resources

If you’re new to Power Platform and want to dig deeper into the concepts behind what the wizard created:

What’s Next?


What MCP server are you going to connect to next?

This post is licensed under CC BY 4.0 by the author.