What is CodeScene Single-User MCP?

CodeScene Single-User MCP is a standalone edition of the CodeScene MCP Server focused on local Code Health workflows. It gives your AI assistant direct access to Code Health so it can review code, safeguard AI-generated changes, support healthier refactoring, and help explain why Code Health matters.

What it is used for

Typical use cases include:

  • reviewing the Code Health of a file

  • scoring maintainability

  • safeguarding AI-generated or AI-modified changes before commit

  • checking a change set before a pull request

  • supporting refactoring with Code Health guidance

  • building a business case for refactoring

  • using ACE auto-refactoring when separately licensed and configured

How it works

CodeScene MCP runs locally. The MCP server is designed to run in your local environment and expose Code Health insights directly from your codebase. For local analysis, Code Health scoring, delta reviews, and business-case calculations run on your machine against your local repository. No source code or analysis data is sent to cloud providers, LLM vendors, or external services as part of that local analysis workflow.

What is included in the standalone edition

A Single-User access token enables local Code Health analysis tools. That includes scoring, review, and refactoring-related workflows. Project-level and API-dependent features are not part of the standalone tool set.

How it is configured

CodeScene MCP can be configured in three ways:

  1. Ask your AI assistant to configure it using the built-in configuration tools.

  2. Set environment variables in your MCP client configuration.

  3. Use the local config file managed by the MCP server.

Environment variables set by your MCP client take precedence over values stored in the config file. The built-in set_config and get_config tools are part of the MCP server.

Good to know

  • CS_ACCESS_TOKEN is the main authentication setting.

  • Changing the token may require a server restart so the correct tool set is registered.

  • AGENTS.md helps AI agents use CodeScene MCP correctly.

  • If you use Amazon Q, copy .amazonq/rules instead of AGENTS.md.

  • If you also have an ACE token, set CS_ACE_ACCESS_TOKEN to enable code_health_auto_refactor.

  • CS_DISABLE_VERSION_CHECK can be used to suppress the automatic version check.