# Cline планує, перш ніж діяти. Дайте планові карту.

Canonical source: https://maguyva.ai/uk/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 і поставте запитання, яке можна перевірити.