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

# Cursor

## Quick Install

```bash theme={null}
zenable install cursor
```

<Note>See the [CLI command reference](/integrations/zenable/commands#install) for more options.</Note>

**That's it! You're all set.** Restart Cursor and start using Zenable's conformance checking in your AI coding assistant.

This installs both the MCP server and Cursor hooks for real-time code checking.

***

<Accordion title="Advanced: Manual MCP Configuration" icon="wrench">
  <Note>The below is a minimal example which may need to be merged with your existing configuration. Consider using the quick install command to handle this automatically.</Note>

  Place the following configuration:

  ```json theme={null}
  {
    "mcpServers": {
      "zenable": {
        "type": "http",
        "url": "https://mcp.zenable.app/"
      }
    }
  }
  ```

  In one of these file locations:

  <CodeGroup>
    ```bash Project theme={null}
    .cursor/mcp.json
    ```

    ```bash Global theme={null}
    ~/.cursor/mcp.json
    ```
  </CodeGroup>

  <Warning>We only recommend this manual approach if you can't use `zenable install`. Otherwise, `zenable install` is much safer and can handle configuration upgrades over time, handles merges with existing configs, performs backups and logging in case of issues, and more.</Warning>
</Accordion>

<Accordion title="Advanced: Manual Hook Configuration" icon="bolt">
  <Note>Hooks run automatically after file edits to check for conformance issues. The quick install command sets this up for you.</Note>

  Place the following configuration in `.cursor/hooks.json` (project) or `~/.cursor/hooks.json` (global):

  ```json theme={null}
  {
    "version": 1,
    "hooks": {
      "afterFileEdit": [
        {
          "command": "zenable hook"
        }
      ]
    }
  }
  ```

  This uses [Cursor's afterFileEdit hook](https://cursor.com/docs/agent/hooks) to run conformance checks after each file edit made by the AI agent.

  <Warning>
    **Current Limitation:** Cursor's `afterFileEdit` hook cannot send output back to the agent or use exit codes to block edits. Conformance issues are printed to stdout for visibility in Cursor's hook output panel, but the agent won't automatically act on them. We're talking with the Cursor team about enhanced support.
  </Warning>
</Accordion>

<Accordion title="Cursor Agent CLI" icon="terminal">
  Cursor provides a CLI (`cursor-agent`) for managing MCP servers. After installation, you can use these commands:

  ```bash theme={null}
  # List configured MCP servers and their status
  cursor-agent mcp list

  # View tools provided by a specific server
  cursor-agent mcp list-tools zenable

  # Authenticate with an MCP server
  cursor-agent mcp login zenable

  # Disable a server
  cursor-agent mcp disable zenable
  ```

  <Note>
    As of 2025.12.17-996666f, the Cursor CLI is read-only for MCP management (no `add`/`remove` commands). Configuration changes require editing `.cursor/mcp.json` directly or running `zenable install cursor`.
  </Note>

  See [Cursor's CLI MCP documentation](https://cursor.com/docs/cli/mcp) for more details.
</Accordion>
