Felsökning

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

Varje förfrågan autentiseras med din API-nyckel, skickad som en Authorization: Bearer-header eller, om en klient inte kan sätta en sådan, som en X-API-Key-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, skriv nyckeln direkt i konfigurationen: i Authorization-headern i en inbyggd fjärrkonfiguration (Bearer följt av din nyckel), eller i env-blocket i en konfiguration med @maguyva/mcp-bryggan.
• Se till att nyckeln inte har gått ut eller återkallats.

Om din klient använder bryggan @maguyva/mcp startar den en lokal process som ansluter till fjärrservern hos Maguyva:

MAGUYVA_API_KEY=mgv_xxxx npx -y @maguyva/mcp

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 @maguyva/mcp --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, Devin Desktop och Zed ansluter till fjärrservern direkt med en Bearer-header (Zed via context_servers). Bryggan är till för klienter som inte kan skicka den headern från sin konfiguration, som Claude Desktop, vars claude_desktop_config.json bara startar lokala servrar. Anpassade anslutningar i Claude Desktop kan skicka en authorization-request-header, men request-headers är i beta för ett begränsat antal organisationer.

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

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

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.