Passer au contenu principal

​
Prérequis

  • Windsurf installé
  • Linkly AI Desktop démarré, service MCP en cours d’exécution

​
Étapes de configuration

Éditez le fichier de configuration MCP et ajoutez dans mcpServers :
// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "linkly-ai": {
      "serverUrl": "http://127.0.0.1:60606/mcp"
    }
  }
}
Enregistrez et redémarrez Windsurf.
Le fichier de configuration supporte la syntaxe ${env:VAR_NAME} pour gérer l’API Key via des variables d’environnement, évitant ainsi de l’écrire en clair dans le fichier de configuration.

​
Commencer à utiliser

Une fois la configuration terminée, posez directement vos questions dans le panneau Cascade de Windsurf. Cascade appellera automatiquement les outils Linkly AI. Par exemple :
  • “Recherche dans mes documents le contenu relatif à la conception d’API”
  • “Lis le document de spécifications du projet et résume les points clés”

​
Questions fréquentes

Confirmez que Windsurf a bien redémarré complètement (pas seulement fermer la fenêtre) et que le format JSON du fichier de configuration est correct. Vous pouvez consulter l’état du serveur MCP dans les paramètres de Cascade.
Windsurf Cascade supporte au maximum 100 outils (au total de tous les serveurs MCP). Si le nombre total d’outils dépasse cette limite, certains outils pourraient ne pas être disponibles.