How to connect Fine Structure to Windsurf with MCP

Windsurf Cascade connects to MCP servers through mcp_config.json. Fine Structure works as a remote HTTP server with a token.

Windsurf is good for a workflow where Cascade helps build and edit code. Connecting Fine Structure through MCP gives Cascade a controlled way to understand your apps and act on them through the platform's tools.

The configuration file: Windsurf usually uses ~/.codeium/windsurf/mcp_config.json.

The URL field: For a remote MCP server, use serverUrl or url depending on the configuration version, where serverUrl is the safe choice in the current documentation.

Secrets: You can use environment variables if your team prefers not to store the token directly in the file.

Create a controlled connection

Start with an app-scoped token if Cascade only works on a single app. This reduces risk and makes client management easier.

Steps

• Sign in to your Fine Structure account.
• Open the MCP page using the Create MCP token button in the docs, or go directly to /mcp.
• Choose whether the agent gets access to all the apps you own or to a single app only.
• Choose permissions: Read only for testing, Build for editing, Full access only for an agent you trust.
• Click Create MCP setup and copy the token or the configuration block. The token is shown only once.
• In Windsurf, open Cascade and then MCP settings or View raw config.
• Paste the config below inside mcpServers.
• Save and refresh the MCP servers.
• Ask Cascade to run a simple connection check using get_platform_guide.

{
  "mcpServers": {
    "fine-structure": {
      "serverUrl": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

Health check: If Windsurf doesn't show the server, check that the JSON is valid, that the token includes Bearer before the value, and that there's no missing comma after a previous server.