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

# Cursor

> Connect your MCPCore server to Cursor using its native HTTP MCP transport.

## Prerequisites

* [Cursor](https://cursor.com) installed
* A MCPCore server with at least one tool
* The config snippet from your server's **Integration** tab

***

## Step 1 — Get your config snippet

Open your server's detail page, click the **Integration** tab, and select **Cursor**. Copy the generated snippet.

Cursor supports native HTTP transport — no `npx` bridge needed:

```json theme={null}
{
  "mcpServers": {
    "your-server-code": {
      "url": "https://your-subdomain.mcpcore.io/mcp"
    }
  }
}
```

For API Key mode:

```json theme={null}
{
  "mcpServers": {
    "your-server-code": {
      "url": "https://your-subdomain.mcpcore.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}
```

***

## Step 2 — Open the MCP config file

Cursor's MCP config is at:

**macOS / Linux:**

```
~/.cursor/mcp.json
```

**Windows:**

```
%USERPROFILE%\.cursor\mcp.json
```

Create the file if it doesn't exist.

***

## Step 3 — Merge the snippet

Add your server entry to the `mcpServers` object. If the file is new:

```json theme={null}
{
  "mcpServers": {
    "your-server-code": {
      "url": "https://your-subdomain.mcpcore.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}
```

***

## Step 4 — Reload MCP in Cursor

Save the file. You can reload without restarting Cursor: open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) and search for **MCP: Reload**.

***

## Step 5 — Verify

Open Cursor's Agent mode or a chat and ask it to use one of your tools. Your MCPCore tools are available in any AI feature.

***

## Troubleshooting

| Problem                 | Solution                                                    |
| ----------------------- | ----------------------------------------------------------- |
| Server shows as offline | Confirm the URL is correct and internet access is available |
| `401 Unauthorized`      | Verify the `Authorization` header value                     |
| Tools fail silently     | Check [Traffic Logs](/observability/traffic-logs)           |