# Recepten

Canonical source: https://maguyva.ai/nl/docs/cookbook

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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](https://maguyva.ai/docs/mcp-api). Gebruik voor de eerste installatie de [Snelstart](https://maguyva.ai/docs/quickstart).

### Kies de juiste tool

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).

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

### Installeer en verifieer een client

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](https://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](https://maguyva.ai/docs/installation) (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.

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

Problemen met sleutels, bridges of ontbrekende repo's? [Probleemoplossing](https://maguyva.ai/docs/troubleshooting).

### Stel vragen vóór je code wijzigt

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.

```json
{
  "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](https://maguyva.ai/docs/mcp-api).

### Zoeken en dan veranderen

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.

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

Waarom deze lus werkt: [Hoe het werkt](https://maguyva.ai/docs/how-it-works).

### Geen of weinig bruikbare resultaten

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](https://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](https://maguyva.ai/docs/troubleshooting).

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

Installatiefouten: [Probleemoplossing](https://maguyva.ai/docs/troubleshooting).

### Werk in meerdere opslagplaatsen

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](https://maguyva.ai/docs/mcp-api).

Voor het eerst instellen? Begin met [Snelstart](https://maguyva.ai/docs/quickstart) en gebruik daarna deze recepten voor dagelijkse taken.