如何安裝並使用 Augment Context Engine MCP

大约 6 分鐘

如何安裝並使用 Augment Context Engine MCP

Augment 的 Context Engine MCP 將企業級的程式碼搜尋功能整合進現代 AI 代理。只要在本機啟動 Model Context Protocol (MCP) 伺服器，像是 Cursor、Claude Code、Zed 或 GitHub Copilot 等工具，即可向 Augment 請求精確的程式碼檢索，讓你的助理能依據真實專案內容提供回應。本指南將帶你完成安裝、設定及日常使用，幫助你更快交付功能。

為什麼選擇 Augment Context Engine MCP？

深度專案感知 – Augment 建立多儲存庫的搜尋索引，像是「我們在哪初始化 Stripe？」這類查詢能立即回傳正確檔案。
MCP 相容性 – 任何 MCP 支援的用戶端（Cursor、Claude Desktop、Gemini CLI 等）都能呼叫同一伺服器，無需新增外掛。
安全的驗證流程 – 你可以依賴 Auggie CLI 的登入會話，或透過 AUGMENT_SESSION_AUTH 注入範圍存取權杖。
跨平台工具 – 支援 macOS、Windows 及 Linux，伺服器透過 stdio 通訊，不綁定任何特定編輯器。

先決條件

Node.js 18+，以便安裝 Auggie CLI（使用 npm 或 npx）。
Augment 帳號，並有使用 Context Engine 的權限。請在 Augment 註冊並驗證工作區。
支援 MCP 的用戶端，如 Cursor、Claude Code/Desktop、Zed 或 GitHub Copilot。

步驟 1：安裝 Auggie CLI

Augment 將 MCP 伺服器包裝於 Auggie CLI 中。請全域安裝預發布版本：

npm install -g @augmentcode/auggie@prerelease

確認安裝成功：

auggie --version

持續更新 CLI 可確保你獲得協議改進及新檢索工具。

步驟 2：使用 Augment 進行驗證

透過瀏覽器登入，讓 CLI 取得簽署的請求權限：

auggie login

此指令會開啟 Augment OAuth 視窗。完成驗證後，CLI 會儲存本機會話，MCP 伺服器會重複使用。如需 CI 友善設定，可改以匯出權杖：

auggie token print
export AUGMENT_SESSION_AUTH='{"accessToken":"...","tenantURL":"https://tenant.augmentcode.com","scopes":["read","write"]}'

提示： 請勿將令牌提交至 git。建議用終端匯出、置於 .gitignore 的 .env 檔，或使用秘密管理工具。

步驟 3：執行 MCP 伺服器

Auggie CLI 提供 context engine 模式：

auggie --mcp -m default -w "${WORKSPACE_FOLDER_PATHS%%,*}"

-m default 代表選擇你的 Augment 模型設定檔。
-w 指定第一個工作區資料夾路徑，讓伺服器能映射專案樹狀結構。

用戶端透過 MCP 連線時，Auggie 會增量索引檔案，並提供 codebase-retrieval 或 query_codebase 等工具。

步驟 4：設定你的 MCP 用戶端

Cursor IDE

開啟 Settings › Tools & MCP → New MCP Server。
貼上符合你作業系統的 JSON 設定：

macOS / Linux (bash)：

{
  "mcpServers": {
    "augment-context-engine": {
      "type": "local",
      "command": "bash",
      "args": ["-c", "auggie --mcp -m default -w \"${WORKSPACE_FOLDER_PATHS%%,*}\""] ,
      "enabled": true
    }
  }
}

Windows (PowerShell)：

{
  "mcpServers": {
    "augment-context-engine": {
      "type": "local",
      "command": "powershell",
      "args": ["-Command", "auggie --mcp -m default -w \"($env:WORKSPACE_FOLDER_PATHS -split ',')[0]\""],
      "enabled": true
    }
  }
}

