# Gabay sa Pag-install

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

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

Maka-set up ka nang wala pang 5 minuto. Kasama sa gabay na ito ang setup para sa 23 MCP clients kabilang ang Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, at Warp, at marami pang iba.

**Kailangan muna**: Kakailanganin mo ng API key mula sa [app.maguyva.ai](https://app.maguyva.ai) at isang connected na GitHub repository.

## Pag-setup ng Environment

Una, itakda ang iyong API key sa isang environment variable. Alisin ang `repository` kapag nagbibigay ang iyong MCP client ng request default o eksaktong isang repository lang ang maa-access ng key; kung hindi, tahasan itong ipasa.

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Palitan ang `mgv_xxxx` ng iyong aktwal na API key mula sa [app.maguyva.ai](https://app.maguyva.ai).

## Configuration ng Client

Piliin ang iyong MCP client sa ibaba para sa specific na setup instructions.

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Gumagamit ang Maguyva ng standard MCP. Anumang client na sumusuporta sa protocol ay maaaring mag-connect — kahit walang first-party guide sa itaas. 23 clients ang naka-document, dumadagdag pa nang regular.

## I-validate ang Iyong Setup

Pagkatapos mag-connect, subukang magtanong sa iyong agent ng ilang tanong:

- "Anong mga repository ang na-connect ko?" — vine-verify kung gumagana ang connection
- "Paano hinahandle ang authentication sa codebase na ito?" — sinusubok ang semantic search
- "Hanapin ang lahat ng function na tumatawag sa database" — sinusubok ang dependency search
- "Saan nakadepende ang UserService class?" — sinusubok ang symbol lookup

Dapat makakita ka ng resulta na may file paths at line numbers mula sa iyong connected repository. Kung hindi, tingnan ang [troubleshooting](https://maguyva.ai/fil/docs/troubleshooting) sa ibaba.

## Format ng Repository

Kapag nagsa-specify ng mga repository:

- May branch: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Default na branch: `"owner/repo"`

**Tip**: Gamitin ang `repository_context(action="info", repository="...")` para suriin ang pag-resolve ng repository. Ang tahasang pagpili ng repository ay para lamang sa kasalukuyang tawag.

## Pag-aayos ng Problema

### Mga Isyu sa API Key

- I-verify na nagsisimula ang key mo sa mgv_ prefix
- Tsekin kung tama ang pagkaka-set ng key sa environment mo
- Siguraduhing hindi pa expired ang key

### Hindi Nahanap ang Repository

- I-verify na naka-connect ang repository sa app.maguyva.ai
- Tsekin kung tama ang format na owner/repo
- Siguraduhing may access ka sa repository

### Mga Isyu sa MCP Connection

- Kung ginagamit ng iyong client ang bridge na @maguyva/mcp, tiyaking available ang npx sa iyong PATH
- Tsekin kung valid at hindi pa expired ang API token mo
- Subukan ang connectivity papunta sa https://maguyva.tools/mcp
- Tsekin ang MCP configuration syntax ng client mo

## Mga Susunod na Hakbang

- Sanggunian sa MCP API: Kumpletong dokumentasyon ng API
- Paano Ito Gumagana: Unawain ang context optimization
- Pag-troubleshoot: Ayusin ang mga isyu sa setup at connection