Skip to main content

Prerequisites

  • Windsurf installed
  • Linkly AI Desktop running with the MCP service active

Configuration Steps

The configuration file supports ${env:VAR_NAME} syntax, allowing you to manage API Keys via environment variables to avoid writing them in plaintext in the configuration file.

Getting Started

Once configured, ask questions directly in Windsurf’s Cascade panel, and Cascade will automatically call Linkly AI’s tools. For example:
  • “Search my documents for content about API design”
  • “Read the project requirements document and summarize the key points”

FAQ

Confirm that Windsurf has been fully restarted (not just closing the window), and that the configuration file JSON format is correct. You can check the MCP server status in Cascade settings.
Windsurf Cascade supports a maximum of 100 tools across all MCP servers. If the total number of tools exceeds this limit, some tools may become unavailable.