# Feilsøking

Canonical source: https://maguyva.ai/nb/docs/troubleshooting

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).

Løs de vanligste oppsettsfeilene i Maguyva: problemer med API-nøkkel, feil i broen @maguyva/mcp, repo-oppslag og tilkoblingsfeil.

### Problemer med API-nøkkel

- Bekreft at nøkkelen din starter med prefikset mgv_.
- Sjekk at du erstattet plassholderen mgv_xxxx fra konfigurasjonseksemplene med din faktiske nøkkel fra app.maguyva.ai.
- Hvis konfigurasjonen din leser nøkkelen fra MAGUYVA_API_KEY, bekreft at variabelen er satt i miljøet klienten din faktisk starter fra. Skall-eksporter lagt til i ~/.zshrc eller ~/.bashrc gjelder først etter at skallet er lastet på nytt, og GUI-apper arver dem kanskje ikke i det hele tatt. Er du i tvil, skriv nøkkelen rett inn i konfigurasjonen: i Authorization-headeren i en native ekstern konfigurasjon (Bearer etterfulgt av nøkkelen din), eller i env-blokken i en konfigurasjon med @maguyva/mcp-broen.
- Sørg for at nøkkelen ikke har utløpt eller blitt tilbakekalt.

### Problemer med broen @maguyva/mcp

- Bekreft at npx er tilgjengelig i PATH-en din -- broen trenger en fungerende Node.js-installasjon. Kjør npx -y @maguyva/mcp --help i en terminal for å bekrefte at den kan starte.
- Sjekk syntaksen i MCP-konfigurasjonen til klienten din -- en feilformatert JSON-fil feiler stille i enkelte klienter.
- Mange klienter trenger ikke broen i det hele tatt. Claude Code bruker Maguyva-pluginet (/plugin install maguyva@maguyva), og Cursor, VS Code, Devin Desktop og Zed kobler til den eksterne serveren nativt med en Bearer-header (Zed via context_servers). Broen er for klienter som ikke kan sende den headeren fra konfigurasjonen sin, slik som Claude Desktop, der claude_desktop_config.json bare starter lokale servere. Egendefinerte koblinger i Claude Desktop kan sende en authorization-forespørselsheader, men forespørselsheadere er i beta for et begrenset antall organisasjoner.

### Repo ikke funnet

- Bekreft at depotet er tilkoblet og indeksert i app.maguyva.ai.
- Sjekk formatet: "owner/repo" målretter mot standardgrenen, "owner/repo:branch" målretter mot en spesifikk gren (f.eks. "owner/repository:develop").
- Sørg for at kontoen din har tilgang til depotet.
- Bruk repository_context(action="info", repository="...") for å se hvordan repoet løses; utelat repository-parameteren bare når MCP-klienten oppgir en standard for den aktuelle forespørselen, eller når nøkkelen har tilgang til nøyaktig ett repo.

### MCP-tilkoblingsproblemer

- Test tilkoblingen til https://maguyva.tools/mcp fra maskinen din -- bedriftsproxyer og brannmurer er de vanlige synderne.
- Sjekk at API-tokenet ditt er gyldig og ikke utløpt.
- Dobbeltsjekk klientkonfigurasjonen mot Installasjonsguiden for klienten din -- plasseringen og formen på konfigurasjonsfilen varierer per klient.

### Verifiser fiksen

Etter enhver endring, still agenten din "Hvilke repoer har jeg koblet til?" -- det verifiserer tilkoblingen fra ende til ende. Still deretter et ekte spørsmål om repoet ditt; du bør se svar med filstier og linjenumre fra det tilkoblede repoet ditt.