Pag-aayos ng Problema

Karamihan sa setup failure ay napapasok sa apat na kategorya: hindi umaabot ang API key sa server, hindi nag-start ang @maguyva/mcp bridge, hindi ma-resolve ang repository, o hindi talaga makakonekta ang client. Puntahan ang section na tumutugma sa sintomas mo.

Bawat request ay nag-a-authenticate gamit ang API key mo, ipinapadala bilang Authorization: Bearer header o, kung hindi kayang magtakda nito ng client, bilang X-API-Key header. Kung tinatanggihan ang tool calls:

• I-verify na nagsisimula ang key mo sa mgv_ prefix.
• Siguraduhing napalitan mo na ang mgv_xxxx placeholder mula sa config examples ng totoo mong key mula sa app.maguyva.ai.
• Kung binabasa ng config mo ang key mula sa MAGUYVA_API_KEY, i-confirm na naka-set ang variable sa environment kung saan talaga nag-la-launch ang client mo. Ang shell exports na idinagdag sa ~/.zshrc o ~/.bashrc ay mag-a-apply lang pagkatapos i-reload ang shell — at maaaring hindi ito ma-inherit ng mga GUI app. Kung nag-aalinlangan, isulat na lang mismo ang key sa config: sa Authorization header ng native remote config (Bearer na sinusundan ng key mo), o sa env block ng @maguyva/mcp bridge config.
• Siguraduhing hindi pa expired o na-revoke ang key.

Kung ginagamit ng iyong client ang bridge na @maguyva/mcp, nagpapasimula ito ng lokal na proseso na kumokonekta sa remote server ng Maguyva:

MAGUYVA_API_KEY=mgv_xxxx npx -y @maguyva/mcp

Kung hindi lumalabas ang server sa client mo, o lumalabas pero agad na nadidiskonekta:

• I-verify na available ang npx sa PATH mo — kailangan ng bridge ng gumaganang Node.js install. Patakbuhin ang npx -y @maguyva/mcp --help sa terminal para i-confirm na kaya nitong mag-start.
• Tingnan ang MCP configuration syntax ng client mo — may mga client na tahimik na nabibigo kapag malformed ang JSON file.
• Maraming client ang hindi na nangangailangan ng bridge. Ginagamit ng Claude Code ang Maguyva plugin (/plugin install maguyva@maguyva), at direktang kumokonekta ang Cursor, VS Code, Devin Desktop, at Zed sa remote server gamit ang Bearer header (sa Zed, via context_servers). Para ang bridge sa mga client na hindi makapagpadala ng header na iyon mula sa config nila, tulad ng Claude Desktop, na ang claude_desktop_config.json ay local servers lang ang sinisimulan. Puwedeng magpadala ng authorization request header ang custom connectors ng Claude Desktop, pero nasa beta pa ang request headers para sa limitadong bilang ng organisasyon.

• I-verify na naka-connect at naka-index ang repository sa app.maguyva.ai.
• Tingnan ang format: "owner/repo" para sa default branch, "owner/repo:branch" para sa specific na branch (hal. "owner/repository:develop").
• Siguraduhing may access ang account mo sa repository.
• Gamitin ang repository_context(action="info", repository="...") upang siyasatin ang repository resolution; alisin lamang ang repository parameter kapag nagbibigay ang iyong MCP client ng request default o eksaktong isang repository lang ang maa-access ng key.

• I-test ang connectivity papunta sa https://maguyva.tools/mcp mula sa machine mo — kadalasang dahilan ang corporate proxies at firewalls.
• Tingnan kung valid at hindi pa expired ang API token mo.
• I-recheck ang client config laban sa Gabay sa Pag-install para sa client mo — naiiba ang lokasyon at shape ng config file kada client.

Pagkatapos ng anumang pagbabago, itanong sa agent mo ang "Anong mga repository ang na-connect ko?" — para ma-verify ang connection end to end. Tapos magtanong ng totoong tanong tungkol sa repo mo; dapat makita mo ang mga sagot na may file paths at line numbers mula sa naka-connect na repository mo.