Comment connecter Fine Structure à Windsurf avec MCP

Windsurf Cascade se connecte aux serveurs MCP via mcp_config.json. Fine Structure fonctionne comme un serveur remote HTTP avec un token.

Windsurf est adapté à un flux de travail dans lequel Cascade aide à construire et à modifier du code. Connecter Fine Structure via MCP offre à Cascade un moyen contrôlé de comprendre vos applications et d'agir dessus à travers les outils de la plateforme.

Le fichier de configuration: Windsurf utilise généralement ~/.codeium/windsurf/mcp_config.json.

Le champ URL: Pour un serveur MCP distant, utilisez serverUrl ou url selon la version de la configuration, sachant que serverUrl est le choix sûr dans la documentation actuelle.

Secrets: Vous pouvez utiliser des variables d'environnement si l'équipe préfère ne pas stocker le token directement dans le fichier.

Créez une connexion contrôlée

Commencez par un token app-scoped si Cascade ne travaille que sur une seule application. Cela réduit le risque et facilite la gestion des clients.

Étapes

• Connectez-vous à votre compte Fine Structure.
• Ouvrez la page MCP via le bouton Create MCP token dans la documentation, ou directement via /mcp.
• Choisissez si l'agent aura accès à toutes les applications que vous possédez ou à une seule application.
• Choisissez les autorisations : Read only pour les tests, Build pour l'édition, Full access uniquement pour un agent en qui vous avez confiance.
• Cliquez sur Create MCP setup et copiez le token ou le bloc de configuration. Le token n'est affiché qu'une seule fois.
• Dans Windsurf, ouvrez Cascade puis MCP settings ou View raw config.
• Collez la configuration ci-dessous à l'intérieur de mcpServers.
• Enregistrez et actualisez les serveurs MCP.
• Demandez à Cascade d'exécuter une vérification de connexion simple via get_platform_guide.

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

Vérification de bon fonctionnement: Si Windsurf n'affiche pas le serveur, vérifiez que le JSON est valide, que le token comporte Bearer avant la valeur et qu'il ne manque pas une virgule après un serveur précédent.