# Installationsanleitung

Canonical source: https://maguyva.ai/de/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).

Sei in unter 5 Minuten startklar. Diese Anleitung enthält das Setup für 23 MCP-Clients, darunter 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 und Warp und mehr.

**Voraussetzungen**: Du brauchst einen API-Key von [app.maguyva.ai](https://app.maguyva.ai) und ein verbundenes GitHub-Repository.

## Umgebungseinrichtung

Lege zuerst deinen API-Schlüssel in einer Umgebungsvariable fest. Lass `repository` weg, wenn dein MCP-Client einen Standardwert für die Anfrage bereitstellt oder der Schlüssel auf genau ein Repository zugreifen kann; übergib es andernfalls ausdrücklich.

### 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
```

Ersetze `mgv_xxxx` durch deinen tatsächlichen API-Key von [app.maguyva.ai](https://app.maguyva.ai).

## Client-Konfiguration

Wähle unten deinen MCP-Client für spezifische Einrichtungsanweisungen.

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

Maguyva verwendet Standard-MCP. Jeder Client, der das Protokoll unterstützt, kann sich verbinden — auch wenn oben keine offizielle Anleitung existiert. 23 Clients dokumentiert, weitere kommen regelmäßig dazu.

## Überprüfe dein Setup

Stell deinem Agent nach dem Verbinden ein paar Fragen:

- "Welche Repositories habe ich verbunden?" — überprüft, ob die Verbindung funktioniert
- "Wie wird die Authentifizierung in dieser Codebase gehandhabt?" — testet die semantische Suche
- "Finde alle Funktionen, die die Datenbank aufrufen" — testet die Abhängigkeitssuche
- "Wovon hängt die Klasse UserService ab?" — testet Symbol Lookup

Du solltest Ergebnisse mit Dateipfaden und Zeilennummern aus deinem verbundenen Repository sehen. Falls nicht, wirf einen Blick in die [troubleshooting](https://maguyva.ai/de/docs/troubleshooting) unten.

## Repository-Format

Beim Angeben von Repositories:

- Mit Branch: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Standard-Branch: `"owner/repo"`

**Tipp**: Prüfe mit `repository_context(action="info", repository="...")` die Repository-Auflösung. Eine explizite Repository-Überschreibung gilt nur für den aktuellen Aufruf.

## Fehlerbehebung

### API-Key-Probleme

- Überprüfe, dass dein Key mit dem Präfix mgv_ beginnt
- Überprüfe, dass der Key korrekt in deiner Umgebung gesetzt ist
- Stelle sicher, dass der Key nicht abgelaufen ist

### Repository nicht gefunden

- Überprüfe, dass das Repository in app.maguyva.ai verbunden ist
- Überprüfe, dass das Format owner/repo korrekt ist
- Stelle sicher, dass du Zugriff auf das Repository hast

### MCP-Verbindungsprobleme

- Falls dein Client die Bridge @maguyva/mcp verwendet, prüfe, ob npx über deinen PATH verfügbar ist
- Überprüfe, dass dein API-Token gültig und nicht abgelaufen ist
- Teste die Verbindung zu https://maguyva.tools/mcp
- Überprüfe die MCP-Konfigurationssyntax deines Clients

## Nächste Schritte

- MCP-API-Referenz: Vollständige API-Dokumentation
- So funktioniert's: Verstehe die Kontextoptimierung
- Fehlerbehebung: Behebe Einrichtungs- und Verbindungsprobleme