Hoppa till innehåll

Recept

Praktiska recept för vardags Maguyva MCP arbete. Varje recept namnger verktygen och sekvensen – inte en fullständig parameterreferens. För verktygsparametrar, använd MCP API-referens. För förstagångsinstallation, använd Quickstart.

Välj rätt verktyg#

De flesta frågor börjar med ett samtal. Eskalera endast när det första svaret är för brett eller för tunt.

  • intelligent_search — börja här för alla naturliga kodbasfrågor; den går över semantisk, symbol-, strukturell och beroendesökning.
  • find_symbol — du känner redan till funktionen, klassen eller variabelnamnet.
  • dependency_search — sprängradie: anropare, anhöriga eller påverkan före (och efter) en redigering.
  • get_task_context — okänt område; ett avgränsat paket med filer, symboler och beroenden för en uppgiftsbeskrivning.
  • repository_context — lista tillgängliga arkiv eller inspektera hur ett arkivnamn löser sig.
  • ask_maguyva med operation="guidance" — lokal hjälp om verktygsval och Maguyva-användning (ingen repo-mutation).

Installera och verifiera en klient#

Hämta Maguyva i din MCP-klient och bekräfta anslutningen med en riktig arkivlista.

  1. Skapa en API-nyckel i app.maguyva.ai (nycklar börjar med mgv_).
  2. Anslut och indexera minst ett GitHub-förråd som du redan förstår.
  3. Koppla din klient med Installationsguide (Claude Code-plugin, eller inbyggd fjärrkonfiguration för Cursor, VS Code, Windsurf, Zed och andra).
  4. Fråga din agent "Vilka förråd har jag anslutna?" — som utövar autentisering och repository_context från början.
  5. Ställ en riktig fråga om det repet vars svar du kan betygsätta. Du bör se filsökvägar och radnummer från det indexerade trädet.

Fastnat på nycklar, broar eller saknade repos? Troubleshooting.

Fråga innan du redigerar#

Kartsymboler och sprängradie innan delad kod ändras. Maguyva-verktyg ändrar inte dina arkiv – de informerar om redigeringen som din klient tillämpar lokalt.

  1. Om du känner till symbolnamnet, ring find_symbol för att få definitioner och användningsområden.
  2. Om du bara har en uppgiftsbeskrivning ("lägg till SSO", "fixa faktureringswebbhook"), börja med get_task_context eller intelligent_search.
  3. Innan du redigerar en delad symbol, ring dependency_search med beroende/påverkansanalys (eller skicka ändrade vägar för PR-liknande påverkan) så att du ser sprängradien.
  4. Öppna de citerade filerna (lokal läsning för filer på disk; get_file för fjärr-/kors-repo-sökvägar) och bekräfta planen mot riktig kod.
  5. Efter redigeringen, kontrollera samma symboler igen med dependency_search (inklusive verifiering efter redigering när din klient stöder verifieringsflaggor) så att uppringare fortfarande löser sig som förväntat.

Fullständiga parametrar: MCP API-referens.

Sök och ändra sedan#

En standardagentslinga: utforska → nålsymboler → redigera med bevis.

  1. Börja med intelligent_search och en fråga i vanligt språk ("hur fungerar sessionsförfallotid", "var är logik för försök igen").
  2. Begränsa med språk- eller sökvägsfilter när det första fönstret är bullrigt.
  3. Marknadsför lovande träffar till find_symbol eller dependency_search istället för att ställa samma vaga fråga igen.
  4. Använd get_file endast när du behöver en specifik indexerad sökväg som inte finns på disken.
  5. Redigera i dina vanliga klientverktyg. Maguyva är till för upptäckt och verifiering — inte skrivningar.

Varför denna loop fungerar: Hur det fungerar.

Tomma eller tunna resultat#

När verktyg inte returnerar något användbart, fixa upplösning och indexering innan du skriver om frågan för alltid.

  1. Bekräfta att förvaret är anslutet och avslutat indexeringen i app.maguyva.ai.
  2. Kontrollera förvarssträngen: "owner/repo" använder standardgrenen; "owner/repo:branch" fäster en gren. Matchningen är skiftlägesokänslig, inte luddig – stavfel korrigeras inte automatiskt.
  3. Ring repository_context med action="info" och inspektera upplösningsmetadata (till exempel metadata.resolution_reason).
  4. Uteslut repository endast när din MCP-klient tillhandahåller en standardbegäran eller nyckeln kan komma åt exakt ett arkiv; annars skicka det uttryckligen.
  5. Försök igen med en mer specifik fråga, ett känt symbolnamn via find_symbol eller ett språk/sökvägsfilter. Om själva anslutningen är bruten, använd Troubleshooting.

Installationsfel: Troubleshooting.

Arbeta över flera arkiv#

Inrikta dig på rätt indexerade repo när en nyckel kan se mer än en.

  1. Ring repository_context med action="list" en gång för att lära dig exakt vilka sniglar din nyckel kan söka efter.
  2. Skicka repository uttryckligen på sök- och symbolverktyg när du behöver en icke-standardrepo (till exempel "owner/other-repo" eller "owner/other-repo:develop").
  3. Behåll en fråga = ett förråd om du inte avsiktligt jämför mellan repor i separata anrop.
  4. Använd get_file när filen finns i en indexerad repo som inte är ditt nuvarande arbetsträd.
  5. Kom ihåg: verktyg skriver aldrig tillbaka till GitHub – multi-repo-sammanhang är endast för läsning och planering.

Information om förvarsformat: MCP API-referens.

Ny på Maguyva? Gå Quickstart först, kom sedan tillbaka hit för dag två loopar.

Nästa steg#