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

Canonical source: https://maguyva.ai/fi/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).

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.

> Checkoutia ei tarvita. Kysy indeksiltä.

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

Neljä Claude Desktop -sovellukselle ominaista asiaa.

### claude_desktop_config.json

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

### Paikallinen silta

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

### env-merkintä

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

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

### 01. Selitä koodipolku katselmoinnissa

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

### 02. Arvioi muutoksen koko ennen suunnittelua

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

### 01. Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

### 02. Lisää Maguyva tiedostoon claude_desktop_config.json

`claude_desktop_config.json`

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

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

[MCP:n opas paikallisiin palvelimiin](https://modelcontextprotocol.io/docs/develop/connect-local-servers) käsittelee asetustiedoston ja sen lokit tarkemmin.

## Indeksoi yksi repo, jonka jo tunnet.

Yhdistä Claude Desktop MCP:n yli ja kysy yksi kysymys, jonka voit tarkistaa.