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

Canonical source: https://maguyva.ai/ru/for-cline

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

> .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 — это рабочее соглашение. Используйте их.

```text
# .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 *карту для планирования*.

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

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

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

```text
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]
```

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

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

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

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

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

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

## Настройка в Cline

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

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

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

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

`cline_mcp_settings.json`

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

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

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

В [документации MCP](https://docs.cline.bot/mcp/mcp-overview) для Cline описаны удалённые серверы, таймауты и автоподтверждение.

## Проиндексируйте один репозиторий, который вы уже знаете.

Подключите Cline через MCP и задайте вопрос, который можно проверить.