API Docs

Microsoft Copilot Studio

Beta

The Flowcase MCP server is in beta and is available on request. Request access to the MCP beta.

This guide adds the Flowcase MCP server to an agent in Microsoft Copilot Studio.

It uses an API key to authenticate. See MCP Overview for the authentication options.

1. Create a new agent

  1. In Copilot Studio, select Agents from the left-hand navigation.
  2. Click Create blank agent.

Copilot Studio left-hand navigation with Home, Agents, Flows and Tools

The Create blank agent button at the top of the Agents page

2. Add an MCP tool

  1. On the agent's Overview page, scroll down to the Tools section.
  2. Click Add tool.
  3. In the Add tool dialog, select New tool.
  4. Choose Model Context Protocol as the tool type.

A new agent's Overview page, with the Add tool button in the Tools section

The Add tool dialog, with the New tool button next to the tool filters

The new tool options, including Model Context Protocol

3. Configure the MCP server

Enter the following details:

Field Value
Server name Flowcase
Server description A short description of the tool, for example "Search and manage CVs".
Server URL https://<subdomain>.flowcase.com/mcp
Authentication API key
Type Header
Header name Authorization

Replace <subdomain> with the subdomain you use to access Flowcase, then click Create.

The Add a Model Context Protocol server form filled in for Flowcase, with API key authentication sent in the Authorization header

4. Create a connection

After the tool is created, Copilot Studio shows a preview of it.

  1. Click Not connected.
  2. Select Create new connection.

Copilot Studio then asks for an API key.

The Flowcase tool preview, with the connection showing as Not connected

5. Create and enter the API key

You must use an API key with the Read only Administrator access level.

  1. Log in to your Flowcase account.
  2. Go to https://<subdomain>.flowcase.com/settings#/apikeys.
  3. Create an API key with the Read only Administrator access level.

The connection dialog expects the full value of the Authorization header, so put Bearer and a space before your API key:

Bearer <your-api-key>

Enter this value, then click Add and configure to finish setting up the connection.

The connection dialog for Flowcase, with the API key entered after the word Bearer

6. Choose which credentials to use

Copilot Studio returns you to the agent configuration screen.

  1. Expand Additional details.
  2. Under Credentials to use, select Maker-provided credentials.
Important

Maker-provided credentials share your API key with everyone who uses the agent. Make sure this meets your security and access requirements.

The tool's Additional details, with Credentials to use set to Maker-provided credentials

7. Refresh the tool list if needed

Sometimes the tool definitions fail to load when you first add the MCP server.

  1. After selecting Maker-provided credentials, click the Refresh button in the Tools section.
  2. The Flowcase MCP tools should then appear in the list.

The Tools section listing the Flowcase MCP tools, with the Refresh button above the list

8. Test the agent

Use the Copilot Studio chat to test the agent and check that the Flowcase tools work as expected.

Next steps

For more agent configuration options and best practices, see Microsoft's guide to getting started with Copilot Studio.