Windsurf

Integration

Overview

Windsurf is an environment for building AI agents. Connecting it to the Shortcut MCP Server gives your agent access to your Shortcut data, allowing it to create, update, and manage Stories and Epics based on what’s happening in development.

‍

How to Setup

See the official Windsurf docs for more information.

1. Open the Windsurf MCP Configuration Panel
2. Click Add custom server.
3. Add the following details and save the file:

{
  "mcpServers": {
    "shortcut": {
      "command": "npx",
      "args": [
        "-y",
        "@shortcut/mcp@latest"
      ],
      "env": {
        "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
      }
    }
  }
}