Claude Desktop -käyttäjille

Claude Desktop ei näe repoasi. Näytä sille sellainen.

Claude Desktop on paikka, jossa moni kysyy koodista, jota ei juuri nyt muokkaa: katselmoinnit, perehdytys, häiriöpuhelut. Maguyva indeksoi repon ja tarjoaa sen MCP:n yli, joten vastaukset viittaavat tiedostoihin ja riveihin eivätkä muistiin.

Aloita ilmaiseksi Lue Claude Desktop -asennus

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

Checkoutia ei tarvita. Kysy indeksiltä.

Mitä Claude Desktop -sovelluksesta pitää tietää

Neljä Claude Desktop -sovellukselle ominaista asiaa.

// asetustiedosto

claude_desktop_config.json

Settings → Developer → Edit Config avaa sen. macOS:ssä se on hakemistossa ~/Library/Application Support/Claude/, Windowsissa hakemistossa %APPDATA%\Claude\.

// siirto

Paikallinen silta

Tämä tiedosto käynnistää paikallisia prosesseja, joten ohje ajaa paketin @maguyva/mcp komennolla npx. Node.js:n on oltava asennettuna.

// avain

env-merkintä

Silta lukee muuttujan MAGUYVA_API_KEY saman tiedoston palvelinmerkinnän env-lohkosta.

// uudelleenkäynnistys

Sulje ja avaa uudelleen

Claude Desktop lukee tiedoston käynnistyessään. Sulje sovellus kokonaan muokkauksen jälkeen; palvelin käynnistyy seuraavalla kerralla.

Projektiohjeet asettavat raamit. Käytä niitä.

Clauden Projects sisältää ohjeet ja tiedostot, joista jokainen projektin keskustelu alkaa. Ne sopivat näihin:

Kenelle vastaukset on tarkoitettu: katselmoijalle, uudelle tulokkaalle, päivystävälle insinöörille.
Talon tyyli selityksille ja yhteenvedoille.
Muutama dokumentti, joihin haluat viitattavan, kuten arkkitehtuurin yleiskuva.

Ladatut tiedostot ovat tilannekuva. Repo on jo mennyt eteenpäin latausta seuraavana päivänä.

Missä liitetty koodi ei enää riitä

Kolme tapaa, joilla keskustelu koodista menee pieleen ilman koodia.

// liitetyt pätkät vanhenevat

Viime viikolla keskusteluun liitetty tiedosto kuvaa viime viikon koodia. Claude vastaa itsevarmasti saamansa version perusteella.

// pätkä ei ole järjestelmä

Yksi tiedosto vastaa harvoin kysymykseen “mitä tapahtuu, kun tämä epäonnistuu?” Käsittelijä, uudelleenyritys ja hälytys ovat yleensä kolmessa eri paketissa.

// ei checkoutia, ei grepiä

Claude Desktop -sovelluksella ei ole repostasi työkopiota. Ilman työkalua jokainen rakennetta koskeva vastaus riippuu siitä, mitä muistit liittää.

Maguyva MCP-palvelimena Claude Desktop -sovelluksessa

Yksi mcpServers-merkintä antaa Claudelle:

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 voit tarkistaa jokaisen väitteen.
Haaratietoiset tulokset joten Claude vastaa nimeämästäsi haarasta eikä tiedostosta, jonka joku latasi viime kuussa.

Projektiohjeet kertovat Claudelle, miten vastata.
Maguyva antaa Claudelle koodin, johon vastaus nojaa.

Kaksi työnkulkua

Kysymyksiä, joihin muuten avaisit IDE:n.

// workflow 01

Selitä koodipolku katselmoinnissa

claude> mitä tapahtuu, kun maksuwebhook ei läpäise allekirjoitustarkistusta?

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

→ Claude vastaa ja viittaa molempiin riveihin.
[exit 0]

Vastauksen jokainen vaihe osoittaa tiedostoon ja riviin, jotka voit avata.

// workflow 02

Arvioi muutoksen koko ennen suunnittelua

claude> monessako kohdassa luetaan vanhaa plan_code-kenttää?

text_pattern_search("plan_code")
  14 osumaa 9 tiedostossa
dependency_search("getPlanCode", dependents)
  6 kutsujaa

→ Arvio alkaa luvusta eikä arvauksesta.
[exit 0]

Hyödyllinen suunnittelupalaverissa, kun kenelläkään ei ole repoa auki.

Asennus Claude Desktop -sovelluksessa

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

// step 01

Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

// step 02

Lisää Maguyva tiedostoon claude_desktop_config.json

claude_desktop_config.json

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

// step 03

Korvaa paikkamerkki, käynnistä uudelleen ja kysy yksi kysymys

Korvaa mgv_xxxx omalla API-avaimellasi, sulje Claude Desktop kokonaan ja avaa se uudelleen. Jos palvelin ei näy, lue mcp-server-maguyva.log Clauden lokikansiosta (macOS:ssä ~/Library/Logs/Claude).