Fejlfinding

De fleste opsætningsfejl falder i fire kategorier: API-nøglen når ikke frem til serveren, @maguyva/mcp-broen starter ikke, repoet kan ikke findes, eller klienten kan slet ikke forbinde. Gå igennem det afsnit, der matcher dit symptom.

Hver forespørgsel autentificeres med din API-nøgle, sendt som en Authorization: Bearer-header eller, hvis en klient ikke kan sætte den, som en X-API-Key-header. Hvis værktøjskald afvises:

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

Hvis din klient bruger broen @maguyva/mcp, starter den en lokal proces, der forbinder til den eksterne server hos Maguyva:

MAGUYVA_API_KEY=mgv_xxxx npx -y @maguyva/mcp

Hvis serveren aldrig vises i din klient, eller vises og straks afbryder forbindelsen:

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

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

• 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 Installationsguide for din klient — konfigurationsfilens placering og form varierer fra klient til klient.

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.