# Mabilisang Simula

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

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

Ang pinakamabilis na daan mula zero hanggang sa verified na sagot: kumuha ng key, i-index ang isang repository na kilala mo na, i-connect ang iyong client, at magtanong ng isang tanong na kaya mo nang i-grade.

## 1. Kumuha ng API key

[Magsimula nang libre](https://app.maguyva.ai) — walang kailangang credit card. Nasa [app.maguyva.ai](https://app.maguyva.ai) ang iyong API key (nagsisimula ito sa `mgv_`).

## 2. I-index ang isang repository na kilala mo na

I-connect ang isang GitHub repository mula sa portal at hayaan itong mag-index. Pumili ng maliit na repo na mabilis mong ma-sanity-check — para malinaw agad kung talagang bina-ground ng Maguyva ang model, sa halip na subukang i-index ang buong kumpanya mo sa unang araw.

## 3. I-connect ang iyong client

Para sa Claude Code, i-install ang Maguyva plugin mula sa marketplace — patakbuhin ang bawat command sa loob ng Claude Code:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

Nag-a-authenticate ang plugin gamit ang key mo mula sa `MAGUYVA_API_KEY` environment variable. I-set ito sa iyong shell (rekomendado ang per-project `direnv`, dahil repository-scoped ang mga key):

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

Nagtatrabaho kasama ang team? Piliin ang project scope sa panel na binubuksan ng `/plugin install maguyva@maguyva`. Itinatala nito ang plugin sa `.claude/settings.json` ng repository, na iko-commit mo; kailangan pa ring patakbuhin ng bawat teammate ang install nang isang beses. Walang `--scope` flag ang mga in-session na `/plugin` command, kaya para i-script ito, patakbuhin ang shell form mula sa root ng repository:

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

Karamihan sa ibang client (Cursor, VS Code, Devin Desktop, Zed, at mga katulad) direktang kumokonekta sa remote server — ituro lang sila sa endpoint gamit ang `Bearer` header, walang kailangang bridge. Halimbawa, ang `.cursor/mcp.json` ng Cursor:

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

Medyo naiiba ang shape depende sa client (naka-nest ang VS Code sa ilalim ng `servers` gamit ang `type: "http"`, ginagamit ng Antigravity ang `serverUrl`, ginagamit ng Zed ang `context_servers`). Binabasa ng Cursor example na ito ang key mo mula sa `MAGUYVA_API_KEY` environment variable na ipinakita sa itaas; kung ang config ng isang client ay nagpapakita ng `mgv_xxxx` placeholder sa halip, palitan iyon ng API key mo. Pagkatapos, i-restart ang client mo. Nasa [Gabay sa Pag-install](https://maguyva.ai/fil/docs/installation) ang eksaktong config para sa lahat ng 23 na naka-document na client.

## 4. Magtanong ng isang tanong na kaya mo nang i-grade

Magsimula sa **"Anong mga repository ang na-connect ko?"** para i-confirm ang connection, tapos magtanong ng isang totoong tanong tungkol sa repo mo na alam mo na ang sagot — halimbawa **"Paano hinahandle ang authentication sa codebase na ito?"**

Dapat makakuha ka ng mga sagot na may file paths at line numbers. Buksan ang mga cited file at tingnan kung talagang tama ang sagot laban sa aktwal na repo. Mas marami kang malalaman sa isang graded answer na iyon kaysa sa kahit anong feature list — patunayan muna ng tool na deserve nito ang tiwala mo bago ito sumali sa default loop mo.

Walang resulta o may error sa koneksyon? Tingnan ang iyong API key, configuration ng client, at status ng pag-index ng repository sa [Pag-aayos ng Problema](https://maguyva.ai/fil/docs/troubleshooting). Kung gumagamit ng bridge ang setup mo, tiyakin ding available ang `npx`.

## Mga susunod na hakbang

- Gabay sa Pag-install: config kada client para sa lahat ng 23 na naka-document na client
- Paano Ito Gumagana: ano ang nangyayari sa pagitan ng tanong mo at ng sagot
- Sanggunian ng MCP API: bawat tool, parameter kada parameter