Codescene

npx を使って MCP サーバーを直接実行します（インストール不要です）。

npx @codescene/codehealth-mcp

または、グローバルにインストールします。

npm install -g @codescene/codehealth-mcp

初回起動時に、お使いのシステムに適したプラットフォーム固有のバイナリが自動的にダウンロードされ、次回以降のためにキャッシュされます。Node.js 18 以降が必要です。

📖 インストールと連携の完全ガイド

CodeScene マーケットプレイスを追加して、プラグインをインストールします。

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

これにより、MCP サーバーと Code Health スキルがインストールされます。Node.js 18 以降が必要です。

最新のリリースページから MCP バンドルをダウンロードします。

• codehealth-mcp-{version}.mcpb

次に、.mcpb ファイルを Claude Desktop で開いて、MCP サーバーをインストールします。

CodeScene MCP は 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

📖 インストールと連携の完全ガイド

VS Code / GitHub Copilot をお使いの場合、CodeScene MCP 拡張機能にサーバーが同梱されており、別途 PowerShell でインストールしなくても自動的に設定されます。

PowerShell で次を実行します。

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

インストール後、AI アシスタントまたは IDE（すべての VS Code ウィンドウを含む）を完全に終了してから再度開き、更新された PATH が反映されるようにしてください。その後、以下のガイドに従って MCP サーバーを設定します。MCP サーバーや統合ターミナルだけを再起動しても、VS Code の PATH は更新されません。このガイドには、実行可能ファイルのパスを直接指定し、PATH の要件を回避する VS Code の設定方法も記載されています。

📖 インストールと連携の完全ガイド

GitHub Releases ページから、お使いのプラットフォーム用の最新バイナリをダウンロードします。

• macOS： cs-mcp-macos-aarch64.zip（Apple Silicon）または cs-mcp-macos-amd64（Intel）
• Linux： cs-mcp-linux-aarch64.zip または cs-mcp-linux-amd64
• Windows： cs-mcp-windows-amd64.exe

ダウンロード後、実行可能にして、必要に応じて PATH に追加します。

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

ソースから静的実行ファイルをビルドすることもできます。

警告

Docker ディストリビューションは廃止される予定です。2026 年 10 月 1 日から 12 月 31 日までは、バグ修正の場合に限り Docker イメージをリリースします。2026 年 12 月 31 日以降、Docker イメージはリリースされません。NPM / npx、Homebrew、Windows インストーラー、または上記の別のインストール方法に移行してください。

docker pull codescene/codescene-mcp

📖 インストールと連携の完全ガイド | Docker イメージをローカルでビルドする

ホットスポット、技術的負債の目標、コードの所有権など、すべての機能を利用するには、CodeScene のサブスクリプションが必要です。AI アシスタントに CodeScene へのログインを依頼して認証するか、ログインツールを使用してください。または、CodeScene インスタンスで CS_ACCESS_TOKEN を作成すると、MCP が有効になります。 MCP は CodeScene Cloud と CodeScene on-prem の両方に対応しています。

CodeScene のサブスクリプションなしでローカルの Code Health 分析を行うには、スタンドアロンのCodeScene Code Health MCPを使用できます。

CodeScene MCP サーバーは完全にローカルで動作します。Code Health のスコアリング、差分レビュー、ビジネスケースの計算など、すべての分析はお使いのマシン上で、ローカルリポジトリを対象に実行されます。 ソースコードや分析データがクラウドプロバイダー、LLM ベンダー、その他の外部サービスに送信されることはありません。

ホットスポットや技術的負債の目標などの分析結果は、安全なトークンを使用して、お使いの CodeScene アカウントから REST 経由で取得されます。

詳細については、CodeScene のプライバシーとセキュリティに関するドキュメントをご覧ください。

CodeScene MCP は AI アシスタントがサポートする任意のモデルで動作しますが、アシスタントにモデルセレクターがある場合（GitHub Copilot などのツールの場合）は、最先端のモデルを選択することを強くおすすめします。

Claude Sonnet などの最先端モデルは、古い GPT-4.1 などのモデルよりもルールの遵守とリファクタリングの品質に優れています。古いモデルは MCP の制約への対応に苦労することがよくあります。 一貫して高品質な使用体験を得るには、利用可能な最新のモデルを選択してください。

Docker のマウントパスを指定する必要があるため、プロジェクトごとに MCP 設定を用意する（たとえば VS Code では、プロジェクトごとに .vscode/mcp.json ファイルを用意する）か、すべてのプロジェクトを含むルートディレクトリをマウントして、その設定を 1 つだけ使用できます。

テストでは、IntelliJ の AI アシスタントが CodeScene MCP サーバーに誤ったパスを渡すことがあると確認されています。 確認できた限りでは、これは MCP サーバー自体ではなく、IntelliJ の AI アシスタントに関係しているようです。AI アシスタントがパスの一部を誤って生成することがあるようです。現在もこの問題を調査しており、詳細が分かり次第、このセクションを更新します。

組織で内部 CA（認証局）を使用している場合は、REQUESTS_CA_BUNDLE 環境変数に CA 証明書ファイル（PEM 形式）のパスを設定してください。MCP サーバーが SSL を自動的に設定するため、一度設定するだけで済みます。

代替として、SSL_CERT_FILE と CURL_CA_BUNDLE も使用できます。

詳しい設定例（Docker での証明書のマウントを含む）については、Configuration Options — SSL/TLSをご覧ください。

MCP サーバーは定期的に GitHub で新しいリリースを確認し、お使いのバージョンが古い場合は「VERSION UPDATE AVAILABLE」バナーを表示します。このチェックはバックグラウンドで実行され、ツールの応答を妨げることはありませんが、ネットワークが制限された環境では完全に無効にしたい場合があります。

CS_DISABLE_VERSION_CHECK 環境変数に空でない値（例：1）を設定してください。設定方法については、Configuration Options — Version Checkをご覧ください。