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

# Windsurf

> Standard MCP: paste the config into mcp_config.json and restart. About two minutes, authenticated with an API key.

Windsurf authenticates to xysq with a bearer token and reads MCP servers from a JSON config file. Takes about two minutes.

<Steps>
  <Step title="Generate your API key">
    Open the Windsurf connect guide in [app.xysq.ai](https://app.xysq.ai) (**Connect → Windsurf**) and generate a key. The full value is shown exactly once; copy it right away.
  </Step>

  <Step title="Copy your MCP config">
    Add this entry to Windsurf's MCP config:

    ```json theme={"dark"}
    {
      "mcpServers": {
        "xysq": {
          "url": "https://api.xysq.ai/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Paste into Windsurf and restart">
    Paste the JSON into Windsurf's MCP config file, then **restart Windsurf** so it picks up the new server.

    | OS            | Location                                          |
    | ------------- | ------------------------------------------------- |
    | macOS / Linux | `~/.codeium/windsurf/mcp_config.json`             |
    | Windows       | `%USERPROFILE%\.codeium\windsurf\mcp_config.json` |

    <Tip>If the file doesn't exist yet, create it. Check **Output → MCP** in Windsurf for connection logs if anything looks off.</Tip>
  </Step>

  <Step title="Verify the connection">
    In Windsurf, open the agent panel and ask:

    ```text theme={"dark"}
    Use the xysq tools to pull my context.
    ```

    The in-app guide watches for the first call and marks the connection verified.
  </Step>
</Steps>