# ![](/img/ai/vscode.svg) Connect VS Code to Comind.work

VS Code's built-in MCP support lives in the user or workspace `mcp.json` file. Other chat extensions (Copilot, Cline, Continue, Roo Code) add their own config surfaces on top of the same server URL.

## Before you start[​](#before-you-start "Direct link to Before you start")

You need:

* Your **MCP server URL** - `https://mcp.comind.work/<your-company>`
* Your **Comind.work credentials** for the OAuth sign-in flow. If you need to use a manual API token instead - see [authentication alternatives](/ai/authentication.md#manual-api-tokens-alternative)

## Workspace setup[​](#workspace-setup "Direct link to Workspace setup")

1. In your workspace, open `.vscode/mcp.json` (create it if missing).

2. Add:

   .vscode/mcp.json

   ```
   {
   	"servers": {
   		"comind": {
   			"url": "https://mcp.comind.work/your-company"
   		}
   	}
   }
   ```

3. Reload the window (**Ctrl+Shift+P > Developer: Reload Window**).

4. On first use, VS Code opens a browser for Comind.work OAuth sign-in.

5. Open the Copilot chat panel - the `comind` tools should be listed under **Tools**.

Using a manual token instead

Add a `headers` block with `"Authorization": "Bearer YOUR-TOKEN-HERE"` inside the `comind` entry. See [authentication alternatives](/ai/authentication.md#manual-api-tokens-alternative).

On Microsoft's docs

For the Copilot **Tools** panel, agent mode, and authoritative config field names, see [Add and manage MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

## User-level setup[​](#user-level-setup "Direct link to User-level setup")

For every-workspace availability, put the same block in your user `mcp.json` (**Ctrl+Shift+P > MCP: Open User Configuration**).

## Other chat extensions[​](#other-chat-extensions "Direct link to Other chat extensions")

If you use a chat extension other than Copilot (Cline, Continue, Roo Code, etc.), each has its own MCP configuration UI - usually a **Settings > MCP** screen or a dedicated config file. The URL and auth method are the same; only the location differs.

## Verify the connection[​](#verify-the-connection "Direct link to Verify the connection")

In the Copilot chat panel, ask:

> "List my Comind workspaces."

VS Code should call `list_workspaces` and return the list you have access to.

## Troubleshooting[​](#troubleshooting "Direct link to Troubleshooting")

**Server shows red / disconnected** : Check JSON syntax. If the OAuth sign-in popup was cancelled or blocked, reload the VS Code window to re-trigger it. For the manual-token alternative, verify with `curl -H "Authorization: Bearer YOUR-TOKEN" https://mcp.comind.work/your-company/health`.

**Tools do not appear in chat** : Reload the window after changing config. Some extensions also need a full restart of the editor, not just a reload.

## Next steps[​](#next-steps "Direct link to Next steps")

* [MCP tools reference](/ai/mcp-tools.md) - what each tool does and how filters work
* [Authentication](/ai/authentication.md) - manual tokens vs OAuth