Конфигурация

LINZA настраивается через переменные окружения в MCP-клиенте. Отдельный YAML-файл не нужен: достаточно указать папку, провайдер эмбеддингов и, если нужно, набор инструментов.

Основные переменные

Переменная	Что задаёт
LINZA_VAULT	Абсолютный путь к рабочей папке или хранилищу Markdown. Обязательная переменная.
LINZA_EMBED_PROVIDER	Провайдер эмбеддингов: lmstudio, ollama или openai.
LINZA_EMBED_URL	Адрес локального или удалённого эндпоинта эмбеддингов.
LINZA_EMBED_MODEL	Имя модели эмбеддингов.
LINZA_EMBED_KEY	API-ключ, если провайдер его требует.
LINZA_TOOL_SURFACE	Набор инструментов: default для обычной работы или advanced для отладки.

Набор инструментов

В обычной работе лучше оставлять LINZA_TOOL_SURFACE=default. Агент видит компактный набор: диагностика, индекс, поиск, карта, карточки проверки, обучение, рост, объяснение связей и экспорт контекста.

advanced нужен для разработки и диагностики: там появляются низкоуровневые действия, которые помогают разбирать состояние локальной базы. Для пользовательского сценария они обычно лишние.

Пример MCP-конфигурации

{
  "mcpServers": {
    "linza": {
      "command": "linza-mcp",
      "env": {
        "LINZA_VAULT": "/absolute/path/to/your-folder",
        "LINZA_EMBED_PROVIDER": "lmstudio",
        "LINZA_EMBED_URL": "http://127.0.0.1:1234/v1",
        "LINZA_EMBED_MODEL": "your-embedding-model-name",
        "LINZA_TOOL_SURFACE": "default"
      }
    }
  }
}

Для VS Code / Copilot MCP структура почти такая же, но используется ключ servers:

{
  "servers": {
    "linza": {
      "type": "stdio",
      "command": "linza-mcp",
      "env": {
        "LINZA_VAULT": "/absolute/path/to/your-folder",
        "LINZA_EMBED_PROVIDER": "lmstudio",
        "LINZA_EMBED_URL": "http://127.0.0.1:1234/v1",
        "LINZA_EMBED_MODEL": "your-embedding-model-name"
      }
    }
  }
}

Эмбеддинги

Для локальной работы обычно удобнее LM Studio: данные остаются на машине, а LINZA получает векторы для поиска, карты тем и карточек проверки.

Если меняете провайдер, модель или размерность эмбеддингов, сделайте полную переиндексацию. Векторы из разных пространств нельзя надёжно сравнивать между собой.