Communitygithub.com

TRAECNclaw MCP

Use quando um agente de IA compatível com MCP precisar conectar, configurar, operar, testar ou documentar o servidor MCP stdio do TRAECNclaw para automação TraeCN, integração OpenClaw, workflows vibe não supervisionados, controle de configurações/modelo/diálogo, delegação de revisão de código ou execuções de fila longa. Prefira esta habilidade quando um agente precisar da superfície real de ferramentas MCP em vez de controle direto por navegador ou GUI.

O que é TRAECNclaw MCP?

O TRAECNclaw MCP é uma skill portável projetada para qualquer agente de IA compatível com MCP que precise interagir com a plataforma TraeCN através de seu servidor MCP stdio. Ela fornece um conjunto robusto de ferramentas para automação, integração OpenClaw, controle de configurações, modelo e diálogo, revisão de código e execução de workflows não supervisionados. A skill oferece três perfis de ferramentas (`public`, `ops`, `full`) que expõem 20, 32 ou 36 ferramentas respectivamente, permitindo que o agente escolha o nível adequado de capacidade para cada tarefa. O fluxo de trabalho recomendado enfatiza a descoberta antes da ação: listar ferramentas MCP, verificar capacidades com `traecn_get_capabilities` e validar o estado com `traecn_preflight` antes de executar operações com efeitos colaterais. A skill suporta configuração via pacote publicado ou checkout de código-fonte, com exemplos de configuração JSON que usam caminhos absolutos e variáveis de ambiente documentadas. Regras de segurança incluem manter o gateway vinculado ao `127.0.0.1`, nunca commit secrets, e preferir superfícies MCP/HTTP/CLI sobre controle GUI sempre que possível. A validação é facilitada por comandos como `npm run doctor` e `npm test`, garantindo que o agente possa verificar a prontidão do ambiente e a integridade das ferramentas.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Luckycat133/traecnclaw-mcp-skill/tree/main/.codex/skills/traecnclaw-mcp

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 nomes traecn_* 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/list como com escopo de perfil. O padrão public expõe as 20 ferramentas comuns; TRAECN_MCP_TOOL_PROFILE=ops expõe ferramentas operacionais; TRAECN_MCP_TOOL_PROFILE=full expõe todas as ferramentas explícitas.

Fluxo de Trabalho Operacional

  1. Confirme que o Node 22+ está disponível e que o host do gateway pode alcançar o TraeCN.
  2. Para uma instalação de pacote publicado, prefira o binário traecnclaw-mcp fornecido pelo pacote quando estiver no PATH do 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"
      }
    }
  }
}
  1. 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"
      }
    }
  }
}
  1. Escolha um perfil de ferramentas deliberadamente: public para agentes gerais, ops para workflows de recuperação/prova, full para auditorias de compatibilidade e diagnósticos de baixo nível.
  2. Inicie o gateway separadamente quando necessário com npm run start:gateway; use TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway apenas para desenvolvimento em modo mock.
  3. Descubra antes de agir: liste ferramentas MCP, chame traecn_get_capabilities, depois chame traecn_preflight com o comando e parâmetros pretendidos.
  4. Para operações com efeitos colaterais, chame traecn_plan_operation ou traecn_preflight primeiro e respeite qualquer resultado de confirmação, prontidão, fila ou diálogo.
  5. Use traecn_list_commands mais traecn_run_command quando 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_task após um traecn_preflight limpo.
  • Tarefas longas ou em fila: use traecn_queue_task, traecn_wait_task e traecn_poll_task; use traecn_preflight para estado da fila em public, ou traecn_get_queue_status apenas em full.
  • Revisão de código: use traecn_review_code como a ação de revisão de primeira classe.
  • Controle de modelo e modo: use traecn_switch_model, traecn_switch_mode e traecn_create_chat.
  • Configurações via MCP stdio: use traecn_get_settings e traecn_set_setting.
  • Diálogos: use traecn_get_dialog_status e traecn_respond_dialog em public; use traecn_dismiss_dialog apenas ao executar o perfil de compatibilidade full.
  • Portões de revisão, limpeza e recuperação: use as ferramentas do perfil ops como traecn_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_workflow em public; 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 doctor para prontidão do ambiente local.
  • Execute npm test para a sequência de testes mantida no repositório após mudanças de comportamento.
  • Execute npm run acceptance:audit -- --require-complete antes de afirmar prontidão de workflow TraeCN de ponta a ponta não supervisionado.
  • Para mudanças do tipo release, execute npm run test:all quando prático.

Regras de Segurança

  • Mantenha o gateway vinculado a 127.0.0.1 a 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, logs ou node_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.

Habilidades Relacionadas