Быстрый старт

Быстрый старт нужен, чтобы LINZA увидела одну рабочую папку и показала первые проверяемые предложения. Для запуска нужны пакет, путь к папке, MCP-клиент и адрес API эмбеддингов.

MCP-процесс может подняться без проверки модели. Индексирование, семантический поиск и действия, связанные с векторами, обращаются к API эмбеддингов уже во время работы.

Перед установкой

Выберите одну рабочую папку. LINZA будет читать из нее Markdown-файлы и документы, а служебные данные хранить рядом в .linza/linza.db.

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

Установить

python -m pip install linza-mcp

Для прямого чтения PDF:

python -m pip install "linza-mcp[pdf]"

Без PDF-дополнения LINZA все равно читает Markdown, TXT, JSON, DOCX и XLSX.

Подготовить эмбеддинги

Локальный вариант через LM Studio:

1. Откройте LM Studio.
2. Скачайте модель эмбеддингов.
3. Запустите Local Server.
4. Проверьте адрес API: http://127.0.0.1:1234/v1.

Если меняете провайдера, модель или размерность, запустите полное переиндексирование.

Подключить MCP

Замените /absolute/path/to/your-folder на рабочую папку. Без LINZA_VAULT сервер берет ./vault, поэтому для рабочего проекта путь лучше задавать явно.

{
  "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"
      }
    }
  }
}

VS Code / Copilot MCP обычно использует верхний ключ servers и поле "type": "stdio".

После первого индексирования в рабочей папке появится .linza/. Внутри будут индекс, чанки, записи эмбеддингов, карточки ревью, принятые решения, trace-записи и пакеты контекста. Удаление этой папки сбрасывает служебное состояние LINZA; исходные файлы остаются на месте.

Переменные

Переменная	Значение
LINZA_VAULT	Рабочая папка; по умолчанию ./vault
LINZA_EMBED_PROVIDER	lmstudio, ollama или openai
LINZA_EMBED_URL	URL API эмбеддингов
LINZA_EMBED_MODEL	Имя модели эмбеддингов
LINZA_EMBED_KEY	Ключ для API, если он нужен
LINZA_TOOL_SURFACE	default или advanced

Первый безопасный маршрут

Начните с действий только на чтение. Они показывают состояние папки и очередь предложений без записи.

1. agent_workspace(action="doctor") проверяет готовность сайдкара, индекса, входящих материалов и ревью.
2. index_all строит индекс Markdown-файлов.
3. agent_workspace(action="map") показывает карту папки и ближайшие шаги.
4. agent_workspace(action="review_next") выводит карточки с ID, доказательствами и предпросмотром записи.
5. agent_workspace(action="apply_review_items", item_ids=[...], dry_run=true) показывает, что изменится при применении выбранных ID.

Переход к dry_run=false имеет смысл только после просмотра точных ID.

Проверить

linza-mcp --version

После подключения попросите агента:

Проверь LINZA через agent_workspace(action="doctor").
Запусти index_all для рабочей папки.
Покажи agent_workspace(action="map") и первые предложения на ревью.
Ничего не применяй без предварительного просмотра и точных ID.