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

# Windsurf

> Windsurf is an AI-powered integrated development environment (IDE) developed by Codeium. It combines intelligent coding assistance with a collaborative Flow system for seamless human-AI interaction.

## Prerequisites

Before you can configure and use Windsurf with Connect AI Embed, you must first do the following:

* Install the Windsurf IDE (MCP integrations do not support extensions or plugins).

* Generate an [OAuth JWT bearer token](/en/API/Authentication-Embedded). Copy this down, as it acts as your password during authentication.

## Connect Windsurf to the Connect AI Embed MCP

<Steps>
  <Step>
    Open Cascade Code Chat Assistant, either by pressing CTRL+L or by clicking the button highlighted below.

    <Frame>
      <img src="https://mintcdn.com/cdata/L-wC-3th9ZUn-60n/en/images/windsurf_client_chat_assistant.png?fit=max&auto=format&n=L-wC-3th9ZUn-60n&q=85&s=6487dd4f308019deaabf0ea003452960" alt="Windsurf Chat Assistant" width="951" height="502" data-path="en/images/windsurf_client_chat_assistant.png" />
    </Frame>
  </Step>

  <Step>
    In Windsurf, open the MCP configuration file, `mcp_config.json`, which is created during installation. The default path is `C:\Users\<YourUsername>\.codeium\windsurf\mcpconfig.json`. You can also open it directly from the IDE by clicking the MCPs button in the chat dialog, and then selecting the **Config** icon, as shown below:

    <Frame>
      <img src="https://mintcdn.com/cdata/L-wC-3th9ZUn-60n/en/images/windsurf_client_config_file.png?fit=max&auto=format&n=L-wC-3th9ZUn-60n&q=85&s=926c5fe2d802140560c071794db66680" alt="Windsurf config file" width="520" height="266" data-path="en/images/windsurf_client_config_file.png" />
    </Frame>
  </Step>

  <Step>
    Copy and paste the following into the `mcp_config.json` file. Replace the authorization header with the credentials obtained in the prerequisites.

    ```json theme={null}
    {
      "mcpServers": {
        "cdata-mcp": {
          "serverUrl": "https://mcp.cloud.cdata.com/mcp",
          "headers": {
            "Authorization": "Bearer OAUTH_JWT_TOKEN" //Replace with your OAuth JWT Token
          }
        }
      }
    }
    ```
  </Step>

  <Step>
    Start the MCP server by clicking the **MCPs** button in the chat dialog and clicking the **Refresh** button.

    <Frame>
      <img src="https://mintcdn.com/cdata/L-wC-3th9ZUn-60n/en/images/windsurf_client_start_MCP.png?fit=max&auto=format&n=L-wC-3th9ZUn-60n&q=85&s=69357f70da94bab66abc1b67aec08531" alt="Windsurf start MCP server" width="576" height="270" data-path="en/images/windsurf_client_start_MCP.png" />
    </Frame>

    Once the MCP server is started, a green indicator appears.
  </Step>

  <Step>
    You can now chat with the assistant. Windsurf lists the available tools, the connections, and a result set of a given table of a given connection.

    <Frame>
      <img src="https://mintcdn.com/cdata/L-wC-3th9ZUn-60n/en/images/windsurf_client_sample_chat.png?fit=max&auto=format&n=L-wC-3th9ZUn-60n&q=85&s=9731bbf5d961972bdb79022856237bde" alt="Windsurf sample chat" width="2511" height="1001" data-path="en/images/windsurf_client_sample_chat.png" />
    </Frame>
  </Step>
</Steps>