# ![](/img/ai/cursor.svg) Connect Cursor to Comind.work

Cursor supports MCP natively. Configuration is JSON and can live at the project or user level.

## 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)

## Per-project setup[​](#per-project-setup "Direct link to Per-project setup")

1. In your project root, create `.cursor/mcp.json`:

   .cursor/mcp.json

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

2. Open **Settings > MCP** in Cursor. The `comind` server should appear in the list with a green status indicator, and Cursor opens a browser window for Comind.work OAuth sign-in on first use.

3. If the status is red, click the server to see the error - usually a JSON syntax problem or a cancelled sign-in.

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 Cursor's docs

For the **Settings > MCP** panel, authentication options, and the `+ Add New MCP Server` UI, see [Model Context Protocol (MCP)](https://cursor.com/docs/mcp).

## Global setup[​](#global-setup "Direct link to Global setup")

To use the server in every project without committing `.cursor/mcp.json`, add the same block to `~/.cursor/mcp.json` (macOS/Linux) or `%USERPROFILE%\.cursor\mcp.json` (Windows).

## Using tools in a chat[​](#using-tools-in-a-chat "Direct link to Using tools in a chat")

Open Cursor's chat panel and type `@comind` to see the available tools, or just ask naturally - "list my open tickets in the SUPPORT workspace" - and Cursor will pick the right tool.

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

In Cursor's chat, ask:

> "List my Comind workspaces."

Cursor 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, toggle the server off and on in the MCP settings panel 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.

**`@comind` autocomplete missing** : The extension may need to re-fetch the tool list - toggle the server off and on in the MCP settings panel.

## 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