FAQ: CodeScene Single-User MCP

Use this page for quick answers to the most common questions about CodeScene Single-User MCP. For step-by-step guidance, start with the Single-User MCP Help Center collection. For deeper technical detail, use the GitHub docs. CodeScene’s public FAQ follows the same quick-answers-plus-guides pattern by pointing users to the Help Center for tutorials and guides.

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 refactoring, and explain why Code Health matters.

Do I need a full CodeScene subscription to use it?

No. The MCP repository explicitly distinguishes between the full MCP feature set that uses a CodeScene subscription and the Single-User Code Health MCP for local Code Health analysis without a CodeScene subscription.

What does the Single-User edition include?

A Single-User access token enables local Code Health analysis tools only. That includes scoring, review, and refactoring-related workflows. Project-level and API-dependent features are not included.

Which tools are part of the Single-User workflow?

The Single-User workflow covers local Code Health tools such as:

  • code_health_score

  • code_health_review

  • pre_commit_code_health_safeguard

  • analyze_change_set

  • code_health_refactoring_business_case

  • explain_code_health

  • explain_code_health_productivity

If ACE is configured with CS_ACE_ACCESS_TOKEN, code_health_auto_refactor is also available.

Do I need ACE to use CodeScene Single-User MCP?

No. ACE is optional. CodeScene MCP works without ACE, and ACE becomes available only when CS_ACE_ACCESS_TOKEN is set. ACE requires an additional license.

Do I need to share my code with CodeScene?

No. For local analysis, the MCP server runs locally and processes analysis on your machine against your local repository. The GitHub FAQ states that no source code or analysis data is sent to cloud providers, LLM vendors, or external services as part of local analysis. The documented Docker setup also mounts the repository read-only.

Why do I need to copy AGENTS.md into my repository?

AGENTS.md tells AI tools how to use CodeScene MCP correctly. It contains rules that safeguard AI coding, prevent regressions, and keep agents aligned with Code Health metrics. If you use Amazon Q, copy .amazonq/rules instead.

Which installation methods are supported?

CodeScene MCP supports:

  • NPM / npx

  • Homebrew

  • Windows PowerShell install

  • Docker

  • manual download from GitHub Releases

Where do I get the Single-User access token?

You can find the complete token signup and setup flow in our article How to start your Single-User MCP free trial and get your access token, including where to find the token email and how to use the token in your MCP configuration.

Where should I look for help first?

Use this order:

  1. the Single-User Help Center collection

  2. Eve chatbot in the Help Center

  3. the GitHub docs

  4. the GitHub issue flow for this product