Zum Inhalt springen

Quickstart

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 — keine Kreditkarte nötig. Dein API-Key (er beginnt mit mgv_) findest du in 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:

/plugin marketplace add maguyva/claude-code-plugin
/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):

export MAGUYVA_API_KEY=mgv_xxxx

Arbeitest du im Team? Füge --scope project zu beiden /plugin-Befehlen hinzu, um das Plugin in die .claude/settings.json des Repositorys zu committen, damit Teammitglieder es automatisch erhalten.

Die meisten anderen Clients (Cursor, VS Code, Windsurf, 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:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Die Struktur variiert leicht je nach Client (VS Code verschachtelt unter servers mit type: "http", Windsurf verwendet serverUrl, Zed verwendet context_servers). Ersetze mgv_xxxx durch deinen API-Key und starte dann deinen Client neu. Die exakte Konfiguration für alle 24 dokumentierten Clients findest du in der Installationsanleitung.

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 dir das Tool das Vertrauen verdienen, bevor es Teil deines Standard-Workflows wird.

Keine Ergebnisse oder Verbindungsfehler? Schau in die Fehlerbehebung — die meisten Fehler sind ein nicht gesetzter API-Key, ein fehlendes npx oder ein Repository, das noch nicht fertig indexiert ist.

Nächste Schritte#