# Maguyva

Lyhyet ohjeet yleisiin Maguyva MCP -työnkulkuihin: asiakasohjelman asennus, haku ennen muokkausta, tyhjät tulokset ja työskentely useassa repositoriossa.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/fi/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/fi/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/fi/changelog.json).

## Kieliominaisuudet

Alla ovat ominaisuuslukumäärät, jotka ohjaavat rakenteellista hakua, symbolihakua, graafia hyödyntävää analyysia ja perusindeksointia.

Nämä merkinnät osoittavat nykyisessä kielikonfiguraatiossa käyttöön otetut ominaisuudet, eivät koko käsittelyketjun laatupisteitä. Graafin saatavuus edellyttää, että jäsennin, symbolien poiminta ja graafin poiminta ovat käytössä. Tuetut suhdetyypit ja poiminnan syvyys vaihtelevat kielittäin.

- Indeksoitu kattavuus: **284**. Jokainen listattu kieli on indeksoitu tiedosto-, teksti- ja repositoriokontekstia varten.
- AST-rakenteellinen haku: **247**. Kielet, joilla on jäsentimen tukema rakenne AST- ja rakenteellisen haun työnkulkuja varten.
- Symbolien poiminta: **282**. Kielet, joilla on symbolien metatiedot määrittelyjä ja hakua varten.
- Graafisuhteet: **151**. Kielet, joissa on toimiva suhteiden poiminta graafia hyödyntävää hakua varten. Syvyys vaihtelee kielen ja suhdetyypin mukaan.

- `ast_structural=false`: Tekstiensisijainen indeksointi kevyemmällä rakenteellisella tietoisuudella.
- `symbol_extraction=false`: Symbolien poiminta on rajoitettua, joten navigointi nojaa enemmän tiedosto- ja rakennekontekstiin.
- `relationship_extraction=false`: Tämä kieli indeksoidaan hakua varten, mutta sitä ei tällä hetkellä tallenneta koodigraafiin.

[Etsi kielesi](/llms-full.txt)

## Cookbook

