跳至主要內容

快速入門

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

1. 取得 API 金鑰

#

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

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

#

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

3. 連接你的用戶端

#

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

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

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

export MAGUYVA_API_KEY=mgv_xxxx

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

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：

.cursor/mcp.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 個附有設定指南的用戶端的確切設定，請參閱 安裝指南。

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

#

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

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

沒有結果或出現連線錯誤？請在疑難排解中檢查 API 金鑰、用戶端設定與儲存庫索引狀態。若使用橋接程式，也請確認 npx 可用。

後續步驟

#

相關

延伸閱讀