Bỏ qua nội dung chính

Cách Cài Đặt và Sử Dụng Augment Context Engine MCP

BlogsAugmentMCPCursorClaudeKhoảng 6 phút

Cách Cài Đặt và Sử Dụng Augment Context Engine MCP

Augment's Context Engine MCP tích hợp tìm kiếm mã cấp doanh nghiệp vào các tác nhân AI hiện đại. Khi máy chủ Model Context Protocol (MCP) đang chạy cục bộ, các công cụ như Cursor, Claude Code, Zed hoặc GitHub Copilot có thể yêu cầu Augment để truy xuất mã chính xác, giúp trợ lý của bạn bám sát dự án thực tế. Hướng dẫn này sẽ đưa bạn qua các bước cài đặt, cấu hình và sử dụng hàng ngày để bạn có thể bắt đầu phát hành tính năng nhanh hơn.

Tại Sao Chọn Augment Context Engine MCP?

  • Nhận biết dự án sâu sắc – Augment xây dựng chỉ mục tìm kiếm đa-repo, nên những truy vấn như "Chúng ta khởi tạo Stripe ở đâu?" sẽ trả về đúng file ngay lập tức.
  • Tương thích MCP – Bất kỳ client hỗ trợ MCP nào (Cursor, Claude Desktop, Gemini CLI, v.v.) đều có thể gọi đến cùng một máy chủ. Không cần plugin mới.
  • Quy trình xác thực an toàn – Bạn có thể dựa vào phiên đăng nhập Auggie CLI hoặc chèn token truy cập có phạm vi qua AUGMENT_SESSION_AUTH.
  • Công cụ đa nền tảng – Hoạt động trên macOS, Windows và Linux. Máy chủ giao tiếp qua stdio, làm cho nó không phụ thuộc vào trình soạn thảo.

Yêu Cầu Tiền Đề

  1. Node.js 18+ để bạn có thể cài đặt Auggie CLI (npm hoặc npx).
  2. Tài khoản Augment có quyền truy cập vào Context Engine. Đăng ký tại Augment và xác thực workspace của bạn.
  3. Client hỗ trợ MCP như Cursor, Claude Code/Desktop, Zed, hoặc GitHub Copilot.

Bước 1: Cài Đặt Auggie CLI

Augment cung cấp máy chủ MCP như một phần của Auggie CLI. Cài đặt gói tiền phát hành toàn cục:

npm install -g @augmentcode/auggie@prerelease

Xác thực việc cài đặt:

auggie --version

Giữ CLI cập nhật đảm bảo bạn nhận được các cải tiến giao thức và công cụ truy xuất mới.

Bước 2: Xác Thực với Augment

Đăng nhập bằng trình duyệt để CLI có thể phát hành các yêu cầu được ký:

auggie login

Lệnh này sẽ mở cửa sổ OAuth của Augment. Khi xác thực thành công, CLI lưu một phiên bản cục bộ mà máy chủ MCP sẽ tái sử dụng. Nếu bạn cần cấu hình thân thiện với CI, thay vào đó xuất token:

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

Mẹo: Không bao giờ commit token lên git. Ưu tiên export trên terminal, file .env trong .gitignore, hoặc quản lý qua secret manager.

Bước 3: Chạy Máy Chủ MCP

Auggie CLI cung cấp chế độ context engine:

auggie --mcp -m default -w "${WORKSPACE_FOLDER_PATHS%%,*}"
  • -m default chọn hồ sơ mô hình Augment của bạn.
  • -w trỏ đến thư mục workspace đầu tiên để máy chủ có thể phản chiếu cây thư mục dự án của bạn.

Khi client kết nối qua MCP, Auggie lập chỉ mục file một cách tăng dần và cung cấp các công cụ như codebase-retrieval hoặc query_codebase.

Bước 4: Cấu Hình Client MCP Của Bạn

Cursor IDE

  1. Mở Settings › Tools & MCP → New MCP Server.
  2. Dán đoạn JSON phù hợp với hệ điều hành của bạn:

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
    }
  }
}
  1. Khởi động lại Cursor. Bạn sẽ thấy codebase-retrieval trong bộ công cụ MCP.

Claude Code / Claude Desktop

  1. Chỉnh sửa cấu hình Claude (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json).
  2. Thêm mục máy chủ Augment:
{
  "mcpServers": {
    "augment-context-engine": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token\",\"tenantURL\":\"https://...\"}"
      }
    }
  }
}
  1. Khởi động lại Claude Desktop để tải bộ công cụ MCP mới.