Käytännöllisiä ohjeita päivittäiseen Maguyva MCP -työhön. Jokainen ohje kertoo työkalut ja niiden käyttöjärjestyksen — ei kaikkia parametreja. Työkaluparametrit löydät täältä: [MCP API-viite](https://maguyva.ai/fi/docs/mcp-api). Ensimmäiseen asennukseen: [Pikaopas](https://maguyva.ai/fi/docs/quickstart).

### Valitse oikea työkalu

Useimmat kysymykset alkavat yhdellä työkalukutsulla. Eskaloi vain, kun ensimmäinen vastaus on liian yleinen tai liian niukka.

- `intelligent_search` — aloita tästä, kun esität koodikantaa koskevan kysymyksen luonnollisella kielellä. Oletusarvoinen auto/balanced ohjaa suurella varmuudella määritelmien hauiksi tunnistetut kyselyt rakenteelliseen hakuun, viittaus- tai vaikutuskyselyt graafihakuun ja tarkkaa osumaa hakevat kyselyt tekstihakuun. Muut kyselyt käyttävät semanttista merkitystä ja indeksoitua tekstiä. Pyydä kaikkia neljää hakumenetelmää valinnalla mode=hybrid tai auto ja quality=thorough. Erikseen valittu tila on ensisijainen quality-asetukseen nähden.
- `find_symbol` — tiedät jo funktion, luokan tai muuttujan nimen.
- `dependency_search` — vaikutusalue: kutsuva koodi, riippuvaiset komponentit tai vaikutus ennen muokkausta ja sen jälkeen.
- `get_task_context` — tuntematon alue; yksi rajattu nippu tiedostoja, symboleja ja riippuvuuksia tehtävän kuvaukselle.
- `repository_context` — luettele käytettävissä olevat repositoriot tai tarkista, miten repositorion tunniste tulkitaan.
- `ask_maguyva` ja `operation="guidance"` — paikallinen apu työkalujen valinnassa ja Maguyva-tuotteen käytössä (ei repositorion muokkaamista).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/fi/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/fi/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/fi/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/fi/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/fi/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/fi/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/fi/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/fi/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/fi/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/fi/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/fi/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## Seuraavat vaiheet

- [Pikaopas](https://maguyva.ai/fi/docs/quickstart)
- [Asennusopas](https://maguyva.ai/fi/docs/installation)
- [MCP API-viite](https://maguyva.ai/fi/docs/mcp-api)
- [Vianmääritys](https://maguyva.ai/fi/docs/troubleshooting)
- [Miten se toimii](https://maguyva.ai/fi/docs/how-it-works)
- [Yhteensopivuus ja tekniset tiedot](https://maguyva.ai/fi/docs/compatibility)

## Agent integrations

- [Maguyva Cursor-editorille: koodikannan konteksti MCP:n yli](https://maguyva.ai/fi/for-cursor): Cursor muokkaa avointa tiedostoa; Maguyva indeksoi koko monorepon ja tarjoaa sen takaisin MCP:n yli — semanttinen, AST-, graafi- ja tekstihaku tiedosto:rivi-tarkkuudella, joten agentti löytää tiedostot, joita et kiinnittänyt.
- [Maguyva Windsurf-editorille: koodikannan konteksti MCP:n yli](https://maguyva.ai/fi/for-windsurf): Windsurf ja Cascade muokkaavat avointa tiedostoa; Maguyva indeksoi koko monorepon ja tarjoaa sen MCP:n yli — semanttinen, AST-, graafi- ja tekstihaku tiedosto:rivi-tarkkuudella, joten Cascade löytää tiedostot, joita et maininnut.
- [Maguyva Antigravity-editorille: koodikannan konteksti MCP:n yli](https://maguyva.ai/fi/for-antigravity): Antigravity ajaa autonomisia agentteja editorin, terminaalin ja selaimen yli; Maguyva antaa niille kysyttävän kartan monorepostasi MCP:n yli — vaikutusalue etukäteen, ei sen jälkeen kun CI muuttuu punaiseksi.
- [Maguyva Codexille: koodikannan konteksti MCP:n yli](https://maguyva.ai/fi/for-codex): AGENTS.md on työsopimus. Maguyva on MCP-palvelin, joka antaa Codex CLI:lle kyseltävän kartan repositoriosta, jotta ensimmäinen muokkaus ei ole arvaus.
- [Maguyva mille tahansa MCP-asiakkaalle: koodikannan konteksti MCP:n yli](https://maguyva.ai/fi/for-anything): MCP on avoin protokolla. Maguyva on tavallinen MCP-palvelin, joten MCP-yhteensopivat asiakasohjelmat, kuten Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity, saavat saman todennetun koodikantakontekstin.
- [Maguyva Gemini CLI:lle: koodikannan konteksti MCP:n yli](https://maguyva.ai/fi/for-gemini): GEMINI.md asettaa työkontekstin; MCP on kanava. Maguyva on MCP-palvelin, joka antaa Gemini CLI:lle kysyttävän kartan repostasi — semanttinen, AST- ja graafihaku, jotta ensimmäinen muokkaus ei ole arvaus.
- [Maguyva Claude Code -työkalulle: koodikannan konteksti MCP:n yli](https://maguyva.ai/fi/for-claude-code): CLAUDE.md kertoo Claudelle, miten sen tulee toimia. Maguyva indeksoi repositorion ja tarjoaa sen MCP:n kautta, jotta Claude Code muokkaa kyseltävän kartan pohjalta.
- [Maguyva GitHub Copilot CLI:lle: koodikonteksti MCP:n kautta](https://maguyva.ai/fi/for-copilot): Mukautetut ohjeet kertovat Copilotille, miten sen tulee toimia. Maguyva indeksoi repositorion ja tarjoaa sen MCP:n kautta, jotta GitHub Copilot CLI muokkaa kartan pohjalta.

## Company

- [Maguyva-esittely: koodiäly MCP:n kautta](https://maguyva.ai/fi/about): Koodiäly koodausagenteille: semanttinen, AST-, graafi- ja kokotekstihaku, symbolihaku, riippuvuusanalyysi ja tehtäväkonteksti yhdellä kutsulla yli 284 kielellä.
- [Tapaa tiimi: 2 ihmistä + tekoälyagenttiparvi](https://maguyva.ai/fi/team)
- [Miten toimimme: Ei pääomasijoittajia, ei käyttäjäkohtaista hinnoittelua, ei ominaisuusportteja](https://maguyva.ai/fi/how): Ei ulkopuolista pääomaa. Ei käyttäjäkohtaista hinnoittelua. Datasi ei ole tuote. Miten Maguyva on rakennettu ja miksi se on hinnoiteltu näin.
- [Teknologiapino: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/fi/stack): Tekninen pino Maguyva-palvelun takana. PostgreSQL, Voyage AI -upotukset, kvantisoitu vektorihaku, tree-sitter AST ja MCP-protokolla.
- [Muutosloki](https://maguyva.ai/fi/changelog): Mitä Maguyva on julkaissut: tuotemuutokset, indeksin ja MCP-työkalujen päivitykset sekä muistiinpanot kehityksestä. Uusimmat ensin.
- [Live: Maguyva rakentaa itseään, reaaliajassa](https://maguyva.ai/fi/live): Ei nauhoitettua demoa. Tämä on aito lähetysloki — jokainen työkalukutsu, virhe ja commit tekoälyagenttitiimiltä, joka rakentaa Maguyva-palvelua, livenä.

## Guides

- [Ei täystekstihakua trenssitakissa. Viisi yhdistettyä hakutapaa.](https://maguyva.ai/fi/beyond-rag): Koodi tarvitsee enemmän kuin semanttisia palasia. Maguyva yhdistää viisi hakutapaa yhdeksi järjestetyksi vastaukseksi, ankkuroituna oikeaan repoon MCP:n yli 284 kielellä. Free-taso, ei luottokorttia.
- [Ohjetiedostot eivät ole kartta koodistasi. Maguyva on.](https://maguyva.ai/fi/beyond-rules-files): CLAUDE.md ja AGENTS.md kertovat agentille, miten käyttäytyä. Ne eivät kerro, mitä koodikannassa on. Maguyva on koodikannan kontekstikerros MCP:n yli 284 kielellä. Free-taso, ei luottokorttia.
- [Muokkaus on helppo. Sen tietäminen, mikä hajoaa, on vaikeaa. Maguyva kartoittaa sen.](https://maguyva.ai/fi/know-what-breaks): Ennen refaktorointia agenttisi pitäisi tietää jokainen kutsuva, tuova ja riippuvainen komponentti. Maguyva vastaa siihen oikeasta kutsugraafista MCP:n yli, ei grepistä. Free-taso, ei luottokorttia.
- [Aloita ilmaiseksi: koodikannan kontekstikerros tekoälykoodausagenteille](https://maguyva.ai/fi/map-then-change): Kartoita ensin. Muuta sitten. Maguyva antaa tekoälykoodausagentillesi kysyttävän kartan koodikannasta MCP:n yli, ennen ensimmäistä muokkausta. 11 työkalua 284 kielellä. Free-taso, ei luottokorttia.
- [Agenttisi aloittaa sokkona repossasi. Maguyva antaa sille kartan.](https://maguyva.ai/fi/stop-flying-blind): Koodausagentit skannaavat vääriä tiedostoja ja muokkaavat ennen kuin ymmärtävät koodin. Maguyva antaa agentillesi kysyttävän kartan koodikannasta MCP:n yli 284 kielellä. Free-taso, ei luottokorttia.