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

# Connect via MCP

> Query your QX knowledge vaults from Claude, Cursor, Microsoft Copilot, and other AI apps over MCP, with citations back to your files.

export const platform = {
  home: "https://platform.qxlabs.com",
  chat: "https://platform.qxlabs.com/chat",
  agents: "https://platform.qxlabs.com/agents",
  agentSchedules: "https://platform.qxlabs.com/agents/schedules",
  flows: "https://platform.qxlabs.com/flows",
  flowExecutions: "https://platform.qxlabs.com/flows/executions",
  grids: "https://platform.qxlabs.com/grids",
  pages: "https://platform.qxlabs.com/pages",
  knowledge: "https://platform.qxlabs.com/knowledge",
  connectedApps: "https://platform.qxlabs.com/credentials",
  settingsChannels: "https://platform.qxlabs.com/settings/channels",
  settingsAuthorizedApps: "https://platform.qxlabs.com/settings/authorized-apps",
  usage: "https://platform.qxlabs.com/usage",
  billing: "https://platform.qxlabs.com/billing",
  team: "https://platform.qxlabs.com/account/team",
  explore: "https://platform.qxlabs.com/explore",
  exploreSkills: "https://platform.qxlabs.com/explore/skills"
};

Query your knowledge vaults from Claude, Cursor, Microsoft Copilot, and other AI apps using MCP (Model Context Protocol), an open standard that lets AI tools plug into external data sources. Once connected, an app can search your vaults and pull in passages, tables, and images, with citations back to the original files.

Every app connects with the same server URL:

```
https://platform.qxlabs.com/api/mcp/knowledge
```

There is no API key to manage. The first time an app connects, it opens a QX consent screen in your browser where you sign in and choose which vaults to share.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/iY1FVz7VynOEJoID/images/knowledge/connect-via-mcp/consent-light.png?fit=max&auto=format&n=iY1FVz7VynOEJoID&q=85&s=c366ef5e94a982f5e3c3953a49ec7f87" alt="The QX consent screen asking which vaults to share with the connecting app" width="2100" height="913" data-path="images/knowledge/connect-via-mcp/consent-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/iY1FVz7VynOEJoID/images/knowledge/connect-via-mcp/consent-dark.png?fit=max&auto=format&n=iY1FVz7VynOEJoID&q=85&s=74feb5e481e1bf24f5133a1321b1cb42" alt="The QX consent screen asking which vaults to share with the connecting app" width="2100" height="913" data-path="images/knowledge/connect-via-mcp/consent-dark.png" />
</Frame>

## Claude

Custom connectors are available on paid Claude plans, in both the web and desktop apps.

<Steps>
  <Step title="Add the connector">
    In Claude, open **Settings**, then **Connectors**, and click **Add custom connector**. Paste the server URL above.
  </Step>

  <Step title="Connect">
    Click **Connect**. Claude opens the QX consent screen in your browser.
  </Step>

  <Step title="Choose your vaults">
    Sign in, pick the vaults to share, and approve. Claude can now search your knowledge in any chat.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/qx-labs/iY1FVz7VynOEJoID/images/knowledge/connect-via-mcp/claude-custom-connector.png?fit=max&auto=format&n=iY1FVz7VynOEJoID&q=85&s=80da41574657df496b9baf1a6639e4ac" alt="The custom connector dialog in Claude" width="1946" height="1466" data-path="images/knowledge/connect-via-mcp/claude-custom-connector.png" />
</Frame>

## Claude Code

Add the server from your terminal:

```bash theme={null}
claude mcp add --transport http qx-knowledge https://platform.qxlabs.com/api/mcp/knowledge
```

Then run `/mcp` inside Claude Code, select **qx-knowledge**, and follow the sign-in prompt.

## Cursor

The quickest route is the **Add to Cursor** button in QX, found on the <a href={platform.knowledge}>**Knowledge**</a> page under **Connect to Claude**. To add it manually instead, open Cursor's settings, go to **MCP**, and add a new server with:

```json theme={null}
{
  "mcpServers": {
    "qx-knowledge": {
      "url": "https://platform.qxlabs.com/api/mcp/knowledge"
    }
  }
}
```

Cursor prompts you to sign in the first time the server is used.

## Microsoft Copilot

Microsoft 365 Copilot reaches your vaults through an agent built in [Copilot Studio](https://copilotstudio.microsoft.com), so the setup is done by whoever builds the agent, usually a maker or admin. Once the agent is published, anyone using it in Microsoft 365 Copilot can search the shared vaults.

<Steps>
  <Step title="Add the tool">
    In Copilot Studio, open your agent's **Tools** page, click **Add a tool**, then **New tool**, and choose **Model Context Protocol**.
  </Step>

  <Step title="Describe the server">
    Enter a server name and description, and paste the server URL above. The description helps the agent decide when to search your knowledge.
  </Step>

  <Step title="Set up sign-in">
    Under authentication, choose **OAuth 2.0** with the **Dynamic discovery** type, then click **Create**. QX supports dynamic discovery, so no client IDs or secrets are needed.
  </Step>

  <Step title="Connect">
    Create a new connection when prompted, sign in to QX and choose your vaults, then click **Add to agent**.
  </Step>
</Steps>

Copilot Studio routes MCP connections through Power Platform connectors, so if your organization uses Power Platform data policies, those policies also apply to this connection.

## Other apps

Any MCP client that supports remote servers can connect. Add a new MCP server, choose the HTTP transport (sometimes called "streamable HTTP"), and paste the server URL. Leave any API key or token fields empty, the sign-in happens in your browser automatically.

## Choosing which vaults to share

The consent screen offers two levels of access:

* **All vaults**, which lets the app search every vault you have access to, including vaults created or shared with you later.
* **Selected vaults**, which limits the app to the vaults you tick. New vaults are not added automatically.

To change an app's access later, disconnect it and connect again with a new selection.

## Managing connections

Every app you authorize appears in QX under <a href={platform.settingsAuthorizedApps}>**Settings → Authorized Apps**</a>, along with its access level and when it was last used. Disconnecting takes effect immediately.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/iY1FVz7VynOEJoID/images/knowledge/connect-via-mcp/authorized-apps-light.png?fit=max&auto=format&n=iY1FVz7VynOEJoID&q=85&s=cfbffb3b49e25b6fc5a38b5ff9b2ee2f" alt="The Authorized Apps panel listing a connected app with its access level" width="1800" height="490" data-path="images/knowledge/connect-via-mcp/authorized-apps-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/iY1FVz7VynOEJoID/images/knowledge/connect-via-mcp/authorized-apps-dark.png?fit=max&auto=format&n=iY1FVz7VynOEJoID&q=85&s=90595a230aa3380797426211686438cc" alt="The Authorized Apps panel listing a connected app with its access level" width="1800" height="490" data-path="images/knowledge/connect-via-mcp/authorized-apps-dark.png" />
</Frame>

<Note>
  Knowledge searches made over MCP use your credits, the same as searches inside QX. Citation links for manually uploaded files open in QX, so you'll be asked to sign in if you aren't already.
</Note>
