# 快速入門

Canonical source: https://maguyva.ai/zh-hant/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).

從零到驗證答案最快的路徑：取得金鑰、索引一個你已經熟悉的儲存庫、連接你的用戶端，然後問一個你自己就能評分的問題。

## 1. 取得 API 金鑰

[免費開始](https://app.maguyva.ai)——免信用卡。你的 API 金鑰（以 `mgv_` 開頭）位於 [app.maguyva.ai](https://app.maguyva.ai)。

## 2. 索引一個你已經熟悉的儲存庫

從入口網站連接一個 GitHub 儲存庫，讓它進行索引。選擇一個你能快速檢查的小型儲存庫——這樣一眼就能看出 Maguyva 是否真的讓模型的回答有憑有據，而不是第一天就想索引整間公司。

## 3. 連接你的用戶端

若使用 Claude Code，請從市集安裝 Maguyva 外掛程式——在 Claude Code 內執行以下每個指令：

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

外掛程式會使用 `MAGUYVA_API_KEY` 環境變數中的金鑰進行驗證。請在你的 shell 中設定它（建議依專案使用 `direnv`，因為金鑰是以儲存庫為範圍的）：

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

團隊使用？在 `/plugin install maguyva@maguyva` 開啟的面板中選擇 project 範圍。外掛會記錄到儲存庫的 `.claude/settings.json`，由你提交；每位團隊成員仍需執行一次安裝。工作階段內的 `/plugin` 指令不支援 `--scope` 旗標，所以若要用腳本完成，請從儲存庫根目錄執行 shell 形式：

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

大多數其他用戶端（Cursor、VS Code、Devin Desktop、Zed 等）會直接連接遠端伺服器——只需附上 `Bearer` 標頭指向該端點，無需橋接程式。例如 Cursor 的 `.cursor/mcp.json`：

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

各用戶端的格式略有不同（VS Code 以巢狀結構置於 `servers` 下並使用 `type: "http"`，Antigravity 使用 `serverUrl`，Zed 使用 `context_servers`）。這個 Cursor 範例會從上方所示的 `MAGUYVA_API_KEY` 環境變數讀取金鑰；如果某個用戶端的設定顯示的是 `mgv_xxxx` 預留位置，請將它替換為你的 API 金鑰。接著重新啟動用戶端。全部 23 個附有設定指南的用戶端的確切設定，請參閱 [安裝指南](https://maguyva.ai/zh-hant/docs/installation)。

## 4. 問一個你自己就能評分的問題

先問 **"我連接了哪些儲存庫？"** 確認連線是否成功，接著問一個關於你儲存庫、答案你自己已經知道的真實問題——例如 **"這個程式碼庫是如何處理身份驗證的？"**

你應該會收到附帶檔案路徑與行號的答案。打開引用的檔案，確認答案在實際儲存庫面前站得住腳。這一個經過評分的答案，比任何功能清單都更有說服力——先讓這個工具贏得信任，再讓它加入你的預設工作流程。

沒有結果或出現連線錯誤？請在[疑難排解](https://maguyva.ai/zh-hant/docs/troubleshooting)中檢查 API 金鑰、用戶端設定與儲存庫索引狀態。若使用橋接程式，也請確認 `npx` 可用。

## 後續步驟

- 安裝指南: 全部 23 個用戶端各自的設定說明
- 運作原理: 從你提問到獲得答案之間發生了什麼
- MCP API 參考: 逐一列出每個工具的每個參數