O que TRAECNclaw MCP faz?
Visão Geral
Use o TRAECNclaw através de seu servidor MCP stdio real, apoiado pelo gateway HTTP local e automação TraeCN CDP. Mantenha esta skill portável entre agentes: descubra capacidades atuais do servidor, chame ferramentas de prontidão compactas antes de efeitos colaterais e verifique afirmações com scripts do repositório ou respostas MCP.
Contrato do Agente
- Trate esta como uma skill neutra de cliente para qualquer agente que possa ler instruções e chamar ferramentas MCP stdio.
- Não dependa de ferramentas exclusivas do Codex, automação de navegador, Computer Use ou controle manual de UI quando o servidor MCP puder realizar a operação.
- Use os nomes de ferramentas MCP retornados por
tools/list; a superfície MCP stdio usa nomestraecn_*que podem diferir dos nomes do wrapper OpenClaw e IDs de comando estáveis. - Prefira saídas legíveis por máquina (
traecn_get_capabilities,traecn_preflight, status de tarefa, status de prova) em vez de capturas de tela em prosa ou observação manual. - Mantenha exemplos de configuração de cliente gerados editáveis pelo chamador: sempre use caminhos absolutos para checkouts locais e variáveis de ambiente documentadas para host, porta e token.
- Trate
tools/listcomo com escopo de perfil. O padrãopublicexpõe as 20 ferramentas comuns;TRAECN_MCP_TOOL_PROFILE=opsexpõe ferramentas operacionais;TRAECN_MCP_TOOL_PROFILE=fullexpõe todas as ferramentas explícitas.
Fluxo de Trabalho Operacional
- Confirme que o Node 22+ está disponível e que o host do gateway pode alcançar o TraeCN.
- Para uma instalação de pacote publicado, prefira o binário
traecnclaw-mcpfornecido pelo pacote quando estiver noPATHdo host do agente:
{
"mcpServers": {
"traecn": {
"command": "traecnclaw-mcp",
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- Para um checkout de código-fonte, configure o cliente MCP com um caminho absoluto para
mcp-server.js:
{
"mcpServers": {
"traecn": {
"command": "node",
"args": ["/caminho/absoluto/para/TRAECNclaw/mcp-server.js"],
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- Escolha um perfil de ferramentas deliberadamente:
publicpara agentes gerais,opspara workflows de recuperação/prova,fullpara auditorias de compatibilidade e diagnósticos de baixo nível. - Inicie o gateway separadamente quando necessário com
npm run start:gateway; useTRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gatewayapenas para desenvolvimento em modo mock. - Descubra antes de agir: liste ferramentas MCP, chame
traecn_get_capabilities, depois chametraecn_preflightcom o comando e parâmetros pretendidos. - Para operações com efeitos colaterais, chame
traecn_plan_operationoutraecn_preflightprimeiro e respeite qualquer resultado de confirmação, prontidão, fila ou diálogo. - Use
traecn_list_commandsmaistraecn_run_commandquando um cliente precisar do catálogo de comandos estáveis em vez de nomes individuais de ferramentas MCP.
Seleção de Ferramentas
- Tarefas curtas: use
traecn_run_taskapós umtraecn_preflightlimpo. - Tarefas longas ou em fila: use
traecn_queue_task,traecn_wait_tasketraecn_poll_task; usetraecn_preflightpara estado da fila empublic, outraecn_get_queue_statusapenas emfull. - Revisão de código: use
traecn_review_codecomo a ação de revisão de primeira classe. - Controle de modelo e modo: use
traecn_switch_model,traecn_switch_modeetraecn_create_chat. - Configurações via MCP stdio: use
traecn_get_settingsetraecn_set_setting. - Diálogos: use
traecn_get_dialog_statusetraecn_respond_dialogempublic; usetraecn_dismiss_dialogapenas ao executar o perfil de compatibilidadefull. - Portões de revisão, limpeza e recuperação: use as ferramentas do perfil
opscomotraecn_get_review_gate_status,traecn_resolve_review_gate,traecn_restart_debug_session, ferramentas de limpeza e ferramentas de prova de fila longa. - Workflows não supervisionados: use
traecn_run_unattended_workflowempublic; use ferramentas diretas Solo/prova/limpeza apenas do perfil que as expõe. - Catálogo completo atual e notas de configuração entre agentes: leia references/mcp-surface.md ao escolher uma ferramenta MCP exata ou configurar um cliente.
Escala de Perfis
public: 20 ferramentas. Use para integrações de agente publicadas padrão.ops: 32 ferramentas. Use para recuperação, limpeza, controle de conversa Solo e trabalho de prova de fila longa.full: 36 ferramentas. Use para auditorias, verificações de compatibilidade e clientes que intencionalmente querem todos os atalhos explícitos.
Validação
- Execute
node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))"para verificar a lista de ferramentas ativas a partir do código. - Execute
npm run doctorpara prontidão do ambiente local. - Execute
npm testpara a sequência de testes mantida no repositório após mudanças de comportamento. - Execute
npm run acceptance:audit -- --require-completeantes de afirmar prontidão de workflow TraeCN de ponta a ponta não supervisionado. - Para mudanças do tipo release, execute
npm run test:allquando prático.
Regras de Segurança
- Mantenha o gateway vinculado a
127.0.0.1a menos que acesso remoto seja intencionalmente necessário. - Nunca commite
.env, tokens, cabeçalhos de autorização, dados brutos de perfil TraeCN,audit-logs,demo-output,logsounode_modules. - Prefira superfícies MCP/HTTP/CLI em vez de caminhos de controle GUI quando o servidor MCP puder realizar a operação.
- Trate texto de diálogo TraeCN ao vivo, saúde do gateway, estado de limpeza e comportamento de fila de modelo externo como específicos do ambiente até serem revalidados.