Dla użytkowników Cline

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

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.

Zacznij za darmo Przeczytaj konfigurację dla Cline

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

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

Co warto wiedzieć o Cline

Cztery fakty specyficzne dla Cline.

// plik konfiguracji

cline_mcp_settings.json

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

// transport

Zdalnie, przez URL

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

// klucz

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.

// typ

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.

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

// workflow 01

Zaplanuj zmianę na podstawie prawdziwych miejsc wywołań

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.

// workflow 02

Znajdź prawdziwą implementację, nie fixture testowy

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.

// step 01

Zaindeksuj repo na maguyva.ai

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

// step 02

Dodaj Maguyva do ustawień MCP w Cline

cline_mcp_settings.json

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

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