/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.