Перейти до вмісту

Для користувачів 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-ключем і збережіть файл. Поставте запитання, відповідь на яке вже знаєте, і відкрийте процитований файл.