# Claude Desktop nie widzi twojego repo. Pokaż mu je.

Canonical source: https://maguyva.ai/pl/for-claude-desktop

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

W Claude Desktop wiele osób pyta o kod, którego akurat nie edytuje: przy review, onboardingu, callach w sprawie incydentów. Maguyva indeksuje repo i udostępnia je przez MCP, więc odpowiedzi cytują pliki i linie zamiast pamięci.

> Checkout nie jest potrzebny. Zapytaj indeks.

## Co warto wiedzieć o Claude Desktop

Cztery fakty specyficzne dla Claude Desktop.

### claude_desktop_config.json

Otwiera go Settings → Developer → Edit Config. W macOS leży w `~/Library/Application Support/Claude/`, w Windows w `%APPDATA%\Claude\`.

### Lokalny most

Ten plik uruchamia lokalne procesy, więc przewodnik odpala `@maguyva/mcp` przez `npx`. Potrzebny jest zainstalowany Node.js.

### Wpis env

Most odczytuje `MAGUYVA_API_KEY` z bloku `env` serwera w tym samym pliku.

### Zamknij i otwórz ponownie

Claude Desktop czyta plik przy starcie. Po edycji zamknij aplikację całkowicie; serwer ruszy przy następnym uruchomieniu.

## Instrukcje projektu wyznaczają ramy. Korzystaj z nich.

Projects w Claude przechowują instrukcje i pliki, od których zaczyna się każdy czat w projekcie. To dobre miejsce na:

- To, dla kogo są odpowiedzi: recenzent, nowa osoba w zespole, inżynier na dyżurze.
- Firmowy styl wyjaśnień i podsumowań.
- Kilka dokumentów, które mają być cytowane, np. przegląd architektury.

Przesłane pliki to migawka. Dzień po przesłaniu repo jest już gdzie indziej.

## Gdzie wklejony kod przestaje wystarczać

Trzy sposoby, w jakie rozmowa o kodzie idzie źle bez samego kodu.

### // wklejone fragmenty się starzeją

Plik wklejony do czatu w zeszłym tygodniu opisuje kod z zeszłego tygodnia. Claude odpowiada pewnie na podstawie wersji, którą dostał.

### // fragment to nie system

Jeden plik rzadko odpowiada na “co się stanie, gdy to się wysypie?” Handler, ponowienie i alert zwykle siedzą w trzech różnych pakietach.

### // bez checkoutu nie ma grepa

Claude Desktop nie ma kopii roboczej twojego repo. Bez narzędzia każda odpowiedź o strukturze zależy od tego, co pamiętałeś wkleić.

## Maguyva jako serwer MCP w Claude Desktop

Jeden wpis w mcpServers daje Claude:

- **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ś mógł sprawdzić każde twierdzenie.
- **Wyniki uwzględniające gałąź**: dzięki czemu Claude odpowiada o gałęzi, którą wskażesz, a nie o pliku, który ktoś przesłał w zeszłym miesiącu.

> Instrukcje projektu mówią Claude, *jak odpowiadać*.
> Maguyva daje Claude *kod, na którym może się oprzeć*.

## Dwa przepływy pracy

Pytania, dla których inaczej otworzyłbyś IDE.

### 01. Wyjaśnij ścieżkę kodu podczas review

```text
claude> co się dzieje, gdy webhook płatności nie przejdzie weryfikacji podpisu?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude odpowiada, cytując obie linie.
[exit 0]
```

Każdy krok odpowiedzi wskazuje plik i linię, które możesz otworzyć.

### 02. Oszacuj zmianę, zanim ją zaplanujesz

```text
claude> ile miejsc czyta stare pole plan_code?

text_pattern_search("plan_code")
  14 trafień w 9 plikach
dependency_search("getPlanCode", dependents)
  6 wywołujących

→ Szacunek zaczyna się od liczby, nie od zgadywania.
[exit 0]
```

Przydatne na spotkaniu planistycznym, gdy nikt nie ma otwartego repo.

## Konfiguracja w Claude Desktop

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

`claude_desktop_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}
```

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

Zamień `mgv_xxxx` na swój klucz API, zamknij całkowicie Claude Desktop i otwórz go ponownie. Jeśli serwer się nie pojawi, przejrzyj `mcp-server-maguyva.log` w folderze logów Claude (`~/Library/Logs/Claude` w macOS).

[Przewodnik MCP po serwerach lokalnych](https://modelcontextprotocol.io/docs/develop/connect-local-servers) opisuje dokładniej plik konfiguracji i jego logi.

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

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