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 die indexeren. Kies een kleine repo die je snel kunt controleren — zo zie je meteen of Maguyva het model daadwerkelijke codebasecontext geeft, in plaats van meteen je hele bedrijf te proberen te 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/agent-plugins
/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? Kies het bereik project in het paneel dat /plugin install maguyva@maguyva opent. Dat legt de plugin vast in de .claude/settings.json van de repository, die je commit; elke teamgenoot voert de installatie toch één keer uit. De /plugin-opdrachten binnen de sessie hebben geen --scope-vlag, dus voer om het te scripten de shellvorm uit vanuit de root van de repository:

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

De meeste andere clients (Cursor, VS Code, Devin Desktop, 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 ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

De structuur verschilt licht per client (VS Code plaatst de configuratie onder servers met type: "http", Antigravity gebruikt serverUrl, Zed gebruikt context_servers). Dit Cursor-voorbeeld leest je sleutel uit de hierboven getoonde omgevingsvariabele MAGUYVA_API_KEY; toont de configuratie van een client in plaats daarvan de placeholder mgv_xxxx, vervang die dan door je API-sleutel. Herstart daarna je client. De exacte configuratie voor alle 23 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? Controleer je API-sleutel, clientconfiguratie en de indexeringsstatus van de repository in Probleemoplossing. Als je opstelling de brug gebruikt, controleer dan ook of npx beschikbaar is.

Volgende stappen

#