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

# Использование Linkly AI в Windsurf

> Подключите локальную базу знаний Linkly AI к Windsurf IDE, чтобы помощник программиста мог искать и читать ваши личные документы

## Предварительные требования

* Установлен [Windsurf](https://windsurf.com)
* Linkly AI Desktop запущен, а служба MCP активна

## Настройка

<Tabs>
  <Tab title="MCP HTTP (рекомендуется)" icon="globe">
    Откройте файл конфигурации MCP и добавьте в `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>

    Сохраните файл и перезапустите Windsurf.
  </Tab>

  <Tab title="MCP Stdio" icon="terminal">
    Сначала [установите Linkly AI CLI](/docs/ru/use-cli).

    Добавьте в `mcpServers` файла конфигурации следующее:

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

    Сохраните файл и перезапустите Windsurf.
  </Tab>

  <Tab title="Удалённый доступ" icon="globe">
    Сначала завершите [настройку удалённого доступа](/docs/ru/use-in-remote). Туннель в приложении должен иметь статус{" "}

    <Badge stroke color="green">
      ● Подключено
    </Badge>

    .

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

<Tip>Файл конфигурации поддерживает синтаксис `${env:VAR_NAME}`, поэтому API Key можно передавать через переменные окружения, не сохраняя его открытым текстом.</Tip>

## Начало работы

После настройки задавайте вопросы в панели Cascade — она автоматически вызовет инструменты Linkly AI. Например:

* «Найди в моих документах сведения о проектировании API»
* «Прочитай документ с требованиями к проекту и обобщи основные положения»

## Частые вопросы

<AccordionGroup>
  <Accordion title="Инструменты не отображаются в Cascade">Полностью перезапустите Windsurf, а не просто закройте окно, и проверьте формат JSON. Состояние MCP-сервера доступно в настройках Cascade.</Accordion>
  <Accordion title="Ограничение количества инструментов">Windsurf Cascade поддерживает не более 100 инструментов от всех MCP-серверов. При превышении лимита некоторые инструменты могут стать недоступны.</Accordion>
</AccordionGroup>