Feilsøking

De fleste oppsettsfeil havner i fire kategorier: API-nøkkelen når ikke frem til serveren, mcp-remote-broen starter ikke, repoet kan ikke løses, eller klienten kan ikke koble til i det hele tatt. Gå gjennom seksjonen som matcher symptomet ditt.

Problemer med API-nøkkel#

Hver forespørsel autentiseres med API-nøkkelen din, sendt som en Authorization: Bearer-header. Hvis verktøykall avvises:

• 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, legg nøkkelen i konfigurasjonens env-blokk.
• Sørg for at nøkkelen ikke har utløpt eller blitt tilbakekalt.

Problemer med mcp-remote-broen#

De fleste dokumenterte klientkonfigurasjoner starter en lokal broprosess som videresender stdio-MCP-trafikk til den eksterne serveren:

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

Hvis serveren aldri vises i klienten din, eller vises og kobler fra umiddelbart:

• Bekreft at npx er tilgjengelig i PATH-en din — broen trenger en fungerende Node.js-installasjon. Kjør npx -y mcp-remote --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, Windsurf og Zed kobler til den eksterne serveren nativt med en Bearer-header (Zed via context_servers). Broen er kun for klienter uten native støtte for eksterne headere, slik som OAuth-only-koblingene i Claude Desktop.

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.