# Quickstart

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

Der schnellste Weg von null zur verifizierten Antwort: Hol dir einen Key, indexiere ein Repository, das du bereits kennst, verbinde deinen Client und stell eine Frage, die du bereits beurteilen kannst.

## 1. Hol dir einen API-Key

[Kostenlos starten](https://app.maguyva.ai) — keine Kreditkarte nötig. Deinen API-Key (er beginnt mit `mgv_`) findest du in [app.maguyva.ai](https://app.maguyva.ai).

## 2. Indexiere ein Repository, das du bereits kennst

Verbinde ein GitHub-Repository über das Portal und lass es indexieren. Wähle ein kleines Repo, das du schnell auf Plausibilität prüfen kannst — so siehst du sofort, ob Maguyva das Modell fundiert, statt am ersten Tag gleich die ganze Firma zu indexieren.

## 3. Verbinde deinen Client

Installiere für Claude Code das Maguyva-Plugin aus dem Marketplace — führe jeden Befehl innerhalb von Claude Code aus:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

Das Plugin authentifiziert sich mit deinem Key aus der Umgebungsvariable `MAGUYVA_API_KEY`. Setze sie in deiner Shell (projektspezifisches `direnv` wird empfohlen, da Keys repository-scoped sind):

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

Arbeitest du im Team? Wähle den Bereich project in dem Panel, das `/plugin install maguyva@maguyva` öffnet. Damit wird das Plugin in der `.claude/settings.json` des Repositorys eingetragen, die du committest; jedes Teammitglied führt die Installation trotzdem einmal aus. Die `/plugin`-Befehle innerhalb der Sitzung haben kein `--scope`-Flag – um es zu skripten, führe die Shell-Form im Stammverzeichnis des Repositorys aus:

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

Die meisten anderen Clients (Cursor, VS Code, Devin Desktop, Zed und Freunde) verbinden sich direkt mit dem Remote-Server — richte sie mit einem `Bearer`-Header auf den Endpunkt aus, keine Bridge nötig. Zum Beispiel die `.cursor/mcp.json` von Cursor:

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

Die Struktur variiert leicht je nach Client (VS Code verschachtelt unter `servers` mit `type: "http"`, Antigravity verwendet `serverUrl`, Zed verwendet `context_servers`). Dieses Cursor-Beispiel liest deinen Key aus der oben gezeigten Umgebungsvariable `MAGUYVA_API_KEY`; zeigt die Konfiguration eines Clients stattdessen den Platzhalter `mgv_xxxx`, ersetze ihn durch deinen API-Key. Starte danach deinen Client neu. Die exakte Konfiguration für alle 23 dokumentierten Clients findest du in der [Installationsanleitung](https://maguyva.ai/de/docs/installation).

## 4. Stell eine Frage, die du bereits beurteilen kannst

Beginne mit **"Welche Repositories habe ich verbunden?"**, um die Verbindung zu bestätigen, und stell dann eine echte Frage zu deinem Repo, deren Antwort du bereits kennst — etwa **"Wie wird die Authentifizierung in dieser Codebase gehandhabt?"**

Du solltest Antworten mit Dateipfaden und Zeilennummern zurückbekommen. Öffne die zitierten Dateien und überprüfe, ob die Antwort den Kontakt mit dem echten Repo übersteht. Diese eine beurteilte Antwort sagt dir mehr als jede Feature-Liste — lass das Tool dein Vertrauen verdienen, bevor es Teil deines Standard-Workflows wird.

Keine Ergebnisse oder Verbindungsfehler? Prüfe API-Schlüssel, Client-Konfiguration und Indexierungsstatus des Repositorys unter [Fehlerbehebung](https://maguyva.ai/de/docs/troubleshooting). Falls deine Einrichtung die Bridge nutzt, prüfe auch, ob `npx` verfügbar ist.

## Nächste Schritte

- Installationsanleitung: Konfiguration pro Client für alle 23 dokumentierten Clients
- So funktioniert's: was zwischen deiner Frage und der Antwort passiert
- MCP-API-Referenz: jedes Tool, Parameter für Parameter