Pikaopas

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

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

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

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/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):

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:

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:

{
  "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.

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.

• 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