Como conectar o Fine Structure ao Windsurf com MCP

O Windsurf Cascade se conecta a servidores MCP por meio do mcp_config.json. O Fine Structure funciona como um servidor remote HTTP com token.

O Windsurf é bom para um fluxo de trabalho em que o Cascade ajuda a construir e editar código. Conectar o Fine Structure via MCP dá ao Cascade uma forma controlada de entender os seus aplicativos e de atuar sobre eles por meio das ferramentas da plataforma.

O arquivo de configuração: O Windsurf usa normalmente o ~/.codeium/windsurf/mcp_config.json.

Campo URL: Para um servidor MCP remoto, use serverUrl ou url de acordo com a versão da configuração, sendo serverUrl a escolha segura na documentação atual.

Segredos: Você pode usar variáveis de ambiente se a equipe preferir não guardar o token diretamente no arquivo.

Crie uma conexão controlada

Comece com um token app-scoped se o Cascade trabalha apenas em um aplicativo. Isso reduz o risco e facilita a gestão de clientes.

Passos

• Entre na sua conta do Fine Structure.
• Abra a página MCP pelo botão Create MCP token na documentação, ou diretamente por /mcp.
• Escolha se o agente terá acesso a todos os aplicativos de sua propriedade ou apenas a um aplicativo.
• Escolha as permissões: Read only para testes, Build para edição, Full access apenas para um agente em que você confia.
• Clique em Create MCP setup e copie o token ou o bloco de configuração. O token é exibido apenas uma vez.
• No Windsurf, abra o Cascade e então MCP settings ou View raw config.
• Cole a configuração abaixo dentro de mcpServers.
• Salve e atualize os servidores MCP.
• Peça ao Cascade para executar uma verificação de conexão simples por meio de get_platform_guide.

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

Verificação de integridade: Se o Windsurf não exibir o servidor, confirme que o JSON está válido, que o token inclui Bearer antes do valor e que não falta uma vírgula após um servidor anterior.