Saltar al contenido principal

​
Requisitos previos

  • Windsurf instalado
  • Linkly AI Desktop iniciado con el servicio MCP en ejecución

​
Pasos de configuración

Edita el archivo de configuración de MCP y agrega en mcpServers:
// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "linkly-ai": {
      "serverUrl": "http://127.0.0.1:60606/mcp"
    }
  }
}
Guarda y reinicia Windsurf.
El archivo de configuración admite la sintaxis ${env:VAR_NAME} para leer variables de entorno, evitando escribir la API Key en texto plano en el archivo de configuración.

​
Empezar a usar

Una vez completada la configuración, haz preguntas directamente en el panel Cascade de Windsurf. Cascade llamará automáticamente a las herramientas de Linkly AI. Por ejemplo:
  • “Busca en mis documentos contenido sobre diseño de API”
  • “Lee el documento de requisitos del proyecto y resume los puntos clave”

​
Preguntas frecuentes

Confirma que Windsurf se haya reiniciado completamente (no solo cerrar la ventana) y que el formato JSON del archivo de configuración sea correcto. Puedes verificar el estado del servidor MCP en la configuración de Cascade.
Windsurf Cascade admite un máximo de 100 herramientas (sumando todos los servidores MCP). Si el número total de herramientas supera el límite, algunas pueden no estar disponibles.