Fejlfinding

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

Problemer med API-nøgle#

Hver forespørgsel autentificeres med din API-nøgle, sendt som en Authorization: Bearer-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å læg nøglen i konfigurationens env-blok.
• Sørg for at nøglen ikke er udløbet eller tilbagekaldt.

Problemer med mcp-remote-broen#

De fleste dokumenterede klientkonfigurationer starter en lokal broproces, der videresender stdio-MCP-trafik til den eksterne server:

npx -y mcp-remote https://maguyva.tools/mcp --header "Authorization: Bearer ${MAGUYVA_API_KEY}"

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 mcp-remote --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, Windsurf og Zed forbinder til den eksterne server nativt med en Bearer-header (Zed via context_servers). Broen er kun til klienter uden native understøttelse af eksterne headere, såsom OAuth-only-forbindelserne i Claude Desktop.

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 løses; 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 Installationsguide 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.