TraeCN MCP

TraeCN MCP

TraeCN MCP connects your agent to the TraeCN desktop app on the same Mac.Use 20 focused MCP tools to delegate work, follow results, change context andsettings, and resolve approvals. The local gateway manages the queue, taskrecovery, and completion delivery.

Agent host → TraeCN MCP (stdio) → local gateway → TraeCN (CDP)

Quick start

Requires macOS, Node.js 22+, and a signed-in TraeCN desktop app. From thischeckout, install dependencies and start the gateway:

npm ci
npm run quickstart -- --launch-trae

Keep that terminal open while using the gateway. If TraeCN is already runningwithout remote debugging, follow the restart instructions printed byQuickstart. It reuses your existing profile by default.

In another terminal, generate the host configuration:

npm run --silent setup:mcp

Add the generated traecn entry to your host's MCP configuration and reconnect.See the MCP server guide for other config formats,protocol compatibility, and tool details.

Use it

Call traecn_send_message and keep the returned task ID. Use your host'scompletion subscription or notification, or read the same task withtraecn_get_task. Select a workspace, conversation, model, or mode only whenthe task requires a change.

Operations and integrations

• Web console at 127.0.0.1:8788 for human control and task review.
• CLI for setup and diagnostics. Run npm run doctor or see the deployment guide for background operation.
• Agent Skill for tool-use guidance. Skill source
• OpenClaw and REST use the same gateway. OpenClaw setup · Runtime configuration

Daily check-in

With a signed-in Trae CN 3.4.15 or 3.4.11 workspace connected, run traecn-mcp check-into read the account's daily status. Add --claim to claim the reward once, orstart the gateway with TRAECN_AUTO_CHECK_IN=1 to check on startup and hourly.For a LaunchAgent, set the same variable when installing or refreshing thegateway service. Check-in uses Trae CN's Beijing business day and verifiesthe result through the app. It uses the check-in action without the optionaldraw. Runtime configuration

Distribution and development

Download the server tarball, MCPB bundle, or Agent Skill fromGitHub Releases.On macOS, Homebrew installs the same server tarball:

brew tap Luckycat133/traecn-mcp https://github.com/Luckycat133/traecn-mcp.git
brew install Luckycat133/traecn-mcp/traecnclaw
traecn-mcp quickstart --launch-trae

In another terminal, run traecn-mcp setup-mcp to generate your host entry.

Run npm run verify for local, non-live validation. See thecompatibility matrix,distribution runbook, andchannel ledger. For upgrades from 0.3.x, see themigration guide.