> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consensus.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Copilot Studio

> Add the Consensus MCP server as a Model Context Protocol tool in Copilot Studio, with per-user OAuth or a shared API key, so your own agents can search 220 million papers.

Copilot Studio connects to remote MCP servers directly, so you can give any agent you build the Consensus `search` tool. The tool can be shared with other makers in your environment. Copilot Studio supports the Streamable HTTP transport only, which is what Consensus uses.

## Add the tool

<Steps>
  <Step title="Open Tools">
    Open your agent in [Copilot Studio](https://copilotstudio.microsoft.com) and go to the **Tools** page.

    <img src="https://mintcdn.com/consensus-f7e6ffce/Qlioe-rt4Y_Nb1Hf/images/CleanShot-2026-08-31-at-17.17.16@2x.png?fit=max&auto=format&n=Qlioe-rt4Y_Nb1Hf&q=85&s=b5f6a6010734943bb41b7d8351b2e952" alt="The Tools tab in the Copilot Studio left navigation" width="2828" height="1538" data-path="images/CleanShot-2026-08-31-at-17.17.16@2x.png" />
  </Step>

  <Step title="Add a new tool">
    Select **Add a tool**, then **New tool**.

    <img src="https://mintcdn.com/consensus-f7e6ffce/Qlioe-rt4Y_Nb1Hf/images/CleanShot-2026-08-31-at-17.19.50@2x.png?fit=max&auto=format&n=Qlioe-rt4Y_Nb1Hf&q=85&s=cf3823beb65f9b462ad5c1f658e9b6ba" alt="The Add a tool dialog with New tool highlighted" width="2770" height="1540" data-path="images/CleanShot-2026-08-31-at-17.19.50@2x.png" />
  </Step>

  <Step title="Choose Model Context Protocol">
    <img src="https://mintcdn.com/consensus-f7e6ffce/Qlioe-rt4Y_Nb1Hf/images/CleanShot-2026-08-31-at-17.21.06@2x.png?fit=max&auto=format&n=Qlioe-rt4Y_Nb1Hf&q=85&s=7bb99d2343cd51fa74f3ace9e886aabe" alt="Tool type options with Model Context Protocol highlighted" width="2060" height="1568" data-path="images/CleanShot-2026-08-31-at-17.21.06@2x.png" />
  </Step>

  <Step title="Fill in the server details">
    <img src="https://mintcdn.com/consensus-f7e6ffce/Qlioe-rt4Y_Nb1Hf/images/CleanShot-2026-08-31-at-17.27.17@2x.png?fit=max&auto=format&n=Qlioe-rt4Y_Nb1Hf&q=85&s=557f2599cb9066c2bb71177b2bc4b402" alt="The MCP server form with name, description, URL, and authentication fields" width="2490" height="1652" data-path="images/CleanShot-2026-08-31-at-17.27.17@2x.png" />

    | Field                  | Value                                                                                                                                                                                                                                                                                                            |
    | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Server name**        | Consensus                                                                                                                                                                                                                                                                                                        |
    | **Server description** | Consensus is the go-to MCP for academic research. Search 220M+ peer-reviewed papers from PubMed, Semantic Scholar, and ArXiv — filter by study type (RCTs, meta-analyses, systematic reviews), journal quality, sample size, and more. Get structured results with citations, study takeaways, and direct links. |
    | **Server URL**         | `https://mcp.consensus.app/mcp`                                                                                                                                                                                                                                                                                  |
    | **Authentication**     | See the two options below                                                                                                                                                                                                                                                                                        |
  </Step>

  <Step title="Create, then add to the agent">
    Select **Create**. On **Add tool**, choose **Create a new connection** (or reuse one), then **Add to agent**.
  </Step>
</Steps>

## Choose an authentication option

<Tabs>
  <Tab title="OAuth 2.0 — each user signs in">
    Set **Authentication** to **OAuth 2.0** and **Type** to **Dynamic discovery**. Copilot Studio reads our discovery document, registers itself with Dynamic Client Registration, and prompts each user to sign in to their own Consensus account the first time they use the tool. Usage and limits follow each user's Consensus plan.

    Copilot Studio's registration call comes from Power Platform infrastructure, so `https://consensus.app/oauth/register/` must be reachable from there (it is, unless your network policy blocks it).
  </Tab>

  <Tab title="API key — one shared credential">
    Set **Authentication** to **API key**, **Type** to **Header**, and the header name to `Authorization`. When you create the connection, enter the value as `Bearer ` followed by your key:

    ```text theme={null}
    Bearer ak_live_...
    ```

    Every user of the agent then searches through the same Consensus account and its plan limits. Generate the key from your Consensus profile icon → **API & MCP Dashboard** → **Keys and clients** → **New key**.
  </Tab>
</Tabs>

<Note>
  If your organization requires a client ID and client secret (the **Manual** OAuth type), Consensus provisions confidential clients for enterprise partners. [Contact sales](https://consensus.app/home/contact/sales/). Don't use Manual with a Dynamic-Client-Registration client: token refresh will fail and calls will start returning 401 on the second turn.
</Note>

## Do I have Copilot Studio access?

Go to [copilotstudio.microsoft.com](https://copilotstudio.microsoft.com) and sign in with your work account. If the **Home** page loads, you're licensed. A Microsoft 365 Copilot license lets you use Copilot Studio to extend Copilot with agents; otherwise your admin assigns the **Copilot Studio user license** from **Users › Active users › Manage product licenses**. Users of your agents don't need a Copilot Studio license.

## Related

<CardGroup cols={2}>
  <Card title="Connection reference" icon="file-code" href="/enterprise/connection-reference">
    Endpoint, OAuth details, and the allowlist.
  </Card>

  <Card title="Microsoft 365 Copilot" icon="https://mintcdn.com/consensus-f7e6ffce/pL2GxbOkiUPczTU3/logo/clients/microsoft-copilot.svg?fit=max&auto=format&n=pL2GxbOkiUPczTU3&q=85&s=75c05e6833531f429009c4583d74c10c" href="/enterprise/microsoft-365-copilot" width="44" height="40" data-path="logo/clients/microsoft-copilot.svg">
    Enable the built-in connector instead of building a tool.
  </Card>
</CardGroup>
