Windsurf Integration

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 MCP settings from the Cascade panel, or open ~/.codeium/windsurf/mcp_config.json directly.
2. Add the Shortcut MCP server with the hosted server URL:

{
  "mcpServers": {
    "shortcut": {
      "serverUrl": "https://mcp.shortcut.com/mcp"
    }
  }
}

3. Restart Windsurf.
4. Follow the authorization prompt to authenticate with your Shortcut workspace.

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