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 mcp-remote bridge, hindi ma-resolve ang repository, o hindi talaga makakonekta ang client. Puntahan ang section na tumutugma sa sintomas mo.

Mga isyu sa API key#

Bawat request ay nag-a-authenticate gamit ang API key mo, ipinapadala bilang Authorization: Bearer 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, ilagay na lang ang key sa env block ng config.
• Siguraduhing hindi pa expired o na-revoke ang key.

Mga isyu sa mcp-remote bridge#

Karamihan sa naka-document na client config ay naglulunsad ng local bridge process na nag-fo-forward ng stdio MCP traffic papunta sa remote server:

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

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 mcp-remote --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 kailangan ng bridge. Ginagamit ng Claude Code ang Maguyva plugin (/plugin install maguyva@maguyva), at direktang kumokonekta ang Cursor, VS Code, Windsurf, at Zed sa remote server gamit ang Bearer header (sa Zed, via context_servers). Para lang ang bridge sa mga client na walang native remote-header support, tulad ng OAuth-only connectors ng Claude Desktop.

Hindi nahanap ang repository#

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

Mga isyu sa MCP connection#

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

I-verify ang ayos#

Pagkatapos ng anumang pagbabago, itanong sa agent mo ang "Anong mga repository ang naka-connect sa akin?" — 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.