Windsurf

Connect Strata with Windsurf IDE in minutes and supercharge your AI coding experience

Quick Setup Guide

1. Authorize MCP Servers to Use with Strata

   Navigate to the Klavis home page and click “MCP Server” in the left sidebar. You will see a list of MCP servers available in Klavis.

   

   Click the “Authorize” button next to your chosen server. Once server is authorized, you will see Green Checkmark status.

   

   You can authorize one or more servers to use with Strata

2. Get Strata Server URL

   From Klavis Dashboard, click “Add to Other Clients” button to get your Strata Server URL.

   

   Copy the strata URL to clipboard - you’ll need this in the next step.

   

   🔐 OAuth Services (Most Common)

   • Automatically redirected to OAuth authorization
   • Sign in to your account (GitHub, Google, Slack, etc.)
   • Grant necessary permissions
   • Redirected back to Klavis automatically

   🔑 API Key Services

   • Prompted to enter an API key
   • Follow service-specific instructions to generate key
   • Paste key in the provided field
   • Click “Save” to continue
3. Configure Windsurf

   Copy Your Server URL, open Windsurf IDE settings:

   • macOS: Cmd + , or Windsurf > Settings > Advanced Settings
   • Windows/Linux: Ctrl + , or Windsurf > Settings > Advanced Settings

   

   Navigate to Cascade and click Manage MCPs > View raw config.

   

   Paste Your Server URL to mcp_config.json file like the screenshot below.

   

   You can add Single MCP Server URL directly here as well:

   1. Navigate to Target Server and click Three Dots next to your server
   2. Tap Show Individual Server URL and copy the URL
   3. Paste this URL in Windsurf settings as described above
4. Verify Tools Loading

   

   📋 Reopen Windsurf Settings to apply the new configuration

5. Start Using in Windsurf Chat

   

   Open Windsurf Chat (Cmd/Ctrl + Shift + L) and start using natural language:

   GitHub

   "Create a new issue titled 'Add dark mode' with priority label"
   

   🎯 Windsurf Chat automatically detects when to use Strata based on context - no need to specify explicitly!

6. Happy Building! 🎉

   You’re all set! Your Strata MCP server is now integrated with Windsurf IDE.

Troubleshooting

🔧 Tools Not Appearing

• Double-check your Server URL for typos
• Ensure stable internet connection
• Verify authentication in Klavis dashboard
• Check Windsurf IDE logs for error messages
• Try completely restarting Windsurf IDE

🔐 Authentication Issues

• Re-authenticate in the Klavis dashboard
• Check if your OAuth tokens have expired
• Verify API key permissions (for API key services)
• Ensure you’ve granted all necessary permissions

⚡ Performance Issues

• Limit the number of active MCP servers
• Check your internet connection speed
• Restart Windsurf IDE periodically
• Contact support if issues persist

Need Help?

Community

Join our Discord for community support and discussions

Support

Contact our technical support team for assistance

---