Перейти к основному содержанию

Как установить и использовать Augment Context Engine MCP

BlogsAugmentMCPCursorClaudeОколо 4 мин

Как установить и использовать 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 или вставлять scoped access token через AUGMENT_SESSION_AUTH.
  • Кроссплатформенные инструменты – работает на macOS, Windows и Linux. Сервер общается через stdio, что делает его независимым от редактора.

Предварительные требования

  1. Node.js 18+ для установки Auggie CLI (npm или npx).
  2. Аккаунт Augment с доступом к Context Engine. Зарегистрируйтесь на Augment и подтвердите рабочее пространство.
  3. Поддерживаемый 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

Эта команда откроет окно OAuth Augment. После аутентификации CLI сохранит локальную сессию, которую сервер MCP будет использовать повторно. Если нужна CI-дружественная настройка, экспортируйте токен:

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

Совет: Никогда не сохраняйте токены в git. Предпочитайте экспорт в терминал, .env файлы в .gitignore или менеджеры секретов.

Шаг 3: Запуск MCP сервера

CLI Auggie предоставляет режим движка контекста:

auggie --mcp -m default -w "${WORKSPACE_FOLDER_PATHS%%,*}"
  • -m default выбирает профиль модели Augment.
  • -w указывает на первый каталог рабочего пространства, чтобы сервер мог отразить структуру проекта.

Когда клиент подключается через MCP, Auggie постепенно индексирует файлы и предлагает инструменты, такие как codebase-retrieval или query_codebase.

Шаг 4: Настройка вашего MCP клиента

Cursor IDE

  1. Откройте Settings › Tools & MCP → New MCP Server.
  2. Вставьте 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
    }
  }
}
  1. Перезапустите Cursor. Теперь в палитре MCP инструментов должен появиться codebase-retrieval.

Claude Code / Claude Desktop

  1. Отредактируйте конфигурацию Claude (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json).
  2. Добавьте запись сервера Augment:
{
  "mcpServers": {
    "augment-context-engine": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token\",\"tenantURL\":\"https://...\"}"
      }
    }
  }
}
  1. Перезапустите Claude Desktop для загрузки нового набора MCP инструментов.

Корень рабочего пространства: Claude Code требует путь к корню репозитория, чтобы сервер индексировал правильные файлы. Настройте это в Claude Code Settings › Workspace Root внутри IDE.

Шаг 5: Проверьте интеграцию

В вашем IDE с поддержкой MCP выполните простой запрос:

"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 → первая индексация может занять время на больших монорепозиториях; попробуйте повторно после завершения.

Советы по повседневному использованию

  • Задавайте точные вопросы. Вместо «Где авторизация?» спросите «Покажи middleware, проверяющий JWT», чтобы сократить лишние данные.
  • Последовательное использование инструментов. Cursor и Claude могут последовательно вызывать codebase-retrieval, codebase-search и другие MCP инструменты, давая итеративные ответы.
  • Мульти-репозиторные проекты. Используйте несколько флагов -w или папок рабочего пространства при разработке микросервисов, чтобы Augment отображал ссылки между сервисами.
  • Работа офлайн. Если связь потеряна, CLI продолжит обслуживать кешированные индексы, но ответы могут не содержать последних изменений. После восстановления сети выполните git pull и перезапустите сервер.

Насколько хорош Augment Context Engine MCP?

  • Точность: Augment ориентирован на рабочие процессы разработчиков, поэтому ранжирование учитывает графы вызовов, тесты и документацию, релевантные запросу.
  • Скорость: MCP сервер почти сразу стримит токены клиенту, а последующие запросы используют уже прогретый кеш.
  • Безопасность: Токены аутентификации остаются локальными, а транспорт stdio дает полный контроль над окружением. Для команд в наличии политики предприятия и логи аудита в Augment Enterprise.
  • Недостатки: Движок зависит от управляемого backend Augment, поэтому нужен активный тариф и доступ в сеть. Кроме того, первая индексация крупных монорепозиториев может занять несколько минут.

В сравнении с самостоятельным созданием embeddings или open-source ретриверами, Augment экономит время на настройку и сразу интегрируется с основными IDE-агентами. Если вы уже используете Cursor или Claude, MCP-путь ощущается нативным.

Список проверок при возникновении проблем

СимптомВозможная причинаРешение
MCP сервер не виденНекорректный JSONПроверьте запятые/кавычки, перезапустите клиент
Auggie CLI not foundПроблемы с PATHПереустановите CLI или добавьте глобальную папку npm в PATH
Ошибка аутентификацииПросроченная сессияВыполните auggie login или обновите AUGMENT_SESSION_AUTH
Недостающий инструмент в IDEНесовпадение рабочего пространстваУбедитесь, что -w указывает на активный репозиторий
Медленные запросыИндексация впервыеОставьте CLI запущенным до завершения индексации

Заключение

Augment Context Engine MCP предоставляет AI-агентам по кодированию надежный доступ к вашей реальной кодовой базе. Несколькими командами в терминале — установите Auggie, войдите в систему и вставьте MCP конфигурацию — вы получаете точный поиск, ускоренные ревью и меньше «галлюцинаций» кода. Держите сервер запущенным рядом с вашей IDE и относитесь к нему как к любому другому сервису разработки: регулярно обновляйте, следите за логами и обеспечивайте безопасность токенов.

Нужна надежная инфраструктура для запуска ваших MCP экспериментов, вспомогательных сервисов или демонстрационных окружений? Ознакомьтесь с доступными глобальными нодами LightNode по этой ссылке и разверните VPS за считанные минуты.

Сэкономьте на дешевом VPS-хостинге。