# Cursor Cursor

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

Connect the Cursor editor and Cursor CLI 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/).

**Tab: Cursor Editor**

1. Open the MCP configuration file you want to use:
   - `~/.cursor/mcp.json` makes Qualytics available in all your projects.
   - `.cursor/mcp.json` in a project keeps it in that project.
2. Add the Qualytics server under `mcpServers`:

   ```json
   {
     "mcpServers": {
       "qualytics": {
         "url": "https://your-qualytics-instance.qualytics.io/api/mcp/"
       }
     }
   }
   ```
3. Save the file. Cursor finds the Qualytics authorization details and registers itself, so no client ID or header is needed.
4. When Cursor opens the browser sign-in, paste your Qualytics API token on the Qualytics authorization page and approve the access.
5. Open **Customize** in the sidebar and make sure the Qualytics server is turned on.

In chat, Cursor uses the Qualytics tools when they fit your request, or you can name the tool you want. Cursor asks you to approve each tool call, and you can expand the call to see its arguments first.

If the server does not connect, open the **Output** panel and select **MCP Logs** to see the connection and authorization errors.

**Tab: Cursor CLI**

Cursor CLI reads the same `mcp.json` files as the editor, so a Qualytics server added in the **Cursor Editor** tab is already available in the CLI.

1. If you have not added the server yet, add it to `~/.cursor/mcp.json` or `.cursor/mcp.json` as shown in the **Cursor Editor** tab.
2. Sign in:

   ```bash
   agent mcp login qualytics
   ```
3. On the Qualytics authorization page, paste your Qualytics API token and approve the access.
4. Run `agent mcp list` to confirm the server shows as connected, and `agent mcp list-tools qualytics` to see the Qualytics tools.

> **Info: Official Documentation**
>
> These steps follow Cursor's guides for [MCP in the editor](https://cursor.com/docs/mcp) and [MCP in Cursor CLI](https://cursor.com/docs/cli/mcp). 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.*
