Felsökning

De flesta installationsfel faller inom fyra kategorier: API-nyckeln når inte servern, mcp-remote-bryggan startar inte, repositoryt kan inte matchas, eller klienten kan inte ansluta alls. Gå igenom avsnittet som matchar ditt symptom.

Problem med API-nyckel#

Varje förfrågan autentiseras med din API-nyckel, skickad som en Authorization: Bearer-header. Om verktygsanrop avvisas:

• 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, lägg nyckeln i konfigurationens env-block.
• Se till att nyckeln inte har gått ut eller återkallats.

Problem med mcp-remote-bryggan#

De flesta dokumenterade klientkonfigurationer startar en lokal bryggprocess som vidarebefordrar stdio MCP-trafik till fjärrservern:

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

Om servern aldrig visas i din klient, eller visas och kopplas ner omedelbart:

• Kontrollera att npx finns tillgängligt i din PATH — bryggan behöver en fungerande Node.js-installation. Kör npx -y mcp-remote --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, Windsurf och Zed ansluter till fjärrservern direkt med en Bearer-header (Zed via context_servers). Bryggan är bara till för klienter utan inbyggt stöd för fjärr-headers, som OAuth-endast-anslutningarna i Claude Desktop.

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