Hopp til innhold

Cookbook

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

Velg riktig verktøy#

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 et hvilket som helst naturlig-språklig kodebasespørsmål; den går på tvers av semantisk, symbol-, struktur- og avhengighetssøk.
  • find_symbol — du kjenner allerede funksjonen, klassen eller variabelnavnet.
  • dependency_search — påvirkningsområde: kallende kode, avhengige eller påvirkning 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 — liste tilgjengelige depoter eller inspiser hvordan et depotnavn løser seg.
  • ask_maguyva med operation="guidance" — lokal hjelp om verktøyvalg og Maguyva-bruk (ingen endring av repoet).

Installer og verifiser en klient#

Få Maguyva inn i MCP-klienten din og bekreft tilkoblingen med en ekte depotliste.

  1. Opprett en API-nøkkel i app.maguyva.ai (nøkler starter med mgv_).
  2. Koble til og indekser minst ett GitHub-lager du allerede forstår.
  3. Koble klienten din ved å bruke Installasjonsveiledning (Claude Code-plugin, eller innebygd fjernkonfigurasjon For Cursor, VS Code, Windsurf, Zed og andre).
  4. Spør agenten din "Hvilke arkiver har jeg tilkoblet?" - som utøver autentisering og repository_context fra ende til annen.
  5. Still ett ekte spørsmål om den repoen hvis svar du kan sette karakter på. Du bør se filstier og linjenumre fra det indekserte treet.

Sitter du fast på nøkler, broer eller mangler repos? Troubleshooting.

Spør før du redigerer#

Kartlegg symboler og påvirkningsområde før du endrer delt kode. Maguyva-verktøy endrer ikke lagrene dine – de informerer om redigeringen som klienten din bruker 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 avhengigheter og påvirkning (eller pass endrede baner for PR-lignende påvirkning) slik at du ser påvirkningsområdet.
  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. Etter redigeringen, sjekk de samme symbolene på nytt med dependency_search (inkludert bekreftelse etter redigering når klienten din støtter bekreftelsesflaggene) slik at kallende kode fortsatt løser som forventet.

Fullstendige parametere: MCP API-referanse.

Søk og endre#

En standard agentløkke: utforske → fest symboler → rediger med bevis.

  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. Begrens med språk- eller banefiltre når det første vinduet er støyende.
  3. Fremme lovende treff til find_symbol eller dependency_search i stedet for å stille det samme vage spørsmålet på nytt.
  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 skriver.

Hvorfor denne sløyfen fungerer: Hvordan det fungerer.

Tomme eller ufullstendige resultater#

Når verktøy ikke returnerer noe nyttig, fiks oppløsning og indeksering før du omskriver søket for alltid.

  1. Bekreft at depotet er tilkoblet og fullført indekseringen i app.maguyva.ai.
  2. Sjekk depotstrengen: "owner/repo" bruker standardgrenen; "owner/repo:branch" fester en gren. Matching skiller ikke mellom store og små bokstaver, ikke uklar – skrivefeil korrigeres ikke automatisk.
  3. Ring repository_context med action="info" og inspiser oppløsningsmetadata (for eksempel metadata.resolution_reason).
  4. Utelat repository bare når MCP-klienten din leverer en standardforespørsel eller nøkkelen har tilgang til nøyaktig ett depot; ellers gi det 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 Troubleshooting.

Konfigurasjonsfeil: Troubleshooting.

Arbeid på tvers av flere depoter#

Målrett den riktige indekserte repoen når en nøkkel kan se mer enn én.

  1. Ring 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 en ikke-standard repo (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 samtaler.
  4. Bruk get_file når filen bor i en 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.

Ny på Maguyva? Gå først Quickstart, og kom så tilbake hit for videre arbeidsflyter.

Neste trinn#