# Fejlfinding

Canonical source: https://maguyva.ai/da/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 mest almindelige opsætningsfejl i Maguyva: problemer med API-nøgle, fejl i broen @maguyva/mcp, repo-opslag og forbindelsesfejl.

### Problemer med API-nøgle

- Bekræft at din nøgle starter med præfikset mgv_.
- Tjek at du erstattede pladsholderen mgv_xxxx fra konfigurationseksemplerne med din rigtige nøgle fra app.maguyva.ai.
- Hvis din konfiguration læser nøglen fra MAGUYVA_API_KEY, så bekræft at variablen er sat i det miljø, din klient rent faktisk starter fra. Shell-exports tilføjet i ~/.zshrc eller ~/.bashrc gælder først, efter shellet er genindlæst, og GUI-apps arver dem måske slet ikke. Er du i tvivl, så skriv nøglen direkte i konfigurationen: i Authorization-headeren i en native ekstern konfiguration (Bearer efterfulgt af din nøgle), eller i env-blokken i en konfiguration med @maguyva/mcp-broen.
- Sørg for at nøglen ikke er udløbet eller tilbagekaldt.

### Problemer med broen @maguyva/mcp

- Bekræft at npx er tilgængelig i din PATH -- broen kræver en fungerende Node.js-installation. Kør npx -y @maguyva/mcp --help i en terminal for at bekræfte, at den kan starte.
- Tjek syntaksen i din klients MCP-konfiguration -- en fejlformateret JSON-fil fejler stille i nogle klienter.
- Mange klienter har slet ikke brug for broen. Claude Code bruger Maguyva-pluginet (/plugin install maguyva@maguyva), og Cursor, VS Code, Devin Desktop og Zed forbinder til den eksterne server nativt med en Bearer-header (Zed via context_servers). Broen er til klienter, der ikke kan sende den header fra deres konfiguration, såsom Claude Desktop, hvis claude_desktop_config.json kun starter lokale servere. Brugerdefinerede forbindelser i Claude Desktop kan sende en authorization-anmodningsheader, men anmodningsheadere er i beta for et begrænset antal organisationer.

### Repo ikke fundet

- Bekræft, at repoet er tilsluttet og indekseret i app.maguyva.ai.
- Tjek formatet: "owner/repo" målretter standardbranchen, "owner/repo:branch" målretter en bestemt branch (f.eks. "owner/repository:develop").
- Sørg for, at din konto har adgang til repoet.
- Brug repository_context(action="info", repository="...") til at se, hvordan repoet identificeres; udelad kun repository-parameteren, når MCP-klienten angiver en standard for den aktuelle forespørgsel, eller når nøglen har adgang til præcis ét repo.

### Problemer med MCP-forbindelse

- Test forbindelsen til https://maguyva.tools/mcp fra din maskine -- firmaproxyer og firewalls er de sædvanlige syndere.
- Tjek at dit API-token er gyldigt og ikke udløbet.
- Dobbelttjek klientkonfigurationen mod Installationsguiden for din klient -- konfigurationsfilens placering og form varierer fra klient til klient.

### Verificér løsningen

Efter enhver ændring, så spørg din agent "Hvilke repos har jeg forbundet?" -- det verificerer forbindelsen fra ende til anden. Stil derefter et rigtigt spørgsmål om dit repo; du bør se svar med filstier og linjenumre fra dit forbundne repo.