> ## 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

<img className="block dark:hidden" src="https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/windsurf.png?fit=max&auto=format&n=ilUsF_4RyDqP505q&q=85&s=3359a470aecd152a4cbbc6173bc4788a" alt="Windsurf IDE" width="2400" height="1200" data-path="images/knowledge-base/windsurf/windsurf.png" />

<img className="hidden dark:block" src="https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/windsurf.png?fit=max&auto=format&n=ilUsF_4RyDqP505q&q=85&s=3359a470aecd152a4cbbc6173bc4788a" alt="Windsurf IDE" width="2400" height="1200" data-path="images/knowledge-base/windsurf/windsurf.png" />

## Quick Setup Guide

<Steps>
  <Step title="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.

    <img src="https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step1.png?fit=max&auto=format&n=IPvQfNqZrLr0INmh&q=85&s=86e89701f59cbf5cf97c48bd8ddeadde" alt="Klavis home page" width="1905" height="1072" data-path="images/knowledge-base/windsurf/step1.png" />

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

    <img src="https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step2.png?fit=max&auto=format&n=IPvQfNqZrLr0INmh&q=85&s=4aca390f891ced882c929f5a02eb0403" alt="Authorize MCP Servers" width="1900" height="1069" data-path="images/knowledge-base/windsurf/step2.png" />

    <Tip>
      You can authorize one or more servers to use with Strata
    </Tip>
  </Step>

  <Step title="Get Strata Server URL">
    From Klavis Dashboard, click **"Add to Other Clients"** button to get your Strata Server URL.

    <img src="https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step3.png?fit=max&auto=format&n=IPvQfNqZrLr0INmh&q=85&s=73aae3b8dc008bbbdf806d4cb9cf13c6" alt="Klavis Dashboard" width="1902" height="1070" data-path="images/knowledge-base/windsurf/step3.png" />

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

    <img src="https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step4.png?fit=max&auto=format&n=IPvQfNqZrLr0INmh&q=85&s=8ce74fee9d1a5921d8804687a4c2a6fc" alt="Copy Strata Server URL" width="1920" height="1080" data-path="images/knowledge-base/windsurf/step4.png" />

    <Accordion title="🔐 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>

    <Accordion title="🔑 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
    </Accordion>
  </Step>

  <Step title="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**

    <img src="https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/step5.png?fit=max&auto=format&n=ilUsF_4RyDqP505q&q=85&s=96a77036378d15025942f8b397162ed0" alt="Windsurf IDE Settings" width="1920" height="1080" data-path="images/knowledge-base/windsurf/step5.png" />

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

    <img src="https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/step6.png?fit=max&auto=format&n=ilUsF_4RyDqP505q&q=85&s=0857cac2b93fa04c154f20b77cbeda54" alt="Windsurf Cascade and MCPs settings" width="1920" height="1080" data-path="images/knowledge-base/windsurf/step6.png" />

    <img src="https://mintcdn.com/klavisai/ilUsF_4RyDqP505q/images/knowledge-base/windsurf/step7.png?fit=max&auto=format&n=ilUsF_4RyDqP505q&q=85&s=4145e789b2e27bc4465ceaeb45dbc445" alt="Get Raw Config file in Windsurf" width="1920" height="1080" data-path="images/knowledge-base/windsurf/step7.png" />

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

    <img src="https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step8.png?fit=max&auto=format&n=IPvQfNqZrLr0INmh&q=85&s=ac769a02f0789481453456ca3779f0df" alt="Paste strata URL in mcp_config.json file of Windsurf IDE" width="1153" height="296" data-path="images/knowledge-base/windsurf/step8.png" />

    <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
    </Tip>
  </Step>

  <Step title="Verify Tools Loading">
    <img src="https://mintcdn.com/klavisai/IPvQfNqZrLr0INmh/images/knowledge-base/windsurf/step9.png?fit=max&auto=format&n=IPvQfNqZrLr0INmh&q=85&s=8dccc7be45ed59367daa3b4cb09bab1d" alt="Strata Configuration in Windsurf" width="1793" height="1008" data-path="images/knowledge-base/windsurf/step9.png" />

    <Note>
      📋 **Reopen Windsurf Settings** to apply the new configuration
    </Note>
  </Step>

  <Step title="Start Using in Windsurf Chat">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/klavisai/images/knowledge-base/windsurf/step10.jpg" alt="Using Strata in Windsurf Chat" />

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

    <CodeGroup>
      ```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"
      ```
    </CodeGroup>

    <Tip>
      🎯 Windsurf Chat automatically detects when to use **Strata** based on context - no need to specify explicitly!
    </Tip>
  </Step>

  <Step title="Happy Building! 🎉">
    You're all set! Your **Strata** MCP server is now integrated with Windsurf IDE.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="🔧 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>

  <Accordion title="🔐 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>

  <Accordion title="⚡ Performance Issues">
    * Limit the number of active MCP servers
    * Check your internet connection speed
    * Restart Windsurf IDE periodically
    * Contact support if issues persist
  </Accordion>
</AccordionGroup>

## Need Help?

<CardGroup cols={2}>
  <Card title="Community" icon="discord">
    Join our Discord for community support and discussions
  </Card>

  <Card title="Support" icon="headphones">
    Contact our technical support team for assistance
  </Card>
</CardGroup>

***