# Installationsguide

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

Kom igång på under 5 minuter. Den här guiden innehåller konfiguration för 23 MCP-klienter, inklusive 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, och Warp, och fler.

**Förutsättningar**: Du behöver en API-nyckel från [app.maguyva.ai](https://app.maguyva.ai) och ett anslutet GitHub-repository.

## Miljökonfiguration

Ställ först in API-nyckeln i en miljövariabel. Utelämna `repository` när MCP-klienten anger ett anropsspecifikt standardrepo eller när nyckeln har åtkomst till exakt ett repo; ange det annars uttryckligen.

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

Ersätt `mgv_xxxx` med din faktiska API-nyckel från [app.maguyva.ai](https://app.maguyva.ai).

## Klientkonfiguration

Välj din MCP-klient nedan för specifika installationsanvisningar.

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

Maguyva använder standard-MCP. Alla klienter som stödjer protokollet kan ansluta — även om det inte finns någon förstapartsguide ovan. 23 klienter dokumenterade, fler tillkommer regelbundet.

## Validera din installation

Efter anslutningen kan du prova att ställa några frågor till din agent:

- "Vilka repositorier har jag anslutna?" — verifierar att anslutningen fungerar
- "Hur hanteras autentisering i den här kodbasen?" — testar semantisk sökning
- "Hitta alla funktioner som anropar databasen" — testar beroendesökning
- "Vad beror klassen UserService på?" — testar symboluppslagning

Du bör se resultat med filsökvägar och radnummer från ditt anslutna repository. Om inte, kontrollera [troubleshooting](https://maguyva.ai/sv/docs/troubleshooting) nedan.

## Repositoryformat

När du anger repositorier:

- Med gren: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Standardgren: `"owner/repo"`

**Tips**: använd `repository_context(action="info", repository="...")` för att kontrollera hur kodarkivet identifieras. Ett uttryckligt val av kodarkiv gäller bara det aktuella anropet.

## Felsökning

### Problem med API-nyckel

- Kontrollera att din nyckel börjar med prefixet mgv_
- Kontrollera att nyckeln är korrekt inställd i din miljö
- Se till att nyckeln inte har gått ut

### Repository hittades inte

- Kontrollera att repot är anslutet i app.maguyva.ai
- Kontrollera att formatet owner/repo är korrekt
- Se till att du har åtkomst till repot

### Problem med MCP-anslutning

- Om din klient använder bryggan @maguyva/mcp, kontrollera att npx finns i din PATH
- Kontrollera att din API-token är giltig och inte har gått ut
- Testa anslutningen till https://maguyva.tools/mcp
- Kontrollera din klients MCP-konfigurationssyntax

## Nästa steg

- MCP API-referens: Fullständig API-dokumentation
- Så fungerar det: Förstå kontextoptimering
- Felsökning: Åtgärda installations- och anslutningsproblem