# Cursor

## 1. Open the MCPs panel

Open **Customize** (from Cursor's sidebar) and select the **MCPs** filter, then click **+ New MCP Server**.

![Cursor's Customize panel, MCPs filter selected, showing a connected server and a "New MCP Server / Add a Custom MCP Server" option](mcp-panel.png "md")

## 2. Add the server

Cursor reads MCP servers from a config file, either project-scoped or available everywhere:

- **Project-only**: `.cursor/mcp.json` in your project root
- **Global (every project)**: `~/.cursor/mcp.json` in your home directory

Add Kuberns to it:

```json
{
  "mcpServers": {
    "kuberns": {
      "url": "https://mcp.kuberns.cloud/mcp"
    }
  }
}
```

Save the file. Cursor picks it up automatically.

## 3. Check its status

Back in the MCPs panel, Kuberns now shows up under **Needs Attention**.

![The Customize MCPs panel showing "kuberns · Needs authentication" with an Authenticate link](needs-auth.png "md")

Click **Authenticate**. Your browser opens to Kuberns' consent screen.

![Consent screen: "Cursor wants to access your Kuberns account," signed in as an email, listing scopes including Debug Your Application, with Approve and Deny buttons](oauth-consent.png "md")

Click **Approve**.

![Confirmation page: "Authorization complete! You can close this tab and return to Cursor," with a Return to Cursor link](authorization-complete.png "md")

Return to Cursor. The connection is complete.

## 4. Confirm it worked

Ask Cursor's agent something simple, like *"List my Kuberns projects,"* to confirm it's live.