> ## 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](/ja/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/Q0F2YyND00IivWI1/ja/images/windsurf_client_chat_assistant.png?fit=max&auto=format&n=Q0F2YyND00IivWI1&q=85&s=e083ec22ac1c1616e654b94425eb3477" alt="Windsurf Chat Assistant" width="951" height="502" data-path="ja/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/Q0F2YyND00IivWI1/ja/images/windsurf_client_config_file.png?fit=max&auto=format&n=Q0F2YyND00IivWI1&q=85&s=6075b6b5ed5376f36204e12a77dd1ab1" alt="Windsurf config file" width="520" height="266" data-path="ja/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/Q0F2YyND00IivWI1/ja/images/windsurf_client_start_MCP.png?fit=max&auto=format&n=Q0F2YyND00IivWI1&q=85&s=26a08b37137df1d3cfe4994ce443ed2a" alt="Windsurf start MCP server" width="576" height="270" data-path="ja/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/Q0F2YyND00IivWI1/ja/images/windsurf_client_sample_chat.png?fit=max&auto=format&n=Q0F2YyND00IivWI1&q=85&s=1f7ed4a7f151e74cab93afd19de05ffc" alt="Windsurf sample chat" width="2511" height="1001" data-path="ja/images/windsurf_client_sample_chat.png" />
    </Frame>
  </Step>
</Steps>
