# Felsökning

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

Åtgärda vanliga installationsfel i Maguyva: problem med API-nyckel, bryggan @maguyva/mcp, repository-uppslagning och anslutningsfel.

### Problem med API-nyckel

- Kontrollera att din nyckel börjar med prefixet mgv_.
- Kontrollera att du ersatte platshållaren mgv_xxxx från konfigurationsexemplen med din riktiga nyckel från app.maguyva.ai.
- Om din konfiguration läser nyckeln från MAGUYVA_API_KEY, bekräfta att variabeln är satt i den miljö som din klient faktiskt startar från. Skalexporter tillagda i ~/.zshrc eller ~/.bashrc börjar bara gälla efter att skalet laddats om, och GUI-appar kanske inte ärver dem alls. Är du osäker, skriv nyckeln direkt i konfigurationen: i Authorization-headern i en inbyggd fjärrkonfiguration (Bearer följt av din nyckel), eller i env-blocket i en konfiguration med @maguyva/mcp-bryggan.
- Se till att nyckeln inte har gått ut eller återkallats.

### Problem med bryggan @maguyva/mcp

- Kontrollera att npx finns tillgängligt i din PATH -- bryggan behöver en fungerande Node.js-installation. Kör npx -y @maguyva/mcp --help i en terminal för att bekräfta att den kan starta.
- Kontrollera din klients MCP-konfigurationssyntax -- en felformaterad JSON-fil misslyckas tyst i vissa klienter.
- Många klienter behöver inte bryggan alls. Claude Code använder Maguyva-pluginet (/plugin install maguyva@maguyva), och Cursor, VS Code, Devin Desktop och Zed ansluter till fjärrservern direkt med en Bearer-header (Zed via context_servers). Bryggan är till för klienter som inte kan skicka den headern från sin konfiguration, som Claude Desktop, vars claude_desktop_config.json bara startar lokala servrar. Anpassade anslutningar i Claude Desktop kan skicka en authorization-request-header, men request-headers är i beta för ett begränsat antal organisationer.

### Repository hittades inte

- Verifiera att repot är anslutet och indexerat i app.maguyva.ai.
- Kontrollera formatet: "owner/repo" riktar sig mot standardgrenen, "owner/repo:branch" riktar sig mot en specifik gren (t.ex. "owner/repository:develop").
- Se till att ditt konto har åtkomst till repot.
- Använd repository_context(action="info", repository="...") för att se hur repot löses; utelämna repository-parametern endast när MCP-klienten anger ett anropsspecifikt standardrepo eller när nyckeln har åtkomst till exakt ett repo.

### MCP-anslutningsproblem

- Testa anslutningen till https://maguyva.tools/mcp från din maskin -- företagsproxyservrar och brandväggar är de vanliga bovarna.
- Kontrollera att din API-token är giltig och inte har gått ut.
- Dubbelkolla klientkonfigurationen mot installationsguiden för din klient -- konfigurationsfilens plats och format skiljer sig mellan klienter.

### Verifiera lösningen

Efter varje ändring, fråga din agent "Vilka repositorier har jag anslutna?" -- det verifierar anslutningen från början till slut. Ställ sedan en riktig fråga om ditt repo; du bör se svar med filsökvägar och radnummer från ditt anslutna repository.