Windsurf Integration

Windsurf supports MCP via its Cascade feature. The server can auto-start when you open Windsurf.

Setup Steps

Step 1: Open Windsurf Settings

  1. Open Windsurf
  2. Go to Settings → Advanced Settings

Step 2: Find Cascade Section

Scroll down to the Cascade section where MCP servers are configured.

Step 3: Add MCP Configuration

Add the following configuration:

{
  "mcpServers": {
    "pointa": {
      "command": "npx",
      "args": ["-y", "pointa-server"]
    }
  }
}

Step 4: Save and Restart

  1. Save your settings
  2. Restart Windsurf completely

Verify Connection

After restarting:

  1. Open a project in Windsurf
  2. Open the Cascade AI assistant
  3. Ask about available tools or try reading annotations

Using Pointa with Windsurf

Implement Annotations

Open Cascade and ask:

  • "Implement the Pointa annotations"
  • "Check Pointa for any feedback to implement"
  • "Work on pending Pointa changes"

Bug Reports

  • "Check Pointa for bug reports"
  • "Investigate bugs from Pointa"

Design Changes

  • "Apply the design changes from Pointa"
  • "Implement Pointa design mode edits"

Alternative Configuration

If auto-start doesn't work, use the URL-based approach:

Step 1: Start Server Manually

npx pointa-server start

Step 2: Use URL Configuration

{
  "mcpServers": {
    "pointa": {
      "serverUrl": "http://127.0.0.1:4242/mcp"
    }
  }
}

Note: Windsurf uses serverUrl (not url) for URL-based MCP configuration.

Troubleshooting

Server not detected

Check server status:

npx pointa-server status

Start if needed:

npx pointa-server start

Configuration not loading

  1. Ensure JSON syntax is valid
  2. Save settings and fully restart Windsurf
  3. Check Windsurf logs for MCP-related errors

Tools not appearing in Cascade

  1. Verify configuration is in the Cascade section
  2. Restart Windsurf
  3. Try the URL-based configuration as fallback

Related