Oppskrifter

Praktiske oppskrifter for hverdagslig Maguyva MCP-arbeid. Hver oppskrift navngir verktøyene og sekvensen – ikke en fullstendig parameterreferanse. For verktøyparametere, bruk MCP API-referanse. For førstegangsoppsett, bruk Hurtigstart.

JSON-blokkene er inndata til MCP tools/call. Erstatt owner/repo, gren og symbolnavn med verdier fra repositoriet ditt.

De fleste spørsmål starter med ett verktøykall. Eskaler bare når det første svaret er for bredt eller for lite konkret.

• intelligent_search — start her for spørsmål om kodebasen på naturlig språk. Standardvalget auto/balanced sender spørsmål som sikkert identifiseres som definisjonssøk, til struktursøk, spørsmål om referanser eller påvirkning til grafen og spørsmål om eksakte treff til tekstsøk. Andre spørsmål bruker semantisk mening og indeksert tekst. Bruk mode=hybrid eller auto med quality=thorough for å be om alle fire søkemodaliteter; en eksplisitt angitt modus har forrang over quality.
• find_symbol — du kjenner allerede funksjonen, klassen eller variabelnavnet.
• dependency_search — påvirkningsradius: kallende kode, kode som er avhengig av den, eller konsekvenser før (og etter) en redigering.
• get_task_context — ukjent område; én avgrenset pakke med filer, symboler og avhengigheter for en oppgavebeskrivelse.
• repository_context — list tilgjengelige repoer eller undersøk hvordan et reponavn identifiseres.
• ask_maguyva med operation="guidance" — lokal hjelp om verktøyvalg og Maguyva-bruk (ingen endring av repoet).

Koble Maguyva til MCP-klienten din og bekreft tilkoblingen med en liste over faktiske repoer.

1. Opprett en API-nøkkel i app.maguyva.ai (nøkler starter med mgv_).
2. Koble til og indekser minst ett GitHub-repo du allerede kjenner.
3. Koble klienten din ved å bruke Installasjonsveiledning (Claude Code-plugin, eller innebygd fjernkonfigurasjon for Cursor, VS Code, Devin Desktop, Zed og andre).
4. Spør agenten din "Hvilke repoer har jeg koblet til?" — det tester autentisering og repository_context fra ende til ende.
5. Still ett ekte spørsmål om repoet der du kan vurdere svaret. Du bør få filstier og linjenumre fra det indekserte treet.

{
  "name": "repository_context",
  "arguments": {
    "action": "list"
  }
}

Problemer med nøkler, broer eller repoer som mangler? Se Feilsøking.

Kartlegg symboler og påvirkningsradius før du endrer delt kode. Maguyva-verktøy endrer ikke repoene dine — de gir grunnlaget for endringene klienten utfører lokalt.

1. Hvis du kjenner symbolnavnet, kall find_symbol for å finne definisjoner og bruksområder.
2. Hvis du bare har en oppgavebeskrivelse ("legg til SSO", "fiks faktureringswebkroken"), start med get_task_context eller intelligent_search.
3. Før du redigerer et delt symbol, kall dependency_search med analyse av dependents eller impact (eller send changed_paths for PR-lignende påvirkning), slik at du ser påvirkningsradiusen.
4. Åpne de siterte filene (lokal lesing for filer på disk; get_file for eksterne/kryss-repo-baner) og bekreft planen mot ekte kode.
5. Kontroller de samme symbolene på nytt etter endringen med dependency_search, verify_after_edit=true og targets eller changed_paths. Dette leser den indekserte grafen, ikke lokale endringer uten commit: kontroller indexed_commit_sha og hvor oppdatert indeksen er før du bruker dette som underlag for den nye revisjonen, og kjør lokale tester.

{
  "name": "dependency_search",
  "arguments": {
    "repository": "owner/repo",
    "target": "getCurrentUser",
    "exact_match": true,
    "analysis_type": "impact",
    "depth": "shallow",
    "include_metrics": true,
    "limit": 10
  }
}

Fullstendige parametere: MCP API-referanse.

En standard agentsløyfe: utforsk → identifiser symboler → rediger med grunnlag i kode.

1. Start med intelligent_search og en vanlig spørring ("hvordan fungerer utløp av økten", "hvor er logikk for forsøk på nytt").
2. Avgrens med språk- eller stifiltre hvis det første resultatvinduet inneholder mye støy. Med language_filter utelates graf fra auto/hybrid; en auto-spørring som bare ble rutet til graf, faller tilbake til semantisk søk og tekstsøk. Eksplisitt grafmodus med language_filter avvises. Se routing_decision.modalities_used for å finne den valgte søkeplanen; warnings finnes bare når serveren har gitt en advarsel.
3. Undersøk lovende treff videre med find_symbol eller dependency_search i stedet for å stille det samme vage spørsmålet igjen.
4. Bruk get_file bare når du trenger en spesifikk indeksert bane som ikke er på disken.
5. Rediger i dine vanlige klientverktøy. Maguyva er for oppdagelse og verifisering, ikke for å skrive eller endre kode.

{
  "name": "intelligent_search",
  "arguments": {
    "repository": "owner/repo",
    "query": "How does session expiry work?",
    "limit": 5
  }
}

Hvorfor denne sløyfen fungerer: Hvordan det fungerer.

Når verktøyene ikke returnerer noe nyttig, kontroller repoidentifisering og indeksering før du skriver om søket om og om igjen.

1. Bekreft at repoet er tilkoblet og ferdig indeksert i app.maguyva.ai.
2. Sjekk repostrengen: "owner/repo" bruker standardgrenen; "owner/repo:branch" velger en bestemt gren. Oppslaget skiller ikke mellom store og små bokstaver, men støtter ikke tilnærmede treff — skrivefeil korrigeres ikke automatisk.
3. Kall repository_context med action="info" og undersøk metadataene for repoidentifisering (for eksempel metadata.resolution_reason).
4. Utelat repository bare når MCP-klienten oppgir en standard for den aktuelle forespørselen, eller når nøkkelen har tilgang til nøyaktig ett repo; ellers oppgir du parameteren eksplisitt.
5. Prøv på nytt med en mer spesifikk spørring, et kjent symbolnavn via find_symbol, eller et språk/banefilter. Hvis selve forbindelsen er brutt, bruk Feilsøking.

{
  "name": "repository_context",
  "arguments": {
    "action": "info",
    "repository": "owner/repo:main"
  }
}

Konfigurasjonsfeil: Feilsøking.

Velg riktig indeksert repo når en nøkkel har tilgang til flere.

1. Kall repository_context med action="list" én gang for å lære de nøyaktige repoidentifikatorene nøkkelen din kan søke etter.
2. Send repository eksplisitt på søke- og symbolverktøy når du trenger et annet repo enn standardrepoet (for eksempel "owner/other-repo" eller "owner/other-repo:develop").
3. Behold ett spørsmål = ett depot med mindre du med vilje sammenligner på tvers av repoer i separate kall.
4. Bruk get_file når filen bor i et indeksert repo som ikke er ditt nåværende arbeidstre.
5. Husk: verktøy skriver aldri tilbake til GitHub – multi-repo-kontekst er kun for lesing og planlegging.

Depotformatdetaljer: MCP API-referanse.

• Hurtigstart — nøkkel, indeksering, tilkobling, første vurderte svar
• Installasjonsveiledning — MCP-konfigurasjon per klient
• MCP API-referanse — hvert verktøy, parameter for parameter
• Feilsøking — API-nøkkel-, bro- og depotfeil