Recept

Praktiska recept för det dagliga MCP-arbetet med Maguyva. Varje recept anger verktygen och ordningsföljden, men är ingen fullständig parameterreferens. Verktygsparametrarna finns i MCP API-referens. Börja med Snabbstart vid första installationen.

JSON-blocken är indata till MCP tools/call. Ersätt owner/repo, gren och symbolnamn med värden från ditt repository.

De flesta frågor börjar med ett anrop. Gå vidare först om svaret är för brett eller för knapphändigt.

• intelligent_search — börja här för en fråga om kodbasen på naturligt språk. Standardläget auto/balanced skickar frågor som med hög säkerhet identifieras som definitionsfrågor till struktursökning, frågor om referenser eller påverkan till grafen och frågor om exakta träffar till textsökning. Övriga frågor använder semantisk betydelse och indexerad text. Använd mode=hybrid eller auto med quality=thorough för att begära alla fyra sökmodaliteter; ett uttryckligen valt läge har företräde framför quality.
• find_symbol — du känner redan till funktionen, klassen eller variabelnamnet.
• dependency_search — påverkansradie: anropande kod, beroende komponenter eller påverkan före (och efter) en ändring.
• 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 repor eller kontrollera vilket repo ett namn identifierar.
• ask_maguyva med operation="guidance" — lokal hjälp med verktygsval och användning av Maguyva (utan att ändra kodarkivet).

Anslut Maguyva till din MCP-klient och bekräfta anslutningen genom att hämta en riktig lista över repor.

1. Skapa en API-nyckel i app.maguyva.ai (nycklar börjar med mgv_).
2. Anslut och indexera minst ett GitHub-repo du redan känner till.
3. Koppla din klient med Installationsguide (Claude Code-plugin, eller inbyggd fjärrkonfiguration för Cursor, VS Code, Devin Desktop, Zed och andra).
4. Fråga din agent "Vilka repor har jag anslutna?" — det testar autentiseringen och repository_context hela vägen.
5. Ställ en riktig fråga om repot vars svar du kan bedöma. Du bör få filsökvägar och radnummer från det indexerade trädet.

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

Problem med API-nycklar, bryggor eller saknade repor? Felsökning.

Kartlägg symboler och påverkansradie innan du ändrar delad kod. Maguyvas verktyg ändrar inte dina repor — de ger underlag för ändringen som klienten gör lokalt.

1. Om du känner till symbolnamnet, anropa find_symbol för att hitta definitioner och användningsställen.
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 ändrar en delad symbol, anropa dependency_search med analys av beroende komponenter eller påverkan (eller skicka ändrade sökvägar för PR-liknande påverkansanalys) så att du ser påverkansradien.
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. Kontrollera samma symboler igen efter ändringen med dependency_search, verify_after_edit=true och targets eller changed_paths. Detta läser den indexerade grafen, inte lokala ändringar utan commit: kontrollera indexed_commit_sha och indexets aktualitet innan du använder det som underlag för den nya revisionen, och kör lokala tester.

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

Fullständiga parametrar: MCP API-referens.

En standardloop för agenten: utforska → identifiera symboler → ändra med underlag.

1. Börja med intelligent_search och en fråga på vanligt språk ('hur hanteras utgångna sessioner', 'var finns logiken för återförsök').
2. Avgränsa med språk- eller sökvägsfilter om det första resultatfönstret innehåller mycket brus. Ett language_filter utesluter graf från auto/hybrid; en auto-fråga som enbart dirigerats till graf faller tillbaka på semantisk sökning och textsökning. Ett uttryckligt grafläge med language_filter avvisas. Kontrollera routing_decision.modalities_used för att se den valda sökplanen; warnings finns bara med när servern har gett en varning.
3. Undersök lovande träffar vidare med find_symbol eller dependency_search i stä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.

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

Varför denna loop fungerar: Hur det fungerar.

När verktygen inte ger något användbart bör du kontrollera att rätt repo identifieras och indexeras, innan du fortsätter skriva om frågan i all oändlighet.

1. Bekräfta att repot är anslutet och färdigindexerat i app.maguyva.ai.
2. Kontrollera reposträngen: "owner/repo" använder standardgrenen; "owner/repo:branch" väljer en bestämd gren. Matchningen ignorerar skiftläge men är inte fuzzy — stavfel rättas inte automatiskt.
3. Anropa repository_context med action="info" och kontrollera metadata om hur repot identifierades (till exempel metadata.resolution_reason).
4. Utelämna repository endast när MCP-klienten anger ett anropsspecifikt standardrepo eller nyckeln har åtkomst till exakt ett repo; ange parametern uttryckligen annars.
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 Felsökning.

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

Installationsfel: Felsökning.

Välj rätt indexerat repo när en nyckel har åtkomst till flera.

1. Anropa repository_context med action="list" en gång för att få de exakta repoidentifierare som din nyckel kan söka i.
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. Håll dig till en fråga = ett repo, om du inte avsiktligt jämför repor i separata anrop.
4. Använd get_file när filen finns i ett indexerat repo utanför ditt aktuella arbetsträd.
5. Kom ihåg: verktyg skriver aldrig tillbaka till GitHub – multi-repo-sammanhang är endast för läsning och planering.

Detaljer om repoformat: MCP API-referens.

• Snabbstart — nyckel, indexera, anslut, bedöm det första svaret
• Installationsguide — MCP-konfiguration för varje klient
• MCP API-referens — varje verktyg, parameter för parameter
• Felsökning — API-nyckel, brygga och arkivfel