Thư mục gốc workspace: Claude Code cần đường dẫn gốc repo để máy chủ lập chỉ mục đúng file. Cấu hình trong Claude Code Settings › Workspace Root trong IDE.

Bước 5: Kiểm Tra Tích Hợp

Trong IDE có hỗ trợ MCP, chạy truy vấn lấy dữ liệu đơn giản:

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

Bạn sẽ thấy tác nhân gọi codebase-retrieval, phát luồng các đoạn mã giàu ngữ cảnh, và trả lời với trích dẫn. Nếu công cụ bị thiếu, kiểm tra đầu ra CLI lỗi như:

  • Auggie CLI not found → đảm bảo nhị phân có trong PATH.
  • Authentication required → chạy lại auggie login hoặc làm mới token.
  • Query timed out → lần lập chỉ mục đầu tiên với monorepo lớn có thể lâu; thử lại khi xong.

Mẹo Sử Dụng Hàng Ngày

  • Hỏi câu hỏi chính xác. Thay vì "Auth ở đâu?" hãy hỏi "Cho tôi middleware kiểm tra JWT" để giảm nhiễu.
  • Chuỗi công cụ. Cursor và Claude có thể gọi codebase-retrieval, codebase-search, và các công cụ MCP khác tuần tự, cho câu trả lời dần dần.
  • Dự án đa repo. Dùng nhiều flag -w hoặc thư mục workspace khi phát triển microservices để Augment ánh xạ tham chiếu chéo dịch vụ.
  • Chế độ offline. Nếu mất kết nối, CLI vẫn phục vụ chỉ mục cache, nhưng câu trả lời có thể thiếu cập nhật mới. Chạy git pull và khởi động lại máy chủ khi có mạng lại.

Augment Context Engine MCP Tốt Như Thế Nào?

  • Độ chính xác: Augment tập trung vào quy trình làm việc của dev, nên xếp hạng ưu tiên dựa trên call graph, test và tài liệu liên quan đến truy vấn.
  • Tốc độ: Máy chủ MCP phát token về client gần như ngay lập tức, và truy vấn tiếp theo tái sử dụng cache đã nóng.
  • Bảo mật: Token xác thực giữ cục bộ, giao tiếp stdio có nghĩa bạn kiểm soát môi trường runtime. Với đội nhóm, Augment Enterprise hỗ trợ chính sách toàn tổ chức và nhật ký kiểm toán.
  • Hạn chế: Bộ máy phụ thuộc backend được quản lý của Augment, nên bạn cần đăng ký và mạng hoạt động. Thêm nữa, vì lập chỉ mục cục bộ, lần chạy đầu trên monorepo khổng lồ có thể tốn vài phút.

So với embeddings tự làm hoặc trình truy xuất mã nguồn mở, Augment tiết kiệm thời gian thiết lập và tích hợp sẵn với các tác nhân IDE lớn. Nếu bạn đã dùng Cursor hay Claude, đường đi MCP rất thân thuộc.

Bảng Kiểm Tra Khắc Phục Sự Cố

Triệu chứngNguyên nhân có thểCách sửa
Máy chủ MCP không nhìn thấyJSON cấu hình saiKiểm tra dấu phẩy/dấu ngoặc, khởi động lại client
Auggie CLI not foundVấn đề PATHCài lại CLI hoặc thêm npm global bin vào PATH
Lỗi xác thựcPhiên hết hạnauggie login hoặc làm mới AUGMENT_SESSION_AUTH
Công cụ mất trong IDESai workspaceXác nhận -w trỏ đúng repo đang dùng
Truy vấn chậmLập chỉ mục lần đầuĐể CLI chạy đến khi xong lập chỉ mục

Kết Luận

Augment's Context Engine MCP mang lại cho các tác nhân AI coding khả năng truy cập tin cậy vào codebase thực của bạn. Với vài lệnh terminal—cài Auggie, đăng nhập, dán cấu hình MCP—bạn có truy xuất chính xác, đánh giá nhanh hơn, và giảm mã ảo. Giữ máy chủ chạy song song IDE như một dịch vụ phát triển khác: cập nhật thường xuyên, giám sát log, và bảo mật token.

Cần hạ tầng đáng tin cậy để chạy thử nghiệm MCP, dịch vụ phụ trợ, hoặc môi trường demo? Khám phá nút toàn cầu giá hợp lý của LightNode tại this link và tạo VPS chỉ trong vài phút.

Tập trung giới thiệu máy chủ VPS toàn cầu.