# Pag-aayos ng Problema

Canonical source: https://maguyva.ai/fil/docs/troubleshooting

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Ayusin ang mga karaniwang setup failure ng Maguyva: mga problema sa API key, @maguyva/mcp bridge issues, repository lookups, at connection errors.

### Mga isyu sa API key

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

### Mga isyu sa @maguyva/mcp bridge

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

### 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, tanungin ang agent mo ng "Anong mga repository ang na-connect ko?" -- vine-verify nito ang connection mula umpisa hanggang dulo. Pagkatapos, magtanong ng totoong tanong tungkol sa repo mo; dapat makakita ka ng mga sagot na may file paths at line numbers mula sa naka-connect mong repository.