Naar inhoud springen

Recepten

Praktische recepten voor het dagelijkse Maguyva MCP werk. Elk recept noemt de gereedschappen en de volgorde – geen volledige parameterreferentie. Gebruik voor gereedschapsparameters de MCP API-referentie. Gebruik voor de eerste installatie de Quickstart.

Kies het juiste gereedschap#

De meeste vragen beginnen met één telefoontje. Escaleer alleen als het eerste antwoord te breed of te dun is.

  • intelligent_search — begin hier voor elke codebase-vraag in natuurlijke taal; het routeert door semantisch, symbool, structureel en afhankelijkheidsonderzoek.
  • find_symbol — u kent de functie, klasse of variabelenaam al.
  • dependency_search — explosieradius: bellers, afhankelijke personen of impact vóór (en na) een bewerking.
  • get_task_context — onbekend gebied; één begrensde bundel bestanden, symbolen en afhankelijkheden voor een taakbeschrijving.
  • repository_context — maak een lijst van toegankelijke repository's of inspecteer hoe een repositorynaam wordt omgezet.
  • ask_maguyva met operation="guidance" - lokale hulp bij gereedschapsselectie en Maguyva-gebruik (geen repo-mutatie).

Installeer en verifieer een client#

Haal Maguyva in uw MCP-client en bevestig de verbinding met een echte repositorylijst.

  1. Maak een API-sleutel in app.maguyva.ai (sleutels beginnen met mgv_).
  2. Verbind en indexeer ten minste één GitHub-repository die u al begrijpt.
  3. Bekabel uw client met behulp van de Installatiehandleiding (Claude Code-plug-in, of native externe configuratie voor Cursor, VS Code, Windsurf, Zed en anderen).
  4. Vraag uw agent "Welke repositories heb ik aangesloten?" — die authenticatie en repository_context end-to-end uitoefent.
  5. Stel één echte vraag over die opslagplaats waarvan u het antwoord kunt beoordelen. U zou bestandspaden en regelnummers uit de geïndexeerde boomstructuur moeten zien.

Zit u vast aan sleutels, bruggen of ontbrekende repo's? Troubleshooting.

Vraag het voordat u het bewerkt#

Breng symbolen en ontploffingsradius in kaart voordat u de gedeelde code wijzigt. Maguyva-tools wijzigen uw repository's niet; zij informeren over de bewerking die uw client lokaal toepast.

  1. Als u de naam van het symbool kent, bel dan find_symbol om naar definities en toepassingen te gaan.
  2. Als u alleen een taakbeschrijving heeft ("voeg SSO toe", "repareer de factureringswebhook"), begin dan met get_task_context of intelligent_search.
  3. Voordat u een gedeeld symbool bewerkt, roept u dependency_search aan met afhankelijke/impactanalyse (of geeft u gewijzigde paden door voor impact in PR-stijl), zodat u de ontploffingsradius ziet.
  4. Open de geciteerde bestanden (lokaal lezen voor bestanden op schijf; get_file voor externe/cross-repo-paden) en bevestig het plan aan de hand van echte code.
  5. Controleer na de bewerking dezelfde symbolen opnieuw met dependency_search (inclusief verificatie na bewerking wanneer uw client de verificatievlaggen ondersteunt), zodat bellers nog steeds zoals verwacht worden opgelost.

Volledige parameters: MCP API-referentie.

Zoeken en dan veranderen#

Een standaardagentlus: verkennen → symbolen vastzetten → bewerken met bewijsmateriaal.

  1. Begin met intelligent_search en een eenvoudige vraag ("hoe werkt het verlopen van een sessie", "waar is de logica voor opnieuw proberen").
  2. Beperk met taal- of padfilters wanneer het eerste venster ruis bevat.
  3. Promoot veelbelovende hits op find_symbol of dependency_search in plaats van dezelfde vage vraag opnieuw te stellen.
  4. Gebruik get_file alleen als u een specifiek geïndexeerd pad nodig heeft dat niet op schijf staat.
  5. Bewerk in uw normale clienttools. Maguyva is voor detectie en verificatie – niet voor schrijven.

Waarom deze lus werkt: Hoe het werkt.

Lege of dunne resultaten#

Wanneer tools niets nuttigs opleveren, herstel dan de resolutie en indexering voordat u de query voorgoed herschrijft.

  1. Controleer of de repository is verbonden en klaar is met indexeren in app.maguyva.ai.
  2. Controleer de repositoryreeks: "owner/repo" gebruikt de standaardvertakking; "owner/repo:branch" pint een tak. Matchen is niet hoofdlettergevoelig en niet vaag; typefouten worden niet automatisch gecorrigeerd.
  3. Roep repository_context aan met action="info" en inspecteer metagegevens over de resolutie (bijvoorbeeld metadata.resolution_reason).
  4. Laat repository alleen weg als uw MCP-client een standaardverzoek levert of als de sleutel toegang heeft tot precies één repository; geef het anders expliciet door.
  5. Probeer het opnieuw met een specifiekere zoekopdracht, een bekende symboolnaam via find_symbol of een taal-/padfilter. Als de verbinding zelf verbroken is, gebruik dan Troubleshooting.

Installatiefouten: Troubleshooting.

Werk in meerdere opslagplaatsen#

Richt u op de juiste geïndexeerde repository wanneer een sleutel er meer dan één kan zien.

  1. Bel repository_context één keer met action="list" om erachter te komen welke naaktslakken uw sleutel precies kan doorzoeken.
  2. Geef repository expliciet door in zoek- en symboolhulpmiddelen wanneer u een niet-standaard repository nodig heeft (bijvoorbeeld "owner/other-repo" of "owner/other-repo:develop").
  3. Houd één vraag = één repository, tenzij u opzettelijk repo's in afzonderlijke oproepen vergelijkt.
  4. Gebruik get_file wanneer het bestand zich in een geïndexeerde repository bevindt die niet uw huidige werkboom is.
  5. Onthoud: tools schrijven nooit terug naar GitHub - context met meerdere repository's is alleen bedoeld voor lezen en plannen.

Details opslagplaatsformaat: MCP API-referentie.

Nieuw bij Maguyva? Loop eerst Quickstart en kom dan hier terug voor de lussen van dag twee.

Volgende stappen#