Naar inhoud springen

Snelstart

De snelste weg van nul naar een geverifieerd antwoord: haal een sleutel op, indexeer één repository die je al kent, verbind je client en stel één vraag waarvan je het antwoord al kunt beoordelen.

1. Vraag een API-sleutel aan#

Gratis starten — geen creditcard nodig. Je API-sleutel (begint met mgv_) vind je in app.maguyva.ai.

2. Indexeer een repository die je al kent#

Verbind een GitHub-repository vanuit het portaal en laat deze indexeren. Kies een kleine repo die je snel kunt controleren — zo zie je meteen of Maguyva het model daadwerkelijk onderbouwt, in plaats van meteen je hele bedrijf te proberen indexeren.

3. Verbind je client#

Voor Claude Code installeer je de plugin van Maguyva vanuit de marketplace — voer elke opdracht uit binnen Claude Code:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

De plugin authenticeert met je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel deze in binnen je shell (per-project direnv wordt aanbevolen, aangezien sleutels aan een repository gebonden zijn):

export MAGUYVA_API_KEY=mgv_xxxx

Werk je in een team? Voeg --scope project toe aan beide /plugin-opdrachten om de plugin vast te leggen in het .claude/settings.json van de repository, zodat teamgenoten hem automatisch krijgen.

De meeste andere clients (Cursor, VS Code, Windsurf, Zed en soortgenoten) verbinden rechtstreeks met de remote server — wijs ze naar het endpoint met een Bearer-header, geen bridge nodig. Bijvoorbeeld het .cursor/mcp.json van Cursor:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

De structuur verschilt licht per client (VS Code nest onder servers met type: "http", Windsurf gebruikt serverUrl, Zed gebruikt context_servers). Vervang mgv_xxxx door je API-sleutel en herstart je client. De exacte configuratie voor alle 24 gedocumenteerde clients staat in Installatiegids.

4. Stel één vraag waarvan je het antwoord al kunt beoordelen#

Begin met "Welke repositories heb ik verbonden?" om de verbinding te bevestigen, en stel dan één echte vraag over je repo waarvan je het antwoord al weet — bijvoorbeeld "Hoe wordt authenticatie afgehandeld in deze codebase?"

Je krijgt antwoorden terug met bestandspaden en regelnummers. Open de geciteerde bestanden en controleer of het antwoord standhoudt bij contact met de echte repo. Dat ene beoordeelde antwoord vertelt je meer dan welke featurelijst dan ook — laat de tool eerst vertrouwen verdienen voordat hij deel wordt van je vaste workflow.

Geen resultaten of verbindingsfouten? Ga naar Probleemoplossing — de meeste fouten komen door een niet-ingestelde API-sleutel, een ontbrekende npx, of een repository die nog niet klaar is met indexeren.

Volgende stappen#