# Snelstart

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

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

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](https://app.maguyva.ai) — geen creditcard nodig. Je API-sleutel (begint met `mgv_`) vind je in [app.maguyva.ai](https://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:

```text
/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):

```bash
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:

```bash
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:

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

## 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](https://maguyva.ai/nl/docs/troubleshooting). Als je opstelling de brug gebruikt, controleer dan ook of `npx` beschikbaar is.

## Volgende stappen

- Installatiegids: configuratie per client voor alle 23 gedocumenteerde clients
- Hoe het werkt: wat er gebeurt tussen je vraag en het antwoord
- MCP API-referentie: elke tool, parameter voor parameter