
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.


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)
🔐 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
🔑 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:
Navigate to Cascade and click Manage MCPs > View raw config.

Paste Your Server URL to mcp_config.json file like the screenshot below.
- macOS:
Cmd + ,or Windsurf > Settings > Advanced Settings - Windows/Linux:
Ctrl + ,or Windsurf > Settings > Advanced Settings




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:6
Happy Building! 🎉
You’re all set! Your Strata MCP server is now integrated with Windsurf IDE.
Troubleshooting
🔧 Tools Not Appearing
🔧 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
🔐 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
⚡ 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
