Romanela

Execute o servidor MCP diretamente com npx (sem necessidade de instalação):

npx @codescene/codehealth-mcp

Ou instale globalmente:

npm install -g @codescene/codehealth-mcp

A primeira execução baixa automaticamente o binário específico da plataforma para o seu sistema e o armazena em cache para uso futuro. Requer Node.js 18 ou posterior.

📖 Guia completo de instalação e integração

Adicione o marketplace da CodeScene e instale o plugin:

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

Isso instala o servidor MCP e as habilidades de Code Health. Requer Node.js 18 ou posterior.

Baixe o pacote MCP da página de versões mais recentes:

• codehealth-mcp-{version}.mcpb

Em seguida, abra o arquivo .mcpb com o Claude Desktop para instalar o servidor MCP.

O CodeScene MCP está disponível como uma extensão do 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

📖 Guia completo de instalação e integração

Execute isto no PowerShell:

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

📖 Guia completo de instalação e integração

Baixe o binário mais recente para a sua plataforma na página de Releases do GitHub:

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

Após o download, torne-o executável e, opcionalmente, adicione-o ao seu PATH:

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

Você também pode compilar um executável estático a partir do código-fonte.

docker pull codescene/codescene-mcp

📖 Guia completo de instalação e integração | Compilar a imagem Docker localmente

O conjunto completo de recursos — incluindo hotspots, metas de dívida técnica e propriedade de código — requer uma assinatura CodeScene. Autentique-se pedindo ao seu Assistente de IA para fazer login na CodeScene, ou use a ferramenta de login. Alternativamente, use sua instância CodeScene para criar o CS_ACCESS_TOKEN que ativa o MCP. O MCP suporta tanto CodeScene Cloud quanto CodeScene on-prem.

Para análise local de Code Health sem assinatura CodeScene, você pode usar o CodeScene Code Health MCP standalone.

O Servidor MCP CodeScene é executado totalmente localmente. Toda a análise — incluindo pontuação de Code Health, revisões delta e cálculos de caso de negócio — é realizada na sua máquina, contra o seu repositório local. Nenhum código-fonte ou dado de análise é enviado a provedores de nuvem, fornecedores de LLM ou qualquer serviço externo.

Os resultados da análise (por exemplo, hotspots e metas de dívida técnica) são obtidos via REST da sua própria conta CodeScene usando um token seguro.

Para detalhes completos, consulte a documentação completa de privacidade e segurança da CodeScene.

O CodeScene MCP pode funcionar com qualquer modelo que seu assistente de IA suporte, mas recomendamos fortemente escolher um modelo de fronteira quando seu assistente oferecer um seletor de modelos (como em ferramentas como GitHub Copilot).

Modelos de fronteira — como Claude Sonnet — oferecem adesão a regras e qualidade de refatoração muito melhores, enquanto modelos legados como GPT-4.1 frequentemente têm dificuldade com as restrições do MCP. Para uma experiência consistente e de alta qualidade, selecione o modelo mais recente disponível.

Como você precisa fornecer um caminho de montagem para Docker, você pode ter uma configuração MCP por projeto (no VS Code, isso seria um arquivo .vscode/mcp.json por projeto, por exemplo) ou pode montar um diretório raiz dentro do qual todos os seus projetos estão e então usar apenas essa configuração.

Em nossos testes, observamos que o AI Assistant do IntelliJ às vezes fornece um caminho errado para o servidor MCP CodeScene. Pelo que podemos dizer, parece não ter nada a ver com o servidor MCP em si, mas sim com o AI Assistant do IntelliJ, que parece alucinar partes do caminho algumas vezes. Ainda estamos investigando este problema e atualizaremos esta seção assim que tivermos mais informações.

Se sua organização usa uma CA (Autoridade Certificadora) interna, defina a variável de ambiente REQUESTS_CA_BUNDLE para apontar para o arquivo de certificado da sua CA (formato PEM). O servidor MCP configura SSL automaticamente — você só precisa defini-la uma vez.

O MCP também suporta SSL_CERT_FILE e CURL_CA_BUNDLE como alternativas.

Para exemplos de configuração detalhados (incluindo montagem de certificados Docker), consulte Opções de Configuração — SSL/TLS.

O servidor MCP verifica periodicamente o GitHub para novas versões e mostra um banner "ATUALIZAÇÃO DE VERSÃO DISPONÍVEL" quando sua versão está desatualizada. Esta verificação é executada em segundo plano e nunca bloqueia respostas de ferramentas, mas em ambientes com restrição de rede você pode querer desativá-la completamente.

Defina a variável de ambiente CS_DISABLE_VERSION_CHECK para qualquer valor não vazio (por exemplo, 1). Para detalhes de configuração, consulte Opções de Configuração — Verificação de Versão.