> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar Linkly AI en Windsurf

> Integra la base de conocimiento local de Linkly AI en el IDE Windsurf para que el asistente de programación con IA pueda buscar y leer tus documentos privados

## Requisitos previos

* [Windsurf](https://windsurf.com) instalado
* Linkly AI Desktop iniciado con el servicio MCP en ejecución

## Pasos de configuración

<Tabs>
  <Tab title="MCP HTTP (recomendado)" icon="globe">
    Edita el archivo de configuración de MCP y agrega en `mcpServers`:

    <CodeGroup>
      ```json macOS / Linux theme={null}
      // ~/.codeium/windsurf/mcp_config.json
      {
        "mcpServers": {
          "linkly-ai": {
            "serverUrl": "http://127.0.0.1:60606/mcp"
          }
        }
      }
      ```

      ```json Windows theme={null}
      // %USERPROFILE%\.codeium\windsurf\mcp_config.json
      {
        "mcpServers": {
          "linkly-ai": {
            "serverUrl": "http://127.0.0.1:60606/mcp"
          }
        }
      }
      ```
    </CodeGroup>

    Guarda y reinicia Windsurf.
  </Tab>

  <Tab title="MCP Stdio" icon="terminal">
    Primero debes [instalar Linkly AI CLI](/docs/es/use-cli).

    Edita el archivo de configuración y agrega en `mcpServers`:

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "command": "linkly",
          "args": ["mcp"]
        }
      }
    }
    ```

    Guarda y reinicia Windsurf.
  </Tab>

  <Tab title="Acceso remoto" icon="globe">
    Primero completa la [configuración de acceso remoto](/docs/es/use-in-remote), con el túnel de escritorio mostrando{" "}

    <Badge stroke color="green">
      ● Conectado
    </Badge>

    .

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "serverUrl": "https://mcp.linkly.ai/mcp",
          "headers": {
            "Authorization": "Bearer ${env:LINKLY_API_KEY}"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Tip>
  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.
</Tip>

## 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

<AccordionGroup>
  <Accordion title="Las herramientas no aparecen en Cascade">
    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.
  </Accordion>

  <Accordion title="Límite de número de herramientas">
    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.
  </Accordion>
</AccordionGroup>