Przejdź do głównej treści

Jak zainstalować i używać Augment Context Engine MCP

BlogsAugmentMCPCursorClaudeOkoło 4 minut

Jak zainstalować i używać Augment Context Engine MCP

Augment Context Engine MCP dodaje korporacyjne wyszukiwanie kodu do nowoczesnych agentów AI. Gdy Model Context Protocol (MCP) server działa lokalnie, narzędzia takie jak Cursor, Claude Code, Zed czy GitHub Copilot mogą prosić Augment o precyzyjne wyszukiwanie kodu, sprawiając, że Twój asystent jest osadzony w konkretnym projekcie. Ten przewodnik przeprowadzi Cię przez instalację, konfigurację i codzienne użytkowanie, abyś mógł szybciej wprowadzać funkcje.

Dlaczego warto wybrać Augment Context Engine MCP?

  • Głęboka znajomość projektu – Augment buduje indeks wyszukiwania multi-repozytoryjnego, więc zapytania takie jak „Gdzie inicjujemy Stripe?” od razu zwracają właściwe pliki.
  • Kompatybilność MCP – Każdy klient obsługujący MCP (Cursor, Claude Desktop, Gemini CLI itd.) może łączyć się z tym samym serwerem. Nie potrzebujesz nowych wtyczek.
  • Bezpieczny przepływ uwierzytelniania – Możesz polegać na sesji logowania Auggie CLI lub wstrzyknąć tokent dostępu z odpowiednim zakresem przez AUGMENT_SESSION_AUTH.
  • Narzędzia multiplatformowe – Działa na macOS, Windows i Linux. Serwer komunikuje się przez stdio, co sprawia, że jest niezależny od edytora.

Wymagania wstępne

  1. Node.js 18+, aby zainstalować Auggie CLI (npm lub npx).
  2. Konto Augment z dostępem do Context Engine. Zarejestruj się na Augment i zweryfikuj swoje środowisko pracy.
  3. Obsługiwany klient MCP, np. Cursor, Claude Code/Desktop, Zed lub GitHub Copilot.

Krok 1: Zainstaluj Auggie CLI

Augment dostarcza serwer MCP jako część Auggie CLI. Zainstaluj wersję prerelease globalnie:

npm install -g @augmentcode/auggie@prerelease

Sprawdź instalację:

auggie --version

Aktualizowanie CLI zapewnia dostęp do ulepszeń protokołu i nowych narzędzi do wyszukiwania.

Krok 2: Zaloguj się do Augment

Zaloguj się przez przeglądarkę, aby CLI mogło wysyłać podpisane zapytania:

auggie login

Polecenie otworzy okno OAuth Augment. Po uwierzytelnieniu CLI zapisze lokalną sesję, której użyje serwer MCP. Jeśli potrzebujesz ustawienia przyjaznego CI, wyeksportuj token:

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

Wskazówka: Nigdy nie zamieszczaj tokenów w git. Preferuj eksporty w terminalu, pliki .env dodane do .gitignore lub menedżery sekretów.

Krok 3: Uruchom serwer MCP

Auggie CLI udostępnia tryb silnika kontekstowego:

auggie --mcp -m default -w "${WORKSPACE_FOLDER_PATHS%%,*}"
  • -m default wybiera Twój profil modelu Augment.
  • -w wskazuje pierwszą ścieżkę katalogu roboczego, aby serwer mógł odzwierciedlić strukturę projektu.

Gdy klient połączy się przez MCP, Auggie indeksuje pliki przyrostowo i oferuje narzędzia takie jak codebase-retrieval czy query_codebase.

Krok 4: Skonfiguruj swojego klienta MCP

Cursor IDE

  1. Otwórz Settings › Tools & MCP → Nowy serwer MCP.
  2. Wklej snippet JSON dopasowany do Twojego systemu operacyjnego:

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. Uruchom ponownie Cursor. Powinieneś zobaczyć codebase-retrieval w palecie narzędzi MCP.

Claude Code / Claude Desktop

  1. Edytuj konfigurację Claude (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json).
  2. Dodaj wpis serwera Augment:
{
  "mcpServers": {
    "augment-context-engine": {
      "command": "npx",
      "args": ["-y", "auggie-context-mcp@latest"],
      "env": {
        "AUGMENT_SESSION_AUTH": "{\"accessToken\":\"your-token\",\"tenantURL\":\"https://...\"}"
      }
    }
  }
}
  1. Uruchom ponownie Claude Desktop, aby załadować nowy zestaw narzędzi MCP.

