# Cline planuje, zanim zadziała. Daj planowi mapę.

Canonical source: https://maguyva.ai/pl/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 czyta pliki, uruchamia komendy i pyta, zanim cokolwiek zmieni. Maguyva indeksuje całe repo i zwraca je przez MCP, więc tryb Plan zaczyna od prawdziwych miejsc wywołań, a nie od listingu katalogów.

> .clinerules do tego, jak pracować. Maguyva do tego, co kod mówi teraz.

## Co warto wiedzieć o Cline

Cztery fakty specyficzne dla Cline.

### cline_mcp_settings.json

Otwórz go przez ikonę MCP Servers w panelu Cline: karta Configure, potem Configure MCP Servers. Serwery trafiają pod `mcpServers`.

### Zdalnie, przez URL

Cline łączy się z endpointem Maguyva przez Streamable HTTP. Bez lokalnego procesu, bez Node.js.

### Nagłówek wprost

Klucz trafia prosto do nagłówka `Authorization`, tak jak w przykładach samego Cline. Plik ustawień leży w pamięci użytkownika edytora, a nie w Twoim repo.

### streamableHttp, nie SSE

Zostaw we wpisie `"type": "streamableHttp"`: bez typu Cline zakłada stare SSE. Wpisz do `autoApprove` narzędzia, którym ufasz, żeby pomijać ich prośbę o zgodę.

## Reguły Cline to umowa robocza. Korzystaj z nich.

```text
# .clinerules/testing.md
- Uruchom zestaw testów, zanim oznaczysz zadanie jako ukończone.
- Zapytaj, zanim dodasz zależność.
```

Reguły workspace’u to pliki Markdown w `.clinerules/` lub `.cline/rules/`; Cline czyta też `AGENTS.md`, `.cursorrules` i `.windsurfrules`. Reguły to dobre miejsce na:

- Komendy, które Cline ma uruchamiać.
- Zabezpieczenia ograniczone do ścieżki globem we frontmatterze.
- Konwencje zespołu, których masz dość powtarzać.

Reguły mówią Cline, jak się zachowywać. Nie mówią mu, które serwisy czytają tabelę, którą właśnie ma migrować.

## Gdzie reguły i czytanie plików przestają wystarczać

Trzy luki, które Cline łata, czytając kolejne pliki, jedno żądanie na raz.

### // plan z listingu

Tryb Plan rozumuje na podstawie tego, co Cline do tej pory przeczytał. W dużym repo to drzewo katalogów i garść plików, a plan dziedziczy te luki.

### // każdy odczyt to podróż w obie strony

Każdy plik, który Cline otwiera, żeby się zorientować, kosztuje tokeny i jedno żądanie do modelu. Orientowanie się w nieznanym pakiecie potrafi zjeść sporą część okna kontekstu przed pierwszą edycją.

### // wyszukiwanie tekstowe znajduje ciągi, nie wywołujących

“Kto jeszcze to wywołuje?” to pytanie o graf. Wyszukiwanie tekstowe znajdzie ciąg znaków, ale nie odróżni prawdziwych wywołujących od komentarza, atrapy i metody o tej samej nazwie.

## Maguyva jako serwer MCP w Cline

Jeden wpis w mcpServers daje Cline:

- **11 narzędzi dla zaindeksowanego repo**: wyszukiwanie semantyczne, strukturalne (AST), grafowe i tekstowe, a do tego wyszukiwanie symboli, zależności i pobieranie plików.
- **Odpowiedzi ze ścieżkami plików i numerami linii**: w ponad 285 językach, żeby plan cytował prawdziwe pliki.
- **Narzędzia tylko do odczytu**: Narzędzia Maguyva odpytują indeks. Żadne z nich nie edytuje twoich plików.

> Reguły Cline mówią Cline, *jak pracować*.
> Maguyva daje Cline *mapę do planowania*.

## Dwa przepływy pracy

Planuj według mapy, potem działaj.

### 01. Zaplanuj zmianę na podstawie prawdziwych miejsc wywołań

```text
cline plan> przenieś odświeżanie sesji do pakietu auth

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

→ Plan wymienia trzy miejsca wywołań, zanim ruszy tryb Act.
[exit 0]
```

Plan wymienia każdy plik, którego dotknie, więc zatwierdzasz listę, a nie przeczucie.

### 02. Znajdź prawdziwą implementację, nie fixture testowy

```text
cline> jak liczymy rozliczenie proporcjonalne?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← implementacja
  test/billing/proration.spec.ts:7   ← fixture

→ Cline czyta jeden plik zamiast sześciu.
[exit 0]
```

Uszeregowane wyniki stawiają implementację wyżej niż fixture o tej samej nazwie.

## Konfiguracja w Cline

Trzy kroki. Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

### 01. Zaindeksuj repo na maguyva.ai

Wybierz takie, które już znasz, żeby móc ocenić odpowiedzi.

### 02. Dodaj Maguyva do ustawień MCP w Cline

`cline_mcp_settings.json`

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

### 03. Podmień placeholder i zadaj jedno pytanie

Zamień `mgv_xxxx` na swój klucz API i zapisz plik. Zadaj pytanie, na które znasz już odpowiedź, a potem otwórz cytowany plik.

[Dokumentacja MCP](https://docs.cline.bot/mcp/mcp-overview) dla Cline opisuje zdalne serwery, limity czasu i automatyczne zatwierdzanie.

## Zaindeksuj jedno repo, które już znasz.

Podłącz Cline przez MCP i zadaj pytanie, które możesz sprawdzić.