> ## Documentation Index
> Fetch the complete documentation index at: https://www.klavis.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf

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

![Windsurf IDE](https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/windsurf.png?fit=max\&auto=format\&n=ilUsF_4RyDqP505q\&q=85\&s=3359a470aecd152a4cbbc6173bc4788a)

## Quick Setup Guide

**1. Authorize MCP Servers to Use with Strata**

Navigate to the [Klavis home page](https://www.klavis.ai/home) and click **"MCP Server"** in the left sidebar. You will see a list of MCP servers available in Klavis.

![Klavis home page](https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step1.png?fit=max\&auto=format\&n=IPvQfNqZrLr0INmh\&q=85\&s=86e89701f59cbf5cf97c48bd8ddeadde)

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

![Authorize MCP Servers](https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step2.png?fit=max\&auto=format\&n=IPvQfNqZrLr0INmh\&q=85\&s=4aca390f891ced882c929f5a02eb0403)

> [!TIP]
>
> 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.

![Klavis Dashboard](https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step3.png?fit=max\&auto=format\&n=IPvQfNqZrLr0INmh\&q=85\&s=73aae3b8dc008bbbdf806d4cb9cf13c6)

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

![Copy Strata Server URL](https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step4.png?fit=max\&auto=format\&n=IPvQfNqZrLr0INmh\&q=85\&s=8ce74fee9d1a5921d8804687a4c2a6fc)

> [accordion] 🔐 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

> [accordion] 🔑 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**

![Windsurf IDE Settings](https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/step5.png?fit=max\&auto=format\&n=ilUsF_4RyDqP505q\&q=85\&s=96a77036378d15025942f8b397162ed0)

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

![Windsurf Cascade and MCPs settings](https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/step6.png?fit=max\&auto=format\&n=ilUsF_4RyDqP505q\&q=85\&s=0857cac2b93fa04c154f20b77cbeda54)

![Get Raw Config file in Windsurf](https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/step7.png?fit=max\&auto=format\&n=ilUsF_4RyDqP505q\&q=85\&s=4145e789b2e27bc4465ceaeb45dbc445)

Paste Your Server URL to **mcp\_config.json** file like the screenshot below.

![Paste strata URL in mcp\_config.json file of Windsurf IDE](https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step8.png?fit=max\&auto=format\&n=IPvQfNqZrLr0INmh\&q=85\&s=ac769a02f0789481453456ca3779f0df)

> [!TIP]
>
> 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**

![Strata Configuration in Windsurf](https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step9.png?fit=max\&auto=format\&n=IPvQfNqZrLr0INmh\&q=85\&s=8dccc7be45ed59367daa3b4cb09bab1d)

> [!NOTE]
>
> 📋 **Reopen Windsurf Settings** to apply the new configuration

**5. Start Using in Windsurf Chat**

![Using Strata in Windsurf Chat](https://mintlify.s3.us-west-1.amazonaws.com/klavisai/images/knowledge-base/windsurf/step10.jpg)

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

```text GitHub theme={null}
"Create a new issue titled 'Add dark mode' with priority label"
```

```text Slack theme={null}
"Send a message to #general: 'Standup meeting in 5 minutes!'"
```

```text Gmail theme={null}
"Send email to john@company.com about project update"
```

```text Notion theme={null}
"Create a new page called 'Meeting Notes' with today's date"
```

> [!TIP]
>
> 🎯 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

> [accordion] 🔧 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

> [accordion] 🔐 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

> [accordion] ⚡ 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?

> [card] Community
>
> Join our Discord for community support and discussions

> [card] Support
>
> Contact our technical support team for assistance

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.