# Installasjonsguide

Canonical source: https://maguyva.ai/nb/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 i gang på under 5 minutter. Denne guiden inkluderer oppsett for 23 MCP-klienter, blant annet 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, og Warp, og flere.

**Forutsetninger**: Du trenger en API-nøkkel fra [app.maguyva.ai](https://app.maguyva.ai) og et tilkoblet GitHub-repo.

## Miljøoppsett

Angi først API-nøkkelen i en miljøvariabel. Utelat `repository` når MCP-klienten oppgir en standard for den aktuelle forespørselen, eller når nøkkelen har tilgang til nøyaktig ett repo; ellers oppgir du den eksplisitt.

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

Erstatt `mgv_xxxx` med din faktiske API-nøkkel fra [app.maguyva.ai](https://app.maguyva.ai).

## Klientkonfigurasjon

Velg MCP-klienten din nedenfor for spesifikke oppsettsinstruksjoner.

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

Maguyva bruker standard MCP. Enhver klient som støtter protokollen kan koble til — selv om det ikke finnes en offisiell guide ovenfor. 23 klienter er dokumentert, flere legges til jevnlig.

## Valider oppsettet ditt

Etter tilkobling, prøv å stille agenten din noen spørsmål:

- "Hvilke repoer har jeg koblet til?" — verifiserer at tilkoblingen fungerer
- "Hvordan håndteres autentisering i denne kodebasen?" — tester semantisk søk
- "Finn alle funksjoner som kaller databasen" — tester avhengighetssøk
- "Hva er UserService-klassen avhengig av?" — tester symboloppslag

Du bør se resultater med filstier og linjenumre fra det tilkoblede repoet ditt. Hvis ikke, sjekk [troubleshooting](https://maguyva.ai/nb/docs/troubleshooting) nedenfor.

## Repo-format

Når du spesifiserer repoer:

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

**Tips**: bruk `repository_context(action="info", repository="...")` for å kontrollere hvordan repositoriet identifiseres. En overstyring av repositoriet gjelder bare det gjeldende anropet.

## Feilsøking

### Problemer med API-nøkkel

- Bekreft at nøkkelen din starter med mgv_-prefikset
- Sjekk at nøkkelen er riktig satt i miljøet ditt
- Sørg for at nøkkelen ikke har utløpt

### Repo ikke funnet

- Bekreft at repoet er koblet til i app.maguyva.ai
- Sjekk at owner/repo-formatet er riktig
- Sørg for at du har tilgang til repoet

### MCP-tilkoblingsproblemer

- Hvis klienten din bruker broen @maguyva/mcp, kontroller at npx er tilgjengelig i PATH
- Sjekk at API-tokenet ditt er gyldig og ikke utløpt
- Test tilkoblingen til https://maguyva.tools/mcp
- Sjekk syntaksen i MCP-konfigurasjonen til klienten din

## Neste steg

- MCP API-referanse: Fullstendig API-dokumentasjon
- Slik fungerer det: Forstå kontekstoptimalisering
- Feilsøking: Løs problemer med oppsett og tilkobling