mcp-server

name	mcp-server
description	Configure, launch, validate, and troubleshoot CCAM's comprehensive MCP server for Claude Code, Codex, and other MCP hosts. Use when installing dependencies, building the server, selecting stdio, HTTP, or REPL transport, setting mutation/destructive policy, supplying dashboard authentication, or checking complete tool registration.

MCP Server

Build

npm run mcp:install
npm run mcp:typecheck
npm run mcp:build

Normal npm run setup performs install and build automatically.

Launch

ccam mcp stdio
ccam mcp http
ccam mcp repl

Policy

• Reads are enabled by default.
• Writes require MCP_DASHBOARD_ALLOW_MUTATIONS=true.
• Full data clearing additionally requires MCP_DASHBOARD_ALLOW_DESTRUCTIVE=true and the exact tool argument confirmation_token = "CLEAR_ALL_DATA". CLEAR_ALL_DATA is not an environment variable.
• Set MCP_DASHBOARD_API_TOKEN when the dashboard uses DASHBOARD_TOKEN.
• The target URL remains restricted to loopback and approved container-host names.

Validate with npm run test:mcp. Protocol and REPL transports must expose the same catalog because both use the canonical domain registration path.