# Installatiegids

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

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

Binnen 5 minuten aan de slag. Deze gids bevat installatie-instructies voor 23 MCP-clients, waaronder Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, en Warp, en meer.

**Vereisten**: je hebt een API-sleutel van [app.maguyva.ai](https://app.maguyva.ai) nodig en een verbonden GitHub-repository.

## Omgeving instellen

Stel eerst je API-sleutel in een omgevingsvariabele in. Laat `repository` weg wanneer je MCP-client een standaardwaarde voor het verzoek opgeeft of wanneer de sleutel toegang heeft tot precies één repository; geef deze anders expliciet door.

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Vervang `mgv_xxxx` door je eigen API-sleutel van [app.maguyva.ai](https://app.maguyva.ai).

## Clientconfiguratie

Kies hieronder je MCP-client voor specifieke installatie-instructies.

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Maguyva gebruikt standaard-MCP. Elke client die het protocol ondersteunt, kan verbinding maken — ook als we er hierboven geen eigen handleiding voor hebben. Er zijn 23 clients gedocumenteerd; er komen regelmatig nieuwe bij.

## Controleer je installatie

Stel je agent na het verbinden een paar vragen:

- "Welke repositories heb ik verbonden?" — controleert of de verbinding werkt
- "Hoe wordt authenticatie afgehandeld in deze codebase?" — test semantisch zoeken
- "Zoek alle functies die de database aanroepen" — test dependency-analyse
- "Waarvan is de UserService-klasse afhankelijk?" — test symbolen opzoeken

Je zou resultaten moeten zien met bestandspaden en regelnummers uit je verbonden repository. Zo niet, raadpleeg dan de [troubleshooting](https://maguyva.ai/nl/docs/troubleshooting) hieronder.

## Repository-indeling

Bij het opgeven van repositories:

- Met branch: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Standaardbranch: `"owner/repo"`

**Tip**: gebruik `repository_context(action="info", repository="...")` om de repositoryresolutie te controleren. Een expliciet gekozen repository geldt alleen voor de huidige aanroep.

## Probleemoplossing

### Problemen met de API-sleutel

- Controleer of je sleutel begint met het voorvoegsel mgv_
- Controleer of de sleutel correct is ingesteld in je omgeving
- Zorg dat de sleutel niet is verlopen

### Repository niet gevonden

- Controleer of de repository is verbonden in app.maguyva.ai
- Controleer of de indeling owner/repo correct is
- Zorg dat je toegang hebt tot de repository

### Problemen met de MCP-verbinding

- Als je client de brug @maguyva/mcp gebruikt, controleer dan of npx beschikbaar is in je PATH
- Controleer of je API-token geldig is en niet is verlopen
- Test de connectiviteit met https://maguyva.tools/mcp
- Controleer de syntaxis van de MCP-configuratie van je client

## Volgende stappen

- MCP API-referentie: Volledige API-documentatie
- Hoe het werkt: Begrijp contextoptimalisatie
- Probleemoplossing: Los installatie- en verbindingsproblemen op