Перейти к содержимому

Для пользователей Cline

Cline планирует, прежде чем действовать. Дайте плану карту.

Cline читает файлы, запускает команды и спрашивает, прежде чем что-то менять. Maguyva индексирует весь репозиторий и возвращает его через MCP, поэтому режим Plan начинается с реальных мест вызова, а не со списка каталогов.

Тариф Free: 3 репозитория, До 50 тыс. проиндексированных строк, без банковской карты.

.clinerules — для того, как работать. Maguyva — для того, что код говорит сейчас.

Что нужно знать о Cline

Четыре факта именно о Cline.

// файл конфигурации

cline_mcp_settings.json

Откройте его через значок MCP Servers на панели Cline: вкладка Configure, затем Configure MCP Servers. Серверы задаются в mcpServers.

// транспорт

Удалённо, по URL

Cline подключается к эндпоинту Maguyva по Streamable HTTP. Никаких локальных процессов, никакого Node.js.

// ключ

Заголовок как есть

Ключ пишется прямо в заголовок Authorization, как в примерах самого Cline. Файл настроек хранится в пользовательском хранилище редактора, а не в репозитории.

// тип

streamableHttp, а не SSE

Оставьте в записи "type": "streamableHttp": без типа Cline считает транспорт устаревшим SSE. Перечислите в autoApprove инструменты, которым доверяете, чтобы пропускать их подтверждение.

Правила Cline — это рабочее соглашение. Используйте их.

# .clinerules/testing.md
- Запускай тесты, прежде чем отмечать задачу выполненной.
- Спрашивай, прежде чем добавлять зависимость.

Правила рабочего пространства — это Markdown-файлы в .clinerules/ или .cline/rules/; Cline также читает AGENTS.md, .cursorrules и .windsurfrules. Правилам место для:

  • Команд, которые должен запускать Cline.
  • Ограничений для конкретного пути через glob во frontmatter.
  • Соглашений команды, которые вы устали повторять.

Правила говорят Cline, как себя вести. Они не говорят, какие сервисы читают таблицу, которую он сейчас будет мигрировать.

Где правил и чтения файлов уже не хватает

Три пробела, которые Cline закрывает, читая всё больше файлов, по одному запросу за раз.

// план по списку каталогов

Режим Plan рассуждает на основе того, что Cline успел прочитать. В большом репозитории это дерево каталогов и горстка файлов, и план наследует все пробелы.

// каждое чтение — это отдельный запрос

Каждый файл, который Cline открывает, чтобы сориентироваться, стоит токенов и одного запроса к модели. Ориентирование в незнакомом пакете может съесть большую часть окна контекста ещё до первой правки.

// текстовый поиск находит строки, а не вызывающих

“Кто ещё это вызывает?” — вопрос для графа. Текстовый поиск находит строку, но не отличает настоящих вызывающих от комментария, мока и метода с тем же именем.

Maguyva как MCP-сервер в Cline

Одна запись в mcpServers даёт Cline:

  • 11 инструментов для вашего проиндексированного репозитория семантический, структурный (AST), графовый и текстовый поиск, а также поиск символов, зависимые и получение файлов.
  • Ответы с путями к файлам и номерами строк по более чем 285 языкам, чтобы план ссылался на настоящие файлы.
  • Инструменты только для чтения Инструменты Maguyva обращаются к индексу. Ни один из них не меняет ваши файлы.

Правила Cline говорят Cline, как работать.

Maguyva даёт Cline карту для планирования.

Два рабочих процесса

Планируйте по карте, потом действуйте.

// workflow 01

Спланировать изменение по реальным местам вызова

cline plan> перенеси обновление сессии в пакет auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ План перечисляет три места вызова ещё до перехода в режим Act.
[exit 0]

План называет каждый файл, который затронет, так что вы одобряете список, а не догадку.

// workflow 02

Найти настоящую реализацию, а не тестовую фикстуру

cline> как у нас считается пропорциональное списание?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← реализация
  test/billing/proration.spec.ts:7   ← фикстура

→ Cline читает один файл вместо шести.
[exit 0]

Ранжированные результаты ставят реализацию выше фикстуры с тем же именем.

Настройка в Cline

Три шага. Тариф Free: 3 репозитория, До 50 тыс. проиндексированных строк, без банковской карты.

  1. // step 01

    Проиндексируйте репозиторий на maguyva.ai

    Выберите тот, который вы уже знаете, чтобы оценить ответы.

  2. // step 02

    Добавьте Maguyva в настройки MCP в Cline

    cline_mcp_settings.json

    {
      "mcpServers": {
        "maguyva": {
          "type": "streamableHttp",
          "url": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer mgv_xxxx"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
  3. // step 03

    Замените заглушку и задайте вопрос

    Замените mgv_xxxx своим API-ключом и сохраните файл. Задайте вопрос, ответ на который вы уже знаете, и откройте процитированный файл.