# Cline suunnittelee ennen kuin toimii. Anna suunnitelmalle kartta.

Canonical source: https://maguyva.ai/fi/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 lukee tiedostoja, ajaa komentoja ja kysyy ennen kuin muuttaa mitään. Maguyva indeksoi koko repon ja tarjoaa sen takaisin MCP:n yli, joten Plan-tila lähtee todellisista kutsukohdista eikä hakemistolistauksesta.

> .clinerules kertoo, miten työskennellä. Maguyva kertoo, mitä koodi sanoo nyt.

## Mitä Cline-laajennuksesta pitää tietää

Neljä Cline-laajennukselle ominaista asiaa.

### cline_mcp_settings.json

Avaa se Cline-paneelin MCP Servers -kuvakkeesta: välilehti Configure, sitten Configure MCP Servers. Palvelimet määritetään kohtaan `mcpServers`.

### Etänä, URL-osoitteella

Cline yhdistää Maguyva-päätepisteeseen Streamable HTTP:llä. Ei paikallista prosessia, ei Node.js:ää.

### Otsake sellaisenaan

Avain menee suoraan `Authorization`-otsakkeeseen, kuten Cline-laajennuksen omissa esimerkeissä. Asetustiedosto on editorisi käyttäjätallennustilassa, ei repossasi.

### streamableHttp, ei SSE

Pidä merkinnässä `"type": "streamableHttp"`: ilman tyyppiä Cline olettaa vanhan SSE:n. Listaa luotetut työkalut kohtaan `autoApprove`, niin niiden hyväksyntäkysely ohitetaan.

## Cline-säännöt ovat työskentelysopimus. Käytä niitä.

```text
# .clinerules/testing.md
- Aja testit ennen kuin merkitset tehtävän valmiiksi.
- Kysy ennen kuin lisäät riippuvuuden.
```

Työtilan säännöt ovat Markdown-tiedostoja hakemistossa `.clinerules/` tai `.cline/rules/`; Cline lukee myös tiedostot `AGENTS.md`, `.cursorrules` ja `.windsurfrules`. Säännöt sopivat näihin:

- Komennot, jotka Clinen pitää ajaa.
- Suojakaiteet, jotka rajataan polkuun frontmatterin globilla.
- Tiimin käytännöt, joita olet kyllästynyt toistamaan.

Säännöt kertovat Cline-laajennukselle, miten toimia. Ne eivät kerro, mitkä palvelut lukevat taulua, jota se on siirtämässä.

## Missä säännöt ja tiedostojen lukeminen eivät enää riitä

Kolme aukkoa, jotka Cline paikkaa lukemalla lisää tiedostoja pyyntö kerrallaan.

### // listauksesta tehty suunnitelma

Plan-tila päättelee sen perusteella, mitä Cline on tähän mennessä lukenut. Suuressa repossa se on hakemistopuu ja kourallinen tiedostoja, ja suunnitelma perii aukot.

### // jokainen luku on edestakainen matka

Jokainen tiedosto, jonka Cline avaa suunnistaakseen, maksaa tokeneita ja yhden mallipyynnön. Tuntemattomaan pakettiin tutustuminen voi viedä suuren osan kontekstiikkunasta ennen ensimmäistä muokkausta.

### // tekstihaku löytää merkkijonoja, ei kutsujia

“Kuka muu kutsuu tätä?” on graafikysymys. Tekstihaku löytää merkkijonon, mutta ei erota todellisia kutsujia kommentista, mockista ja samannimisestä metodista.

## Maguyva MCP-palvelimena Cline-laajennuksessa

Yksi mcpServers-merkintä antaa Cline-laajennukselle:

- **11 työkalua indeksoituun repoosi**: semanttinen, rakenteellinen (AST-), graafi- ja tekstihaku sekä symbolihaku, riippuvaiset ja tiedostojen haku.
- **Vastaukset tiedostopoluilla ja rivinumeroilla**: yli 285 kielellä, joten suunnitelma viittaa todellisiin tiedostoihin.
- **Työkalut, jotka vain lukevat**: Maguyva-työkalut kyselevät indeksiä. Mikään niistä ei muokkaa tiedostojasi.

> Cline-säännöt kertovat Cline-laajennukselle, *miten työskennellä*.
> Maguyva antaa Cline-laajennukselle *kartan suunnittelun pohjaksi*.

## Kaksi työnkulkua

Suunnittele kartan mukaan, toimi sitten.

### 01. Suunnittele muutos todellisten kutsukohtien pohjalta

```text
cline plan> siirrä istunnon uusiminen auth-pakettiin

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

→ Suunnitelma listaa kolme kutsukohtaa ennen Act-tilaa.
[exit 0]
```

Suunnitelma nimeää jokaisen tiedoston, johon se koskee, joten hyväksyt listan etkä aavistusta.

### 02. Löydä todellinen toteutus, ei testifixturea

```text
cline> miten laskemme suhteutetun laskutuksen?

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

→ Cline lukee yhden tiedoston kuuden sijaan.
[exit 0]
```

Priorisoidut tulokset nostavat toteutuksen samannimisen fixturen yläpuolelle.

## Asennus Cline-laajennuksessa

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

### 01. Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

### 02. Lisää Maguyva Cline-laajennuksen MCP-asetuksiin

`cline_mcp_settings.json`

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

### 03. Korvaa paikkamerkki ja kysy yksi kysymys

Korvaa `mgv_xxxx` omalla API-avaimellasi ja tallenna tiedosto. Kysy yksi kysymys, jonka vastauksen jo tiedät, ja avaa sitten viitattu tiedosto.

Cline-laajennuksen [MCP-dokumentaatio](https://docs.cline.bot/mcp/mcp-overview) kattaa etäpalvelimet, aikakatkaisut ja automaattisen hyväksynnän.

## Indeksoi yksi repo, jonka jo tunnet.

Yhdistä Cline MCP:n yli ja kysy yksi kysymys, jonka voit tarkistaa.