# Microsoft Microsoft Clients

Source: https://userguide.qualytics.io/using-the-platform/mcp/connecting-external-ai-clients/microsoft/

Connect VS Code with GitHub Copilot to the Qualytics MCP server. Before you start, have a Personal API Token and your Qualytics MCP server URL ready. See [External AI Client Requirements](https://userguide.qualytics.io/using-the-platform/mcp/connecting-external-ai-clients/requirements/).

## VS Code (GitHub Copilot)

**Add the server**

1. Open the Command Palette and run **MCP: Add Server**.
2. Choose **HTTP (HTTP or Server-Sent Events)**.
3. Enter your Qualytics MCP URL: `https://your-qualytics-instance.qualytics.io/api/mcp/`.
4. Enter a server ID, such as `qualytics`.
5. Choose where to save it. For a personal setup that works in every workspace, choose **Global**, then **Copilot Global**.

You can also add the server by hand. In a workspace, run **MCP: Open Workspace Folder MCP Configuration** to open `.vscode/mcp.json`, or run **MCP: Open User Configuration** for your user profile, then add:

```json
{
  "servers": {
    "qualytics": {
      "type": "http",
      "url": "https://your-qualytics-instance.qualytics.io/api/mcp/"
    }
  }
}
```

Leave out the `oauth` and `headers` properties. VS Code registers its own client with Qualytics, and Qualytics does not accept an API token in a header.

**Authorize the connection**

The first time VS Code connects to the server, it opens a browser window. On the Qualytics authorization page, paste your Qualytics API token and approve the access.

**Use Qualytics in Copilot Chat**

To choose which Qualytics tools Copilot can use, run **Chat: Open Customizations** and select **Tools**. To check the connection, ask Copilot something that names Qualytics and only reads data, such as listing your datastores, and confirm a Qualytics tool ran.

To start, stop, or restart the server, or to see its output, run **MCP: List Servers**.

> **Info: Official Documentation**
>
> These steps follow the VS Code guides for [MCP servers](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) and the [MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration). If a menu or command in your version differs, check those pages.

If the connection fails, see [MCP Troubleshooting](https://userguide.qualytics.io/using-the-platform/mcp/troubleshooting/).

*Last updated: November 7, 2026.*
