Protocol Launcher

Trae China ​

Trae is an AI-native code editor launched by ByteDance, featuring intelligent programming modes like SOLO Coder and SOLO Builder, with support for MCP Server extensions, custom agents, multitasking, and more. Protocol Launcher allows you to generate deep links to open and configure resources in Trae.

TIP

This documentation is for the China version of Trae (trae.cn) which includes Chinese AI models. For international users, see Trae which includes international AI models.

Usage ​

There are two ways to use this library:

  • On-Demand import from subpaths enables tree-shaking and keeps bundles small.
  • Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand
Recommended. Optimized for production.
Full Import
Convenient. Good for quick scripts.

Open IDE ​

On-Demand
ts
import { open } from 'protocol-launcher/trae-cn'

const url = open()
Open Trae China

Install STDIO MCP Server ​

On-Demand
ts
import { installMCP } from 'protocol-launcher/trae-cn'

const url = installMCP({
  name: 'server-everything',
  type: 'stdio',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-everything'],
})
Add to Trae China

Install Streamable HTTP MCP Server ​

On-Demand
ts
import { installMCP } from 'protocol-launcher/trae-cn'

const url = installMCP({
  name: '企查查企业信息 MCP',
  type: 'http',
  url: 'https://agent.qcc.com/mcp/company/stream',
  headers: {
    Authorization: 'Bearer REPLACE_WITH_YOUR_TOKEN',
  },
})
Add to Trae China

Install SSE MCP Server ​

On-Demand
ts
import { installMCP } from 'protocol-launcher/trae-cn'

const url = installMCP({
  name: '企查查风险信息 MCP',
  type: 'http',
  url: 'https://mcp.qcc.com/basic/sse',
  headers: {
    Authorization: 'Bearer REPLACE_WITH_YOUR_TOKEN',
  },
})
Add to Trae China

Open File ​

On-Demand
ts
import { openFile } from 'protocol-launcher/trae-cn'

const url = openFile({
  path: '/etc/hosts',
  line: 1,
  column: 2,
  openInNewWindow: true,
})
Open in Trae China

Open Folder ​

On-Demand
ts
import { openFolder } from 'protocol-launcher/trae-cn'

const url = openFolder({
  path: '/etc',
  openInNewWindow: true,
})
Open in Trae China

Open Remote ​

On-Demand
ts
import { openRemote } from 'protocol-launcher/trae-cn'

const url = openRemote({
  type: 'ssh-remote',
  host: 'root@172.18.105.209:22',
  path: '/code/my-project',
})
Open in Trae China

Open Extension ​

On-Demand
ts
import { openExtension } from 'protocol-launcher/trae-cn'

const url = openExtension({
  id: 'esbenp.prettier-vscode',
})
Open in Trae China

Open Custom Agent ​

On-Demand
ts
import { openAgent } from 'protocol-launcher/trae-cn'

const url = openAgent({
  agentId: '878f64',
})
Open in Trae China

Open Settings ​

On-Demand
ts
import { openSettings } from 'protocol-launcher/trae-cn'

const url = openSettings({
  path: 'terminal.integrated.suggest.enabled',
})
Open in Trae China