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

Ejecuta esto en PowerShell:

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

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

Descarga el binario más reciente para tu plataforma desde la página de lanzamientos de GitHub:

• 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.

docker pull codescene/codescene-mcp

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

El conjunto completo de funciones — incluyendo hotspots, objetivos de deuda técnica y propiedad de código — requiere una suscripción a CodeScene. Autentícate pidiendo 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 a CodeScene, puedes usar el MCP de Code Health independiente de CodeScene.

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 a 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 completa 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 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 esa única 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 en algunas ocasiones. 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 el montaje de certificados Docker), consulta Opciones de Configuración — SSL/TLS.

El servidor MCP verifica periódicamente en GitHub si hay versiones más recientes y muestra un banner de "ACTUALIZACIÓN DE VERSIÓN DISPONIBLE" 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.