如何安装和使用 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。

第一步：安装 Auggie CLI

Augment 将 MCP 服务器作为 Auggie CLI 的一部分发布。全局安装预发布包：

npm install -g @augmentcode/auggie@prerelease

验证安装是否成功：

auggie --version

保持 CLI 更新可确保您获得协议改进和新检索工具。

第二步：通过 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 文件或使用秘密管理工具。

第三步：启动 MCP 服务器

Auggie CLI 提供上下文引擎模式：

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

-m default 选择您的 Augment 模型配置文件。
-w 指定第一个工作区文件夹，让服务器镜像您的项目结构。

当客户端通过 MCP 连接时，Auggie 会增量编制文件索引，并提供如 codebase-retrieval 或 query_codebase 的功能。

第四步：配置您的 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 配置。

第五步：测试集成

在您的 MCP 支持的 IDE 中，执行简单的检索提示：

"这个项目是做什么的？请使用代码库检索工具。"

您应该能看到代理调用 codebase-retrieval，流式返回上下文丰富的代码片段，并带有引用。如果工具缺失，请检查 CLI 输出是否有如下错误：

Auggie CLI not found → 确认二进制文件已加入 PATH。
Authentication required → 重新运行 auggie login 或刷新令牌。
Query timed out → 对于大型单仓库，首次索引可能较慢，等待索引完成后重试。

日常使用小贴士

提出精准问题。 与其问“auth 在哪儿？”，不如问“展示验证 JWT 的中间件”，以减少干扰信息。
链式调用工具。 Cursor 和 Claude 能顺序调用 codebase-retrieval、codebase-search 和其他 MCP 工具，提供迭代式答案。
多仓库项目。 开发微服务时可使用多个 -w 参数或工作区文件夹，让 Augment 绘制跨服务引用关系。
离线回退。 断网时，CLI 会继续提供缓存索引，但响应可能缺少最新远程变更。恢复网络后请执行 git pull 并重启服务器。

Augment Context Engine MCP 质量如何？

精准性： Augment 关注开发者工作流，排名优先考虑调用图、测试和与查询相关的文档。
速度： MCP 服务器几乎即时流式传输令牌，后续查询复用已加载缓存。
安全性： 认证令牌仅存本地，stdio 传输让你掌控运行环境。团队用户可用 Augment Enterprise 支持组织级策略和审计日志。
不足： 引擎依赖 Augment 管理后端，需要订阅和网络访问；首轮针对超大单仓库的本地索引可能耗时几分钟。

相比自行搭建 embeddings 或开源检索器，Augment 节省安装配置时间，并开箱即用支持主流 IDE 代理。如果您已经使用 Cursor 或 Claude，MCP 方式体验非常自然。

排查清单

现象	可能原因	解决方案
MCP 服务器不可见	JSON 配置错误	校验逗号/引号，重启客户端
`Auggie CLI not found`	PATH 配置问题	重新安装 CLI 或添加 npm 全局 bin 至 PATH
认证错误	会话过期	运行 `auggie login` 或刷新 `AUGMENT_SESSION_AUTH`
IDE 内工具缺失	工作区路径错误	确认 `-w` 指向活动仓库
查询缓慢	首次索引中	保持 CLI 运行直至索引完成

总结

Augment 的 Context Engine MCP 为 AI 编码助手提供了可信赖的真实代码库访问能力。只需几条终端命令——安装 Auggie、登录、粘贴 MCP 配置，您即可享受精准检索、更快代码审查和更少幻觉代码。让服务器常驻于 IDE 旁，像对待其他开发服务一样：定期更新、监控日志、保护令牌安全。

需要可靠基础设施托管您的 MCP 实验、辅助服务或演示环境？探索 LightNode 提供的全球廉价节点，点击这里数分钟即可启动 VPS。