# Asennusopas

Canonical source: https://maguyva.ai/fi/docs/installation

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

Pääset käyntiin alle 5 minuutissa. Tämä opas sisältää asennuksen 23 MCP-asiakasohjelmalle, mukaan lukien Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, ja Warp, ja muita.

**Esivaatimukset**: Tarvitset API-avaimen osoitteesta [app.maguyva.ai](https://app.maguyva.ai) ja yhdistetyn GitHub-repositorion.

## Ympäristön asetukset

Aseta ensin API-avain ympäristömuuttujaan. Jätä `repository` pois, kun MCP-asiakas antaa pyyntökohtaisen oletuksen tai kun avaimella on pääsy täsmälleen yhteen repositoryyn; muussa tapauksessa anna se erikseen.

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Korvaa `mgv_xxxx` oikealla API-avaimellasi osoitteesta [app.maguyva.ai](https://app.maguyva.ai).

## Asiakasohjelman konfigurointi

Valitse MCP-asiakasohjelmasi alta saadaksesi tarkat asennusohjeet.

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Maguyva käyttää tavallista MCP:tä. Mikä tahansa protokollaa tukeva asiakasohjelma voi yhdistää — vaikka yllä ei olisi virallista opasta. 23 asiakasohjelmaa dokumentoitu, lisää lisätään säännöllisesti.

## Varmista asennuksesi

Yhdistämisen jälkeen kokeile esittää agentillesi muutama kysymys:

- "Mitkä repositoriot minulla on yhdistettynä?" — varmistaa, että yhteys toimii
- "Miten autentikointi hoidetaan tässä koodikannassa?" — testaa semanttista hakua
- "Etsi kaikki funktiot, jotka kutsuvat tietokantaa" — testaa riippuvuushakua
- "Mistä UserService-luokka on riippuvainen?" — testaa symbolihakua

Sinun pitäisi nähdä tuloksia tiedostopolkuineen ja rivinumeroineen yhdistetystä repositoriostasi. Jos et näe, tarkista alla oleva [troubleshooting](https://maguyva.ai/fi/docs/troubleshooting).

## Repositorion muoto

Repositorioita määrittäessäsi:

- Haaran kanssa: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Oletushaara: `"owner/repo"`

**Vinkki**: tarkista repositorion tunnistus komennolla `repository_context(action="info", repository="...")`. Oletusrepositorion ohitus koskee vain nykyistä kutsua.

## Vianmääritys

### API-avainongelmat

- Varmista, että avaimesi alkaa mgv_-etuliitteellä
- Tarkista, että avain on asetettu oikein ympäristössäsi
- Varmista, ettei avain ole vanhentunut

### Repositoriota ei löydy

- Varmista, että repositorio on yhdistetty osoitteessa app.maguyva.ai
- Tarkista, että owner/repo-muoto on oikein
- Varmista, että sinulla on pääsy repositorioon

### MCP-yhteysongelmat

- Jos asiakasohjelmasi käyttää siltaa @maguyva/mcp, varmista, että npx on käytettävissä PATH-polussa
- Tarkista, että API-tokenisi on voimassa eikä vanhentunut
- Testaa yhteyttä osoitteeseen https://maguyva.tools/mcp
- Tarkista asiakasohjelmasi MCP-konfiguraation syntaksi

## Seuraavat askeleet

- MCP API -viite: Täydellinen API-dokumentaatio
- Näin se toimii: Ymmärrä kontekstin optimointi
- Vianmääritys: Korjaa asennus- ja yhteysongelmat