Romanela

Ejecuta el servidor MCP directamente con npx (no se necesita instalación):

npx @codescene/codehealth-mcp

O instálalo globalmente:

npm install -g @codescene/codehealth-mcp

La primera ejecución descarga automáticamente el binario específico de tu plataforma y lo almacena en caché para usos futuros. Requiere Node.js 18 o posterior.

📖 Guía completa de instalación e integración

Agrega el marketplace de CodeScene e instala el plugin:

/plugin marketplace add codescene-oss/codescene-mcp-server
/plugin install codescene@codescene

Esto instala el servidor MCP y las habilidades de Code Health. Requiere Node.js 18 o posterior.

Descarga el paquete MCP desde la página de la última versión:

• codehealth-mcp-{version}.mcpb

Luego abre el archivo .mcpb con Claude Desktop para instalar el servidor MCP.

CodeScene MCP está disponible como una extensión de VS Code:

• Open VSX
• VS Code Marketplace

brew tap codescene-oss/codescene-mcp-server https://github.com/codescene-oss/codescene-mcp-server
brew trust codescene-oss/codescene-mcp-server
brew install cs-mcp

📖 Guía completa de instalación e integración

Para VS Code / GitHub Copilot, la extensión CodeScene MCP incluye y configura automáticamente el servidor sin necesidad de una instalación separada de PowerShell.

Ejecuta esto en PowerShell:

irm https://raw.githubusercontent.com/codescene-oss/codescene-mcp-server/main/install.ps1 | iex

Después de instalar, cierra y vuelve a abrir completamente tu asistente de IA o IDE (incluyendo todas las ventanas de VS Code) para que detecte el PATH actualizado, luego configura el servidor MCP usando la guía a continuación. Reiniciar solo el servidor MCP o una terminal integrada no actualiza el PATH de VS Code. La guía también incluye una configuración de VS Code que usa la ruta del ejecutable directamente y evita este requisito de PATH.

📖 Guía completa de instalación e integración

Descarga el último binario para tu plataforma desde la página de GitHub Releases:

• macOS: cs-mcp-macos-aarch64.zip (Apple Silicon) o cs-mcp-macos-amd64 (Intel)
• Linux: cs-mcp-linux-aarch64.zip o cs-mcp-linux-amd64
• Windows: cs-mcp-windows-amd64.exe

Después de descargarlo, hazlo ejecutable y opcionalmente agrégalo a tu PATH:

chmod +x cs-mcp-*
mv cs-mcp-* /usr/local/bin/cs-mcp

También puedes compilar un ejecutable estático desde el código fuente.

[!WARNING] La distribución de Docker se está retirando. Desde el 1 de octubre hasta el 31 de diciembre de 2026, las imágenes de Docker se publicarán solo para correcciones de errores. No se publicarán imágenes de Docker después del 31 de diciembre de 2026. Migra a NPM / npx, Homebrew, el instalador de Windows u otra opción de instalación anterior.

docker pull codescene/codescene-mcp

📖 Guía completa de instalación e integración | Compila la imagen de Docker localmente

El conjunto completo de funciones — incluyendo hotspots, objetivos de deuda técnica y propiedad del código — requiere una suscripción de CodeScene. Autentícate pidiéndole a tu asistente de IA que inicie sesión en CodeScene, o usa la herramienta de inicio de sesión. Alternativamente, usa tu instancia de CodeScene para crear el CS_ACCESS_TOKEN que activa el MCP. El MCP admite tanto CodeScene Cloud como CodeScene local (on-prem).

Para análisis local de Code Health sin una suscripción de CodeScene, puedes usar el CodeScene Code Health MCP independiente.

El Servidor MCP de CodeScene se ejecuta completamente en local. Todo el análisis — incluyendo la puntuación de Code Health, revisiones delta y cálculos de caso de negocio — se realiza en tu máquina, contra tu repositorio local. No se envía código fuente ni datos de análisis a proveedores de nube, proveedores de LLM ni ningún servicio externo.

Los resultados del análisis (por ejemplo, hotspots y objetivos de deuda técnica) se obtienen vía REST desde tu propia cuenta de CodeScene usando un token seguro.

Para detalles completos, consulta la documentación de privacidad y seguridad de CodeScene.

CodeScene MCP puede funcionar con cualquier modelo que admita tu asistente de IA, pero recomendamos encarecidamente elegir un modelo de frontera cuando tu asistente ofrezca un selector de modelos (como en herramientas como GitHub Copilot).

Los modelos de frontera — como Claude Sonnet — ofrecen una adherencia a reglas y una calidad de refactorización mucho mejores, mientras que los modelos heredados como GPT-4.1 a menudo tienen dificultades con las restricciones de MCP. Para una experiencia consistente y de alta calidad, selecciona el modelo más nuevo disponible.

Dado que debes proporcionar una ruta de montaje para Docker, puedes tener una configuración de MCP por proyecto (en VS Code eso sería un archivo .vscode/mcp.json por proyecto, por ejemplo) o puedes montar un directorio raíz dentro del cual estén todos tus proyectos y luego usar solo esa configuración.

En nuestras pruebas hemos visto que el Asistente de IA de IntelliJ a veces da una ruta incorrecta al servidor MCP de CodeScene. Por lo que podemos ver, parece no tener nada que ver con el servidor MCP en sí, sino con el Asistente de IA de IntelliJ, que parece alucinar partes de la ruta algunas veces. Todavía estamos investigando este problema y actualizaremos esta sección una vez que tengamos más información.

Si tu organización usa una CA (Autoridad Certificadora) interna, establece la variable de entorno REQUESTS_CA_BUNDLE para que apunte a tu archivo de certificado de CA (formato PEM). El servidor MCP configura SSL automáticamente — solo necesitas configurarlo una vez.

El MCP también admite SSL_CERT_FILE y CURL_CA_BUNDLE como alternativas.

Para ejemplos de configuración detallados (incluyendo montaje de certificados en Docker), consulta Opciones de configuración — SSL/TLS.

El servidor MCP verifica periódicamente GitHub en busca de versiones más recientes y muestra un banner de "VERSION UPDATE AVAILABLE" cuando tu versión está desactualizada. Esta verificación se ejecuta en segundo plano y nunca bloquea las respuestas de las herramientas, pero en entornos con restricciones de red es posible que quieras desactivarla por completo.

Establece la variable de entorno CS_DISABLE_VERSION_CHECK a cualquier valor no vacío (por ejemplo, 1). Para detalles de configuración, consulta Opciones de configuración — Verificación de versión.