Recepten

Praktische recepten voor dagelijks werk met Maguyva MCP. Elk recept noemt de tools en de volgorde, zonder een volledige parameterreferentie te geven. Gebruik voor toolparameters de MCP API-referentie. Gebruik voor de eerste installatie de Snelstart.

De JSON-blokken zijn invoer voor MCP tools/call. Vervang owner/repo, de branch en de symboolnamen door waarden uit je repository.

Begin meestal met één aanroep. Zoek pas verder als het eerste antwoord te breed of te beperkt is.

• intelligent_search — begin hier voor een vraag over de codebase in gewone taal. Standaard stuurt auto/balanced vragen die met voldoende zekerheid als definitievragen worden herkend naar structureel zoeken, vragen over verwijzingen of impact naar de graaf en vragen om exacte overeenkomsten naar tekstzoeken. Andere vragen gebruiken semantische betekenis en geïndexeerde tekst. Gebruik mode=hybrid of auto met quality=thorough om alle vier de zoekmodaliteiten aan te vragen; een expliciete modus heeft voorrang op quality.
• find_symbol — je kent de functie, klasse of variabelenaam al.
• dependency_search — impactradius: aanroepende code, afhankelijke componenten of impact vóór (en na) een wijziging.
• 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 de keuze van tools en het gebruik van Maguyva (zonder wijzigingen aan de repository).

Voeg Maguyva toe aan je MCP-client en controleer de verbinding door een echte repositorylijst op te vragen.

1. Maak een API-sleutel in app.maguyva.ai (sleutels beginnen met mgv_).
2. Verbind en indexeer ten minste één GitHub-repository die je al begrijpt.
3. Configureer je client volgens de Installatiehandleiding (de Claude Code-plugin of een directe remote-configuratie voor Cursor, VS Code, Devin Desktop, Zed en andere clients).
4. Vraag je agent "Welke repositories heb ik aangesloten?" — daarmee test je authenticatie en repository_context van begin tot eind.
5. Stel één echte vraag over die opslagplaats waarvan je het antwoord kunt beoordelen. Je zou bestandspaden en regelnummers uit de geïndexeerde boomstructuur moeten zien.

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

Problemen met sleutels, bridges of ontbrekende repo's? Probleemoplossing.

Breng symbolen en de impactradius in kaart voordat je gedeelde code wijzigt. Maguyva-tools veranderen je repositories niet — ze leveren de informatie voor de wijziging die je client lokaal uitvoert.

1. Als je de symboolnaam kent, roep dan find_symbol aan om definities en gebruikslocaties te vinden.
2. Als je alleen een taakbeschrijving hebt ("voeg SSO toe", "repareer de factureringswebhook"), begin dan met get_task_context of intelligent_search.
3. Roep vóór het wijzigen van een gedeeld symbool dependency_search aan met een analyse van afhankelijke componenten of impact (of geef gewijzigde paden mee voor impactanalyse zoals bij een PR), zodat je de impactradius 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 wijziging dezelfde symbolen opnieuw met dependency_search, met verify_after_edit=true en targets of changed_paths. Dit leest de geïndexeerde graaf, niet lokale wijzigingen zonder commit: controleer indexed_commit_sha en de actualiteit van de index voordat je dit als bewijs voor de nieuwe revisie gebruikt, en voer lokale tests uit.

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

Volledige parameters: MCP API-referentie.

Een standaardwerkwijze voor agents: verkennen → symbolen identificeren → wijzigen op basis van bewijs.

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 de resultaten met taal- of padfilters als het eerste resultatenvenster veel ruis bevat. Een language_filter sluit de graaf uit van auto/hybrid; een auto-query die uitsluitend naar de graaf werd gestuurd, valt terug op semantisch zoeken en tekstzoeken. Een expliciete graafmodus met een language_filter wordt afgewezen. Bekijk routing_decision.modalities_used om het gekozen zoekplan te zien; warnings is er alleen als de server een waarschuwing heeft gegeven.
3. Onderzoek veelbelovende resultaten verder met find_symbol of dependency_search in plaats van dezelfde vage vraag opnieuw te stellen.
4. Gebruik get_file alleen als je een specifiek geïndexeerd pad nodig hebt dat niet op schijf staat.
5. Wijzig code met je gebruikelijke clienttools. Maguyva is bedoeld voor verkennen en verifiëren, niet voor schrijven.

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

Waarom deze lus werkt: Hoe het werkt.

Als tools niets bruikbaars opleveren, controleer dan eerst de repositoryselectie en indexering in plaats van eindeloos je query te herschrijven.

1. Controleer of de repository is verbonden en klaar is met indexeren in app.maguyva.ai.
2. Controleer de repositorynaam: "owner/repo" gebruikt de standaardbranch; "owner/repo:branch" kiest een specifieke branch. Hoofdletters maken geen verschil, maar er wordt niet op benadering gezocht — 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 je MCP-client een standaardwaarde voor het verzoek opgeeft of als de sleutel toegang heeft tot precies één repository; geef de parameter 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 Probleemoplossing.

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

Installatiefouten: Probleemoplossing.

Kies de juiste geïndexeerde repo wanneer een sleutel toegang heeft tot meerdere repositories.

1. Roep repository_context één keer aan met action="list" om de exacte repositorynamen (slugs) te vinden die je sleutel kan doorzoeken.
2. Geef repository expliciet mee aan zoek- en symbooltools als je een andere repo dan de standaardrepo nodig hebt (bijvoorbeeld "owner/other-repo" of "owner/other-repo:develop").
3. Houd één vraag = één repository, tenzij je opzettelijk repo's in afzonderlijke aanroepen vergelijkt.
4. Gebruik get_file wanneer het bestand zich in een geïndexeerde repository bevindt die niet je huidige werkboom is.
5. Onthoud: tools schrijven nooit terug naar GitHub - context met meerdere repository's is alleen bedoeld voor lezen en plannen.

Details over de repositorynotatie: MCP API-referentie.

• Snelstart — sleutel, index, verbinden, eerste beoordeelde antwoord
• Installatiehandleiding — MCP-configuratie per client.
• MCP API-referentie — elke tool, parameter voor parameter
• Problemen oplossen — API-sleutel-, bridge- en repositoryfouten