Guide for Windsurf

Integrate Windsurf with AI Architect for more accurate, codebase-aware AI assistance.

Use Bito's AI Architect with Windsurf to enhance your AI-powered coding experience.

Once connected via MCP (Model Context Protocol), Windsurf can leverage AI Architect’s deep contextual understanding of your project, enabling more accurate code suggestions, explanations, and code insights.

Prerequisites

1. Contact Bito support team at [email protected] to have your repositories indexed. You will get an MCP server URL and Auth token from Bito.

2. Download BitoAIArchitectGuidelines.md file. You will need to copy/paste the content from this file later when configuring AI Architect.

Set up AI Architect

Follow the setup instructions for your operating system:

• Windows

• macOS

• Linux

Windows

1

Create Windsurf config directory

1. Press Win + R

2. Type: %USERPROFILE%\.codeium\windsurf

3. Press Enter

If the folder doesn't exist:

1. Navigate to: %USERPROFILE%\.codeium

2. Create new folder: windsurf

2

Create MCP configuration file

1. In the windsurf folder, create: mcp_config.json

2. Open with Notepad or VS Code

3. Paste:

{
  "mcpServers": {
    "Bito": {
      "transport": "http",
      "url": "Enter_MCP_Server_URL_Here", // e.g. "https://mcp.bito.ai/123456/mcp"
      "headers": {
        "Authorization": "Enter_Auth_Token_Here" // e.g. "Bearer xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      },
      "timeout": 60000,
      "disabled": false
    }
  }
}

Note:

• Replace the text Enter_MCP_Server_URL_Here with the actual MCP server URL.

• Replace the text Enter_Auth_Token_Here with the actual auth token.

1. Save

3

Create workspace instructions file

1. In your project root, create folder: .windsurf

2. Inside .windsurf, create: instructions.md

3. Open with text editor

4. Copy and paste ALL contents of BitoAIArchitectGuidelines.md into this file

5. Save

4

Activate in Windsurf

1. Open Windsurf

2. Click Settings (gear icon)

3. Navigate to Cascade > Model Context Protocol (MCP) Servers

4. You should see "BitoAIArchitect" listed

5. Click Refresh if needed

5

Restart Windsurf

Close and reopen Windsurf.

File paths:

• Global config: C:\Users\[YourUsername]\.codeium\windsurf\mcp_config.json

• Workspace instructions: [ProjectRoot]\.windsurf\instructions.md

macOS

1

Create Windsurf config directory

1. Open Terminal

2. Run:

mkdir -p ~/.codeium/windsurf

2

Create MCP configuration file

1. Run:

nano ~/.codeium/windsurf/mcp_config.json

1. Paste:

{
  "mcpServers": {
    "Bito": {
      "transport": "http",
      "url": "Enter_MCP_Server_URL_Here", // e.g. "https://mcp.bito.ai/123456/mcp"
      "headers": {
        "Authorization": "Enter_Auth_Token_Here" // e.g. "Bearer xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      },
      "timeout": 60000,
      "disabled": false
    }
  }
}

Note:

• Replace the text Enter_MCP_Server_URL_Here with the actual MCP server URL.

• Replace the text Enter_Auth_Token_Here with the actual auth token.

1. Save: Ctrl + O, Enter, Ctrl + X

3

Create workspace instructions file

1. In your project root, run:

mkdir -p .windsurf

nano .windsurf/instructions.md

1. Copy and paste ALL contents of BitoAIArchitectGuidelines.md into this file

2. Save: Ctrl + O, Enter, Ctrl + X

4

Activate in Windsurf

1. Open Windsurf

2. Click Settings

3. Navigate to Cascade > Model Context Protocol (MCP) Servers

4. Click Refresh to load changes

5. "BitoAIArchitect" should appear

5

Restart Windsurf

Close and reopen Windsurf.

File paths:

• Config: ~/.codeium/windsurf/mcp_config.json

• Workspace instructions: [ProjectRoot]/.windsurf/instructions.md

Linux

1

Create Windsurf config directory

1. Open Terminal

2. Run:

mkdir -p ~/.codeium/windsurf

2

Create MCP configuration file

1. Run:

nano ~/.codeium/windsurf/mcp_config.json

1. Paste:

{
  "mcpServers": {
    "Bito": {
      "transport": "http",
      "url": "Enter_MCP_Server_URL_Here", // e.g. "https://mcp.bito.ai/123456/mcp"
      "headers": {
        "Authorization": "Enter_Auth_Token_Here" // e.g. "Bearer xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      },
      "timeout": 60000,
      "disabled": false
    }
  }
}

Note:

• Replace the text Enter_MCP_Server_URL_Here with the actual MCP server URL.

• Replace the text Enter_Auth_Token_Here with the actual auth token.

1. Save: Ctrl + O, Enter, Ctrl + X

3

Create workspace instructions file

1. In your project root, run:

mkdir -p .windsurf

nano .windsurf/instructions.md

1. Copy and paste ALL contents of BitoAIArchitectGuidelines.md into this file

2. Save: Ctrl + O, Enter, Ctrl + X

4

Activate in Windsurf

1. Open Windsurf

2. Click Settings

3. Navigate to Cascade > Model Context Protocol (MCP) Servers

4. Click Refresh

5. "BitoAIArchitect" should appear

5

Restart Windsurf

Close and reopen Windsurf.

File paths:

• Config: ~/.codeium/windsurf/mcp_config.json

• Workspace instructions: [ProjectRoot]/.windsurf/instructions.md