重新啟動 Cursor，應可在 MCP 工具列看到 codebase-retrieval。

Claude Code / Claude Desktop

編輯 Claude 設定檔（macOS：~/Library/Application Support/Claude/claude_desktop_config.json，Windows：%APPDATA%/Claude/claude_desktop_config.json）。
新增 Augment 伺服器條目：

{
  "mcpServers": {
    "augment-context-engine": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token\",\"tenantURL\":\"https://...\"}"
      }
    }
  }
}

重新啟動 Claude Desktop 以載入新的 MCP 工具組。

工作區根目錄： Claude Code 需要知道儲存庫根路徑，確保伺服器索引正確檔案。可在 IDE 裡的 Claude Code Settings › Workspace Root 設定。

步驟 5：測試整合狀況

在支援 MCP 的 IDE 內執行簡易檢索指令：

"What does this project do? Please use the codebase retrieval tool."

你應該會看到代理呼叫 codebase-retrieval，串流帶有豐富上下文的程式碼片段，並附上引用回答。如果找不到工具，請檢查 CLI 輸出是否有錯誤，例如：

Auggie CLI not found → 確認可執行檔是否在 PATH。
Authentication required → 重新執行 auggie login 或更新權杖。
Query timed out → 首次索引大型 monorepo 可能較久，等待完成後再試。

日常使用技巧

提問具體。 與其問「auth 在哪？」，不如說「請顯示驗證 JWT 的中介軟體」，以減少雜訊。
串接工具。 Cursor 與 Claude 能連續呼叫 codebase-retrieval、codebase-search 等 MCP 工具，提供你逐步完善的答案。
多儲存庫專案。 開發微服務時可用多個 -w 標記或多個工作區資料夾，讓 Augment 映射跨服務參考。
離線回退。 若斷線，CLI 會繼續提供緩存索引，但可能無法反映最新遠端變更。恢復連線後，請執行 git pull 並重啟伺服器。

Augment Context Engine MCP 的表現如何？

準確度： Augment 聚焦開發者工作流程，排序時優先考量呼叫圖、測試及與查詢相關的文件。
速度： MCP 伺服器幾乎立即串流 token 給用戶端，後續查詢會重複利用已熱身的快取。
安全性： 認證令牌僅保留本機，stdio 傳輸讓你掌控執行環境。團隊使用時，Augment Enterprise 支援組織政策及審計日誌。
缺點： 引擎依賴 Augment 管理後端，需有效訂閱與網路連線。此外，因在本機索引，巨型 monorepo 首次執行可耗費數分鐘。

與 DIY embeddings 或開源檢索器相比，Augment 節省設定時間，且可直接與主流 IDE 代理整合。如果你已經在用 Cursor 或 Claude，MCP 的體驗會非常自然。

疑難排解清單

症狀	可能原因	解決方式
MCP 伺服器無法顯示	JSON 格式錯誤	檢查逗號/引號，重啟用戶端
找不到 Auggie CLI	PATH 無效	重新安裝 CLI 或將 npm 全域執行路徑加到 PATH
認證錯誤	會話過期	重新執行 `auggie login` 或更新 `AUGMENT_SESSION_AUTH`
IDE 內缺少工具	工作區路徑不符	確認 `-w` 指向正確儲存庫
查詢很慢	首次索引中	保持 CLI 運行直到索引完成

結論

Augment 的 Context Engine MCP 為 AI 程式碼助理提供可靠的真實代碼庫存取。只需幾條終端指令——安裝 Auggie、登入並貼上 MCP 設定，就能獲得精準檢索、更快的代碼審查以及減少幻覺的程式碼。保持伺服器與 IDE 同步運行，像管理其他開發服務一樣：定期更新、監控日誌並確保令牌安全。

需要可靠基礎架構來托管你的 MCP 實驗、輔助服務或示範環境？可探索 LightNode 提供的經濟型全球節點，透過此連結幾分鐘內快速啟動 VPS。