# Cline plánuje, než jedná. Dejte plánu mapu.

Canonical source: https://maguyva.ai/cs/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 čte soubory, spouští příkazy a ptá se, než cokoli změní. Maguyva indexuje celý repozitář a vrací ho přes MCP, takže režim Plan začíná u skutečných míst volání, a ne u výpisu adresářů.

> .clinerules na to, jak pracovat. Maguyva na to, co kód říká teď.

## Co potřebujete vědět o Cline

Čtyři fakta specifická pro Cline.

### cline_mcp_settings.json

Otevřete ho ikonou MCP Servers v panelu Cline: karta Configure, pak Configure MCP Servers. Servery patří pod `mcpServers`.

### Vzdáleně, přes URL

Cline se k endpointu Maguyva připojuje přes Streamable HTTP. Žádný lokální proces, žádný Node.js.

### Hlavička natvrdo

Klíč jde rovnou do hlavičky `Authorization`, stejně jako v příkladech samotného Cline. Soubor nastavení leží v uživatelském úložišti editoru, ne ve vašem repu.

### streamableHttp, ne SSE

Nechte v položce `"type": "streamableHttp"`: bez typu Cline předpokládá staré SSE. Nástroje, kterým věříte, zapište do `autoApprove` a jejich žádost o schválení se přeskočí.

## Pravidla Cline jsou dohoda o spolupráci. Používejte je.

```text
# .clinerules/testing.md
- Než označíš úkol jako hotový, spusť testy.
- Než přidáš závislost, zeptej se.
```

Pravidla workspace jsou soubory Markdown v `.clinerules/` nebo `.cline/rules/`; Cline čte i `AGENTS.md`, `.cursorrules` a `.windsurfrules`. Pravidla jsou to správné místo pro:

- Příkazy, které má Cline spouštět.
- Mantinely omezené na cestu pomocí globu ve frontmatteru.
- Týmové konvence, které už vás nebaví opakovat.

Pravidla říkají Cline, jak se chovat. Neřeknou mu, které služby čtou tabulku, kterou se chystá migrovat.

## Kde pravidla a čtení souborů přestávají stačit

Tři mezery, které Cline zaplňuje čtením dalších souborů, jeden požadavek po druhém.

### // plán postavený na výpisu

Režim Plan uvažuje z toho, co Cline zatím přečetl. Ve velkém repozitáři je to strom adresářů a hrstka souborů a plán ty mezery zdědí.

### // každé čtení je cesta tam a zpět

Každý soubor, který Cline otevře, aby se zorientoval, stojí tokeny a jeden požadavek na model. Orientace v neznámém balíčku může spotřebovat velkou část kontextového okna ještě před první úpravou.

### // textové hledání najde řetězce, ne volající

“Kdo další tohle volá?” je otázka pro graf. Textové hledání najde řetězec, ale neoddělí skutečné volající od komentáře, mocku a metody se stejným jménem.

## Maguyva jako MCP server v Cline

Jeden záznam v mcpServers dá Cline:

- **11 nástrojů nad vaším indexovaným repozitářem**: sémantické, strukturální (AST), grafové a textové vyhledávání, plus vyhledávání symbolů, závislé a načítání souborů.
- **Odpovědi s cestami k souborům a čísly řádků**: napříč 285+ jazyky, aby plán citoval skutečné soubory.
- **Nástroje, které jen čtou**: Nástroje Maguyva se dotazují indexu. Žádný z nich neupravuje vaše soubory.

> Pravidla Cline říkají Cline, *jak pracovat*.
> Maguyva dává Cline *mapu k plánování*.

## Dva pracovní postupy

Plánujte podle mapy, pak jednejte.

### 01. Naplánujte změnu podle skutečných míst volání

```text
cline plan> přesuň obnovu session do balíčku auth

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

→ Plán vyjmenuje tři místa volání ještě před spuštěním režimu Act.
[exit 0]
```

Plán jmenuje každý soubor, na který sáhne, takže schvalujete seznam, ne tušení.

### 02. Najděte skutečnou implementaci, ne testovací fixture

```text
cline> jak počítáme poměrné vyúčtování?

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

→ Cline přečte jeden soubor místo šesti.
[exit 0]
```

Seřazené výsledky dávají implementaci před fixture se stejným jménem.

## Nastavení v Cline

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

### 01. Indexujte repozitář na maguyva.ai

Vyberte si takový, který už znáte, abyste mohli posoudit odpovědi.

### 02. Přidejte Maguyva do nastavení MCP v Cline

`cline_mcp_settings.json`

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

### 03. Nahraďte zástupný text a položte jednu otázku

Nahraďte `mgv_xxxx` svým API klíčem a uložte soubor. Položte otázku, na kterou už znáte odpověď, a pak otevřete citovaný soubor.

[Dokumentace MCP](https://docs.cline.bot/mcp/mcp-overview) pro Cline popisuje vzdálené servery, časové limity a automatické schvalování.

## Indexujte jeden repozitář, který už znáte.

Připojte Cline přes MCP a položte otázku, kterou si můžete ověřit.