Overview
Windsurf is an AI-native IDE by Codeium that provides deep AI integration for software development. The Shortcut integration allows you to connect your development environment directly to your project management workflow.
Key Features
- Cascade AI with Story Context: Windsurf’s Cascade feature can understand your Shortcut Stories for more relevant code suggestions
- Automatic Story Updates: Update Story status directly from your IDE as you progress
- Branch Management: Create and manage branches linked to Stories
- Commit Integration: Auto-generate commits that reference Story IDs
Setting Up the Integration
- Open the MCP settings from the Cascade panel, or open
~/.codeium/windsurf/mcp_config.jsondirectly - Add the hosted Shortcut MCP Server:
{
"mcpServers": {
"shortcut": {
"serverUrl": "https://mcp.shortcut.com/mcp"
}
}
}
- Refresh MCP servers in Cascade, or restart Windsurf
- Follow the authorization prompt to connect your Shortcut workspace
Authentication is handled with OAuth. You do not need to create or store a Shortcut API token.
Windsurf will automatically detect Stories mentioned in your codebase and provide relevant context to Cascade AI.
Using the Integration
View Stories in IDE
Access the Shortcut panel from the sidebar to view your assigned Stories, current Iteration, and team’s work.
Link Code to Stories
When committing code, Windsurf can automatically detect Story references in your branch name or commit message and link them appropriately.
AI-Assisted Development
When working on a Story, Cascade AI considers the Story description, acceptance criteria, and related context to provide more accurate suggestions.