Přeskočit na obsah

Pro uživatele Cline

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

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ářů.

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

.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.

// konfigurační soubor

cline_mcp_settings.json

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

// transport

Vzdáleně, přes URL

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

// klíč

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.

// typ

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.

# .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.

// workflow 01

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

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í.

// workflow 02

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

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.

  1. // step 01

    Indexujte repozitář na maguyva.ai

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

  2. // step 02

    Přidejte Maguyva do nastavení MCP v 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

    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.