Dla użytkowników Claude Desktop

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

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.

Zacznij za darmo Przeczytaj konfigurację dla Claude Desktop

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

Checkout nie jest potrzebny. Zapytaj indeks.

Co warto wiedzieć o Claude Desktop

Cztery fakty specyficzne dla Claude Desktop.

// plik konfiguracji

claude_desktop_config.json

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

// transport

Lokalny most

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

// klucz

Wpis env

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

// restart

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.

// workflow 01

Wyjaśnij ścieżkę kodu podczas review

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

// workflow 02

Oszacuj zmianę, zanim ją zaplanujesz

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.

// step 01

Zaindeksuj repo na maguyva.ai

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

// step 02

Dodaj Maguyva do claude_desktop_config.json

claude_desktop_config.json

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

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