Pikaopas

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 — ei vaadi luottokorttia. API-avaimesi (se alkaa merkeillä mgv_) löytyy täältä: 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ä:

/plugin marketplace add maguyva/claude-code-plugin
/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):

export MAGUYVA_API_KEY=mgv_xxxx

Työskenteletkö tiimissä? Lisää --scope project molempiin /plugin-komentoihin, jolloin liitännäinen commitoituu repositorion tiedostoon .claude/settings.json ja tiimikaverit saavat sen automaattisesti.

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

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Muoto vaihtelee hieman asiakasohjelmittain (VS Code sijoittaa sen avaimen servers alle type: "http"-tyypillä, Windsurf käyttää serverUrl, Zed käyttää context_servers). Korvaa mgv_xxxx API-avaimellasi ja käynnistä asiakasohjelmasi uudelleen. Tarkka konfiguraatio kaikille 24 dokumentoidulle asiakasohjelmalle löytyy täältä: Asennusopas.

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

Seuraavaksi#

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