# Pikaopas

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

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

Nopein reitti nollasta varmistettuun vastaukseen: hanki avain, indeksoi yksi repositorio jonka jo tunnet, yhdistä asiakasohjelmasi ja kysy yksi kysymys, jonka osaat jo arvioida.

## 1. Hanki API-avain

[Aloita ilmaiseksi](https://app.maguyva.ai) — ei vaadi luottokorttia. API-avaimesi (se alkaa merkeillä `mgv_`) löytyy täältä: [app.maguyva.ai](https://app.maguyva.ai).

## 2. Indeksoi repositorio, jonka jo tunnet

Yhdistä GitHub-repositorio portaalista ja anna sen indeksoitua. Valitse pieni repo, jonka voit tarkistaa nopeasti — näin näet heti, ankkuroiko Maguyva mallia oikeasti, sen sijaan että yrittäisit indeksoida koko yrityksesi heti ensimmäisenä päivänä.

## 3. Yhdistä asiakasohjelmasi

Jos käytät Claude Code -sovellusta, asenna Maguyva-liitännäinen markkinapaikalta — aja jokainen komento Claude Code -sovelluksen sisällä:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

Liitännäinen tunnistautuu avaimellasi `MAGUYVA_API_KEY`-ympäristömuuttujasta. Aseta se komentotulkissasi (projektikohtainen `direnv` on suositeltava, koska avaimet ovat repositoriokohtaisia):

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

Työskenteletkö tiimissä? Valitse laajuus project paneelissa, jonka `/plugin install maguyva@maguyva` avaa. Laajennus tallentuu silloin repositorion tiedostoon `.claude/settings.json`, jonka committaat; jokainen tiimikaveri ajaa silti asennuksen kerran. Istunnon sisäisillä `/plugin`-komennoilla ei ole `--scope`-lippua, joten jos haluat skriptata sen, aja shell-muoto repositorion juuresta:

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

Useimmat muut asiakasohjelmat (Cursor, VS Code, Devin Desktop, Zed ja muut) yhdistyvät etäpalvelimeen suoraan — osoita ne päätepisteeseen `Bearer`-headerilla, siltaa ei tarvita. Esimerkiksi Cursorin `.cursor/mcp.json`:

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

Muoto vaihtelee hieman asiakasohjelmittain (VS Code sijoittaa sen avaimen `servers` alle `type: "http"`-tyypillä, Antigravity käyttää `serverUrl`, Zed käyttää `context_servers`). Tämä Cursor-esimerkki lukee avaimesi yllä näytetystä `MAGUYVA_API_KEY`-ympäristömuuttujasta; jos asiakasohjelman konfiguraatiossa näkyy sen sijaan paikkamerkki `mgv_xxxx`, korvaa se API-avaimellasi. Käynnistä sitten asiakasohjelmasi uudelleen. Tarkka konfiguraatio kaikille 23 dokumentoidulle asiakasohjelmalle löytyy täältä: [Asennusopas](https://maguyva.ai/fi/docs/installation).

## 4. Kysy yksi kysymys, jonka osaat jo arvioida

Aloita kysymyksellä **"Mitkä repositoriot minulla on yhdistettynä?"** varmistaaksesi yhteyden, ja kysy sitten yksi oikea kysymys repostasi, jonka vastauksen jo tiedät — esimerkiksi **"Miten autentikointi hoidetaan tässä koodikannassa?"**

Vastauksena pitäisi tulla tiedostopolkuja ja rivinumeroita. Avaa viitatut tiedostot ja tarkista, että vastaus kestää kosketuksen todelliseen repoon. Tuo yksi arvioitu vastaus kertoo enemmän kuin mikään ominaisuuslista — anna työkalun ansaita luottamuksesi ennen kuin se liittyy vakiotyönkulkuusi.

Ei tuloksia tai yhteysvirheitä? Tarkista API-avain, asiakasohjelman asetukset ja repositorion indeksoinnin tila kohdasta [Vianmääritys](https://maguyva.ai/fi/docs/troubleshooting). Jos asetuksesi käyttävät siltaa, varmista myös, että `npx` on käytettävissä.

## Seuraavaksi

- Asennusopas: asiakaskohtainen konfiguraatio kaikille 23 dokumentoidulle asiakasohjelmalle
- Miten se toimii: mitä tapahtuu kysymyksesi ja vastauksen välillä
- MCP API -viite: jokainen työkalu, parametri parametrilta