# Cursor

Connect Cursor to Shortcut through the hosted Shortcut MCP server.

## Overview

Connect Cursor to Shortcut through the hosted [Shortcut MCP Server](/help/integrations/mcp-server). Cursor can then use Shortcut context while planning, writing, and reviewing code.

## Installation

1. Open or create `~/.cursor/mcp.json`. For a project-only connection, use `<project-root>/.cursor/mcp.json`.
2. Add the Shortcut server:

```json
{
  "mcpServers": {
    "shortcut": {
      "url": "https://mcp.shortcut.com/mcp"
    }
  }
}
```

3. Restart Cursor.
4. Follow the authorization prompt the first time Cursor connects to Shortcut.

Authentication is handled with OAuth. You do not need to create or store a Shortcut API token.

## Use Shortcut from Cursor

In Cursor chat, ask for the Story or Epic context you need, for example:

* "Open Shortcut Story 12345 and create an implementation plan."
* "Find Stories related to this repository."
* "Add a comment to Story 12345 summarizing these changes."

For available entities and troubleshooting, see [MCP Server](/help/integrations/mcp-server).