Spring til indhold

Opskriftsbog

Praktiske opskrifter til hverdagens Maguyva MCP arbejde. Hver opskrift navngiver værktøjerne og sekvensen - ikke en fuldstændig parameterreference. Brug MCP API-reference til værktøjsparametre. For førstegangsopsætning skal du bruge Quickstart.

Vælg det rigtige værktøj#

De fleste spørgsmål starter med ét værktøjskald. Eskaler kun, når det første svar er for bredt eller for lidt konkret.

  • intelligent_search — start her for ethvert kodebasespørgsmål på naturligt sprog; det ruter på tværs af semantisk, symbol-, struktur- og afhængighedssøgning.
  • find_symbol — du kender allerede funktionen, klassen eller variabelnavnet.
  • dependency_search — påvirkningsområde: kaldende kode, afhængige eller påvirkning før (og efter) en redigering.
  • get_task_context — ukendt område; ét afgrænset bundt af filer, symboler og afhængigheder til en opgavebeskrivelse.
  • repository_context — liste tilgængelige depoter eller inspicer, hvordan et lagernavn løser sig.
  • ask_maguyva med operation="guidance" — lokal hjælp til valg af værktøj og brug af Maguyva (ingen ændring af repoet).

Installer og bekræft en klient#

Få Maguyva ind i din MCP-klient og bekræft forbindelsen med en reel lagerliste.

  1. Opret en API-nøgle i app.maguyva.ai (nøgler starter med mgv_).
  2. Tilslut og indekser mindst ét ​​GitHub-lager, du allerede forstår.
  3. Tilslut din klient ved hjælp af Installationsvejledning (Claude Code plugin eller native remote config for Cursor, VS Code, Windsurf, Zed og andre).
  4. Spørg din agent "Hvilke arkiver har jeg tilsluttet?" — der udøver godkendelse og repository_context fra ende til anden.
  5. Stil et rigtigt spørgsmål om den repo, hvis svar du kan bedømme. Du bør se filstier og linjenumre fra det indekserede træ.

Sidder du fast på nøgler, broer eller mangler repos? Troubleshooting.

Spørg før du redigerer#

Kortlæg symboler og påvirkningsområde før ændring af delt kode. Maguyva-værktøjer ændrer ikke dine arkiver - de informerer om den redigering, din klient anvender lokalt.

  1. Hvis du kender symbolnavnet, så kald find_symbol for at lande på definitioner og anvendelser.
  2. Hvis du kun har en opgavebeskrivelse ("tilføj SSO", "fix faktureringswebhook"), start med get_task_context eller intelligent_search.
  3. Inden du redigerer et delt symbol, skal du kalde dependency_search med afhængige/påvirkningsanalyse (eller videregive ændrede stier for PR-lignende påvirkning), så du kan se påvirkningsområdet.
  4. Åbn de citerede filer (lokal læsning for filer på disk; get_file for fjern-/kryds-repo-stier) og bekræft planen mod ægte kode.
  5. Efter redigeringen skal du kontrollere de samme symboler igen med dependency_search (inklusive post-edit-bekræftelse, når din klient understøtter bekræftelsesflag), så kaldende kode stadig løser som forventet.

Fuld parametre: MCP API-reference.

Søg, og skift derefter#

En standard agentløkke: udforsk → fastlæg symboler → rediger med beviser.

  1. Start med intelligent_search og en forespørgsel i almindeligt sprog ("hvordan fungerer sessionsudløb", "hvor er genforsøgslogik").
  2. Indsnævre med sprog- eller stifiltre, når det første vindue er støjende.
  3. Fremme lovende hits til find_symbol eller dependency_search i stedet for at stille det samme vage spørgsmål igen.
  4. Brug kun get_file, når du har brug for en specifik indekseret sti, der ikke er på disken.
  5. Rediger i dine normale klientværktøjer. Maguyva er til opdagelse og verifikation - ikke skriver.

Hvorfor denne løkke virker: Hvordan det virker.

Tomme eller ufuldstændige resultater#

Når værktøjer ikke returnerer noget nyttigt, skal du rette opløsning og indeksering, før du omskriver forespørgslen for altid.

  1. Bekræft, at lageret er tilsluttet og afsluttet indekseringen i app.maguyva.ai.
  2. Tjek lagerstrengen: "owner/repo" bruger standardgrenen; "owner/repo:branch" stifter en gren. Matching skelner ikke mellem store og små bogstaver og er ikke uklar - stavefejl korrigeres ikke automatisk.
  3. Ring til repository_context med action="info" og inspicer opløsningsmetadata (for eksempel metadata.resolution_reason).
  4. Udelad kun repository, når din MCP-klient leverer en anmodningsstandard, eller nøglen kan få adgang til præcis ét lager; ellers videregive det eksplicit.
  5. Prøv igen med en mere specifik forespørgsel, et kendt symbolnavn via find_symbol eller et sprog/sti-filter. Hvis selve forbindelsen er afbrudt, skal du bruge Troubleshooting.

Opsætningsfejl: Troubleshooting.

Arbejd på tværs af flere depoter#

Målret mod den rigtige indekserede repo, når en nøgle kan se mere end én.

  1. Ring til repository_context med action="list" én gang for at lære de nøjagtige repo-identifikatorer, din nøgle kan søge efter.
  2. Giv repository eksplicit på søge- og symbolværktøjer, når du har brug for en ikke-standard repo (for eksempel "owner/other-repo" eller "owner/other-repo:develop").
  3. Behold ét spørgsmål = ét lager, medmindre du med vilje sammenligner på tværs af repoer i separate opkald.
  4. Brug get_file, når filen lever i en indekseret repo, der ikke er dit nuværende arbejdstræ.
  5. Husk: værktøjer skriver aldrig tilbage til GitHub - multi-repo kontekst er kun til læsning og planlægning.

Oplysninger om lagerformat: MCP API-reference.

Ny på Maguyva? Gå først Quickstart, og kom derefter tilbage hertil for videre arbejdsgange.

Næste trin#