Documentation

Copilot Integration with Model Context Protocol (MCP)

After configuring the Retrieval Suite to use MCP (see Model Context Protocol Configuration ) you can integrate your search into Microsoft Copilot as a Tool.

As a prerequisite please make sure

  1. the Retrieval Suite’s URL is accessible from the Microsoft Cloud (for instance through a data gateway)

  2. you are not using self signed certificates

  3. no additional parameters are needed to call the api (for instance custom header parameters)

  4. Please download the yaml configuration file which you can find in the bot configuration as described here Model Context Protocol Configuration .

Configuration

  1. Open Copilot Studio

  2. Create or open an agent

  3. Click on tools

    Copilot Setup Step 1

  4. Click on Add a tool

  5. Click on New Tool

    Copilot Setup Step 2

  6. Choose Custom Connector (which brings you to Power Apps)

    Copilot Integration Step 6

  7. Click on New custom connector

    Copilot Integration Step 7

  8. Choose Import an OpenAPI file

    Copilot Integration Step 8

  9. Give the connector a name (please note that the name is important to finding your custom connector again, as the tools list at Copilot is quite long).
    Add the yaml file which you downloaded from Model Context Protocol Configuration .

    Copilot Integration Step 9

  10. In the next dialog, see if you need to fix any issues. Otherwise, click on “Create connector”

    Copilot Integration Step 10

  11. Go to Test and click on New Connection

    Copilot Integration Step 11

  12. Then click on Test operation

  13. If this was successful, go back to Copilot Studio (the tab should still be open). Here click on Add tool and connector. The connector should now (or after some waiting) be listed here as Connector:

    Copilot Integration Step 13

  14. Choose the connector and give it a name

    Copilot Integration Step 14

  15. If there are additional (static) parameters for the connection needed, then you can add them here. Also the dialog shows the tool name (search) and the description. You still need to perform one last step to use it:

  16. Click on Settings (top right) and choose Connection Settings

  17. If the connection is not yet connected, then click on manage and submit. The outcome should be:

    Copilot Integration Step 17

  18. Now you can use your MCP tool in the chat window as follows. Enter something like “search for printer setup documentation” the reasoning screen will show if the MCP server was used.