Folder główny środowiska pracy: Claude Code potrzebuje ścieżki do root repozytorium, aby serwer indeksował właściwe pliki. Skonfiguruj ją w Claude Code Settings › Workspace Root w IDE.

Krok 5: Przetestuj integrację

W swoim IDE obsługującym MCP wykonaj proste zapytanie:

„Co ten projekt robi? Proszę użyj narzędzia codebase retrieval.”

Powinieneś zobaczyć, jak agent wywołuje codebase-retrieval, strumieniuje fragmenty z kontekstem i odpowiada z cytatami. Jeśli narzędzie jest niedostępne, sprawdź wyjście CLI pod kątem błędów takich jak:

  • Auggie CLI not found → upewnij się, że binarka jest w PATH.
  • Authentication required → ponownie uruchom auggie login lub odśwież token.
  • Query timed out → pierwsza indeksacja może potrwać dłużej na dużych monorepo; spróbuj ponownie po ukończeniu indeksowania.

Wskazówki do codziennego używania

  • Zadawaj precyzyjne pytania. Zamiast „Gdzie jest auth?” lepiej zapytaj „Pokaż middleware, który waliduje JWT”, aby ograniczyć szumy.
  • Łańcuch narzędzi. Cursor i Claude mogą wywoływać codebase-retrieval, codebase-search i inne narzędzia MCP kolejno, dając Ci iteracyjne odpowiedzi.
  • Projekty multi-repo. Używaj wielu flag -w lub folderów roboczych przy tworzeniu mikroserwisów, aby Augment mapował odwołania między usługami.
  • Tryb offline. W przypadku utraty połączenia CLI wciąż obsługuje lokalne indeksy z pamięci podręcznej, ale odpowiedzi mogą nie uwzględniać najnowszych zmian zdalnych. Po powrocie online wykonaj git pull i uruchom serwer ponownie.

Jak dobry jest Augment Context Engine MCP?

  • Precyzja: Augment skupia się na workflow deweloperów, więc ranking preferuje wykresy wywołań, testy i dokumentację istotną dla zapytania.
  • Szybkość: Serwer MCP niemal natychmiast strumieniuje tokeny do klienta, a kolejne zapytania korzystają z rozgrzanego cache’u.
  • Bezpieczeństwo: Tokeny uwierzytelniające pozostają lokalnie, a transport przez stdio oznacza, że kontrolujesz środowisko uruchomieniowe. Dla zespołów Augment Enterprise wspiera polityki organizacyjne i logi audytu.
  • Wady: Silnik zależy od zarządzanego backendu Augment, więc wymaga aktywnej subskrypcji i dostępu do sieci. Ponadto, ponieważ indeksuje lokalnie, pierwsze uruchomienie na ogromnych monorepo może zająć kilka minut.

W porównaniu do samodzielnych embeddings czy open-source’owych retrieverów, Augment oszczędza czas konfiguracji i od razu integruje się z głównymi agentami IDE. Jeśli korzystasz z Cursor lub Claude, ścieżka MCP jest naturalna.

Lista kontrolna rozwiązywania problemów

ObjawPrawdopodobna przyczynaRozwiązanie
Serwer MCP niewidocznyNieprawidłowa konfiguracja JSONSprawdź przecinki/cudzysłowy, uruchom klienta ponownie
Auggie CLI not foundProblem z PATHZainstaluj CLI ponownie lub dodaj npm global bin do PATH
Błąd uwierzytelnianiaWygasła sesjaauggie login lub odśwież AUGMENT_SESSION_AUTH
Brak narzędzia w IDENieprawidłowy katalog roboczyUpewnij się, że -w wskazuje aktywne repo
Wolne zapytaniaPierwsza indeksacjaPozostaw CLI uruchomione do zakończenia indeksacji

Podsumowanie

Augment Context Engine MCP daje agentom AI do kodowania wiarygodny dostęp do Twojego rzeczywistego kodu. Kilka poleceń w terminalu — instalacja Auggie, logowanie i wklejenie konfiguracji MCP — zapewnia precyzyjne wyszukiwanie, szybsze przeglądy i mniej wymyślanego kodu. Trzymaj serwer uruchomiony razem z IDE i traktuj go jak każdą inną usługę deweloperską: aktualizuj regularnie, monitoruj logi i zabezpieczaj tokeny.

Potrzebujesz niezawodnej infrastruktury do hostowania swoich eksperymentów MCP, usług pomocniczych lub środowisk demo? Sprawdź niedrogie globalne węzły LightNode pod tym linkiem i uruchom VPS w kilka minut.

Oszczędzaj na tanim hostingu VPS