Cómo instalar y usar Augment Context Engine MCP

Alrededor de 4 min

Cómo instalar y usar Augment Context Engine MCP

El Context Engine MCP de Augment conecta la búsqueda de código de nivel empresarial con agentes modernos de IA. Una vez que el servidor Model Context Protocol (MCP) está corriendo localmente, herramientas como Cursor, Claude Code, Zed o GitHub Copilot pueden pedir a Augment una recuperación precisa de código, manteniendo a tu asistente anclado en el proyecto real. Esta guía te lleva paso a paso por la instalación, configuración y uso diario para que puedas comenzar a entregar funciones más rápido.

¿Por qué elegir Augment Context Engine MCP?

Conocimiento profundo del proyecto – Augment crea un índice de búsqueda multi-repositorio, por lo que consultas como "¿Dónde inicializamos Stripe?" devuelven los archivos correctos al instante.
Compatibilidad MCP – Cualquier cliente compatible con MCP (Cursor, Claude Desktop, Gemini CLI, etc.) puede llamar al mismo servidor. No se requieren nuevos plugins.
Flujo de autenticación seguro – Puedes confiar en la sesión de login de Auggie CLI o inyectar un token de acceso con alcance mediante AUGMENT_SESSION_AUTH.
Herramientas multiplataforma – Funciona en macOS, Windows y Linux. El servidor se comunica vía stdio, haciendo que sea independiente del editor.

Requisitos previos

Node.js 18+ para poder instalar el Auggie CLI (npm o npx).
Cuenta Augment con acceso al Context Engine. Regístrate en Augment y verifica tu espacio de trabajo.
Cliente MCP soportado como Cursor, Claude Code/Desktop, Zed o GitHub Copilot.

Paso 1: Instalar el Auggie CLI

Augment distribuye el servidor MCP como parte del Auggie CLI. Instala el paquete pre-release globalmente:

npm install -g @augmentcode/auggie@prerelease

Verifica la instalación:

auggie --version

Mantener el CLI actualizado asegura que recibas mejoras en el protocolo y nuevas herramientas de recuperación.

Paso 2: Autenticarse con Augment

Inicia sesión con tu navegador para que el CLI pueda emitir solicitudes firmadas:

auggie login

Este comando abrirá una ventana OAuth de Augment. Una vez autenticado, el CLI almacenará una sesión local que el servidor MCP reutilizará. Si necesitas una configuración amigable para CI, exporta un token en su lugar:

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

Consejo: Nunca cometas tokens en git. Prefiere exportarlos en terminal, archivos .env en .gitignore o gestores de secretos.

Paso 3: Ejecutar el servidor MCP

El Auggie CLI expone un modo context engine:

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

-m default selecciona tu perfil de modelo Augment.
-w apunta a la primera carpeta del espacio de trabajo para que el servidor pueda reflejar el árbol del proyecto.

Cuando un cliente se conecta vía MCP, Auggie indexa archivos incrementalmente y ofrece herramientas como codebase-retrieval o query_codebase.

Paso 4: Configurar tu cliente MCP

Cursor IDE

Abre Settings › Tools & MCP → New MCP Server.
Pega el fragmento JSON que corresponde a tu sistema operativo:

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
    }
  }
}

Reinicia Cursor. Ahora deberías ver codebase-retrieval en la paleta de herramientas MCP.

Claude Code / Claude Desktop

Edita la configuración de Claude (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json).
Agrega la entrada del servidor Augment:

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

Reinicia Claude Desktop para cargar el nuevo conjunto de herramientas MCP.

Raíz del espacio de trabajo: Claude Code necesita el path de la raíz del repositorio para que el servidor indexe los archivos correctos. Configúralo en Claude Code Settings › Workspace Root dentro del IDE.

Paso 5: Probar la integración

En tu IDE con MCP habilitado, ejecuta un prompt simple de recuperación:

"¿Qué hace este proyecto? Por favor usa la herramienta de recuperación del codebase."

Deberías ver que el agente llama a codebase-retrieval, transmite fragmentos con contexto y responde con citas. Si falta la herramienta, verifica la salida del CLI para errores como:

Auggie CLI not found → asegúrate que el binario esté en el PATH.
Authentication required → vuelve a ejecutar auggie login o refresca tu token.
Query timed out → la primera construcción del índice puede tardar más en monorepos grandes; reintenta una vez que el indexado termine.

Consejos para el uso diario

Haz preguntas precisas. En vez de "¿Dónde está la auth?" pregunta "Muéstrame el middleware que valida JWTs" para minimizar ruido.
Encadena herramientas. Cursor y Claude pueden invocar codebase-retrieval, codebase-search y otras herramientas MCP secuencialmente, dándote respuestas iterativas.
Proyectos multi-repo. Usa múltiples flags -w o carpetas de espacio de trabajo cuando desarrolles microservicios para que Augment mapee referencias cruzadas.
Modo offline. Si pierdes conectividad, el CLI sigue sirviendo índices cacheados, pero las respuestas pueden no incluir cambios recientes. Ejecuta git pull y reinicia el servidor cuando vuelvas a estar en línea.

¿Qué tan bueno es Augment Context Engine MCP?

Precisión: Augment está enfocado en flujos de trabajo de desarrolladores, por lo que el ranking prioriza gráficos de llamadas, tests y documentación relevantes para tu consulta.
Velocidad: El servidor MCP transmite tokens al cliente casi inmediatamente y las consultas posteriores reutilizan el caché caliente.
Seguridad: Los tokens de autenticación permanecen locales y el transporte stdio te da control del entorno de ejecución. Para equipos, Augment Enterprise soporta políticas organizacionales y logs de auditoría.
Debilidades: El motor depende del backend gestionado por Augment, así que necesitas una suscripción activa y acceso a red. Además, al indexar localmente, la primera ejecución en monorepos gigantes puede tomar varios minutos.

Comparado con embeddings DIY o recuperadores open-source, Augment ahorra tiempo de configuración e integra con los principales agentes IDE desde el primer momento. Si ya usas Cursor o Claude, el camino MCP se siente nativo.

Lista de comprobación para resolver problemas

Síntoma	Causa probable	Solución
Servidor MCP no aparece	JSON mal configurado	Valida comas/comillas, reinicia cliente
`Auggie CLI not found`	Problema en PATH	Reinstala CLI o agrega binario global npm al PATH
Error de autenticación	Sesión expirada	`auggie login` o refresca `AUGMENT_SESSION_AUTH`
Herramienta ausente en IDE	Incompatibilidad de espacio de trabajo	Confirma que `-w` apunta al repo activo
Consultas lentas	Indexación inicial	Deja el CLI corriendo hasta que termine la indexación

Conclusión

Augment Context Engine MCP ofrece a los agentes de código IA un acceso confiable a tu codebase real. Con unos pocos comandos en terminal —instalando Auggie, autenticándote y pegando la configuración MCP— obtienes recuperaciones precisas, revisiones más rápidas y menos código alucinado. Mantén el servidor corriendo junto a tu IDE y trátalo como cualquier otro servicio de desarrollo: actualiza regularmente, monitorea logs y protege tus tokens.

¿Necesitas infraestructura confiable para hospedar tus experimentos MCP, servicios auxiliares o entornos de demo? Explora nodos globales económicos de LightNode en este enlace y despliega un VPS en minutos.