跳至主要內容

快速入門

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

1. 取得 API 金鑰#

免費開始——免信用卡。您的 API 金鑰（以 mgv_ 開頭）位於 app.maguyva.ai。

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

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

3. 連接您的客戶端#

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

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

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

export MAGUYVA_API_KEY=mgv_xxxx

團隊協作？在兩個 /plugin 指令中加上 --scope project，把外掛程式提交到儲存庫的 .claude/settings.json，讓團隊成員自動取得它。

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

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

各客戶端的格式略有不同（VS Code 嵌套在 servers 下並使用 type: "http"，Windsurf 使用 serverUrl，Zed 使用 context_servers）。將 mgv_xxxx 替換為您的 API 金鑰，然後重新啟動客戶端。全部 24 個已記載客戶端的確切設定，請參閱 安裝指南。

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

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

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

沒有結果，或出現連線錯誤？請前往 疑難排解——大多數失敗原因是未設定 API 金鑰、缺少 npx，或儲存庫尚未完成索引。

後續步驟#