Communitygithub.com

TRAECNclaw MCP

MCP 지원 AI 에이전트가 TraeCN 자동화, OpenClaw 통합, 무인 워크플로우, 설정/모델/대화 제어, 코드 리뷰 위임 및 장기 큐 검증을 위해 TRAECNclaw의 stdio MCP 서버에 연결, 구성, 운영, 테스트 및 문서화할 수 있습니다. 에이전트가 직접 브라우저나 GUI를 제어하는 대신 실제 MCP 도구 표면이 필요할 때 이 스킬을 선호합니다.

TRAECNclaw MCP란 무엇인가요?

TRAECNclaw MCP 스킬은 AI 에이전트가 TRAECNclaw 자동화 시스템과 상호작용할 수 있는 표준화된 stdio MCP 서버 인터페이스를 제공합니다. 이 스킬은 TraeCN CDP 자동화와 로컬 HTTP 게이트웨이를 기반으로 하여, 에이전트가 브라우저 자동화나 수동 UI 제어 없이 MCP 도구를 통해 직접 TraeCN을 제어할 수 있게 합니다. 주요 기능으로는 작업 실행 및 큐잉, 코드 리뷰 위임, 모델/모드 전환, 설정 관리, 대화 제어, 그리고 무인 워크플로우 실행이 있습니다. 에이전트는 `tools/list`를 통해 현재 사용 가능한 도구를 동적으로 탐색하고, `traecn_preflight`와 같은 준비 상태 확인 도구를 호출한 후 부수 효과가 있는 작업을 수행하는 것이 권장됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 모든 MCP 호환 에이전트에서 이식 가능하게 설계되었으며, 세 가지 도구 프로필(public, ops, full)을 통해 다양한 사용 사례에 맞게 도구 표면을 조정할 수 있습니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

TRAECNclaw MCP은(는) 무엇을 하나요?

개요

TRAECNclaw를 로컬 HTTP 게이트웨이와 TraeCN CDP 자동화를 기반으로 하는 실제 stdio MCP 서버를 통해 사용합니다. 이 스킬을 다양한 에이전트 간에 이식 가능하게 유지하세요: 서버에서 현재 기능을 발견하고, 부수 효과가 발생하기 전에 간결한 준비 상태 도구를 호출하며, 리포지토리 스크립트나 MCP 응답으로 주장을 검증합니다.

에이전트 계약

  • 지침을 읽고 stdio MCP 도구를 호출할 수 있는 모든 에이전트를 위한 클라이언트 중립적인 스킬로 취급하세요.
  • MCP 서버가 작업을 수행할 수 있는 경우 Codex 전용 도구, 브라우저 자동화, Computer Use 또는 수동 UI 제어에 의존하지 마세요.
  • tools/list가 반환하는 MCP 도구 이름을 사용하세요. stdio MCP 표면은 OpenClaw 래퍼 이름 및 안정적인 명령 ID와 다를 수 있는 traecn_* 이름을 사용합니다.
  • 기계 판독 가능한 출력(traecn_get_capabilities, traecn_preflight, 작업 상태, 증명 상태)을 산문 스크린샷이나 수동 관찰보다 선호하세요.
  • 생성된 클라이언트 구성 예제는 호출자가 편집할 수 있도록 유지하세요: 항상 로컬 체크아웃의 절대 경로와 호스트, 포트, 토큰에 대한 문서화된 환경 변수를 사용하세요.
  • tools/list를 프로필 범위로 취급하세요. 기본 public은 일반적인 20개 도구를 노출하고, TRAECN_MCP_TOOL_PROFILE=ops는 운영 도구를 노출하며, TRAECN_MCP_TOOL_PROFILE=full은 모든 명시적 도구를 노출합니다.

운영 워크플로우

  1. Node 22+를 사용할 수 있고 게이트웨이 호스트가 TraeCN에 도달할 수 있는지 확인합니다.
  2. 게시된 패키지 설치의 경우, 패키지에서 제공하는 traecnclaw-mcp 바이너리가 에이전트 호스트 PATH에 있을 때 이를 선호합니다:
{
  "mcpServers": {
    "traecn": {
      "command": "traecnclaw-mcp",
      "env": {
        "TRAECN_HOST": "127.0.0.1",
        "TRAECN_PORT": "8788",
        "TRAECN_GATEWAY_TOKEN": "",
        "TRAECN_MCP_TOOL_PROFILE": "public"
      }
    }
  }
}
  1. 소스 체크아웃의 경우, 절대 mcp-server.js 경로로 MCP 클라이언트를 구성합니다:
{
  "mcpServers": {
    "traecn": {
      "command": "node",
      "args": ["/absolute/path/to/TRAECNclaw/mcp-server.js"],
      "env": {
        "TRAECN_HOST": "127.0.0.1",
        "TRAECN_PORT": "8788",
        "TRAECN_GATEWAY_TOKEN": "",
        "TRAECN_MCP_TOOL_PROFILE": "public"
      }
    }
  }
}
  1. 의도적으로 도구 프로필을 선택하세요: 일반 에이전트용 public, 복구/증명 워크플로우용 ops, 호환성 감사 및 저수준 진단용 full.
  2. 필요할 때 npm run start:gateway로 게이트웨이를 별도로 시작하고, 모의 모드 개발용으로만 TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway를 사용하세요.
  3. 행동하기 전에 발견하세요: MCP 도구를 나열하고, traecn_get_capabilities를 호출한 다음 의도한 명령 및 매개변수로 traecn_preflight를 호출합니다.
  4. 부수 효과가 있는 작업의 경우, 먼저 traecn_plan_operation 또는 traecn_preflight를 호출하고 확인, 준비 상태, 큐 또는 대화 결과를 준수합니다.
  5. 클라이언트가 개별 MCP 도구 이름 대신 안정적인 명령 카탈로그가 필요할 때 traecn_list_commands와 traecn_run_command를 사용합니다.

도구 선택

  • 짧은 작업: 깨끗한 traecn_preflight 후에 traecn_run_task를 사용합니다.
  • 길거나 큐에 있는 작업: traecn_queue_task, traecn_wait_task, traecn_poll_task를 사용합니다. public에서는 큐 상태를 위해 traecn_preflight를 사용하고, full에서만 traecn_get_queue_status를 사용합니다.
  • 코드 리뷰: 일급 리뷰 작업으로 traecn_review_code를 사용합니다.
  • 모델 및 모드 제어: traecn_switch_model, traecn_switch_mode, traecn_create_chat를 사용합니다.
  • stdio MCP를 통한 설정: traecn_get_settings와 traecn_set_setting을 사용합니다.
  • 대화: public에서는 traecn_get_dialog_status와 traecn_respond_dialog를 사용합니다. full 호환성 프로필을 실행할 때만 traecn_dismiss_dialog를 사용합니다.
  • 리뷰 게이트, 정리 및 복구: ops 프로필 도구(예: traecn_get_review_gate_status, traecn_resolve_review_gate, traecn_restart_debug_session, 정리 도구 및 장기 큐 증명 도구)를 사용합니다.
  • 무인 워크플로우: public에서는 traecn_run_unattended_workflow를 사용합니다. 직접 Solo/증명/정리 도구는 해당 도구를 노출하는 프로필에서만 사용합니다.
  • 전체 현재 카탈로그 및 교차 에이전트 구성 노트: 정확한 MCP 도구를 선택하거나 클라이언트를 구성할 때 references/mcp-surface.md를 읽으세요.

프로필 규모

  • public: 20개 도구. 기본 게시된 에이전트 통합에 사용합니다.
  • ops: 32개 도구. 복구, 정리, Solo 대화 제어 및 장기 큐 증명 작업에 사용합니다.
  • full: 36개 도구. 감사, 호환성 검사 및 의도적으로 모든 명시적 바로 가기를 원하는 클라이언트에 사용합니다.

검증

  • node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))"를 실행하여 코드에서 라이브 도구 목록을 확인합니다.
  • 로컬 환경 준비 상태를 위해 npm run doctor를 실행합니다.
  • 동작 변경 후 유지되는 리포지토리 내 테스트 시퀀스를 위해 npm test를 실행합니다.
  • 무인 종단간 TraeCN 워크플로우 준비 상태를 주장하기 전에 npm run acceptance:audit -- --require-complete를 실행합니다.
  • 릴리스 스타일 변경의 경우, 가능할 때 npm run test:all을 실행합니다.

안전 규칙

  • 원격 액세스가 의도적으로 필요한 경우가 아니라면 게이트웨이를 127.0.0.1에 바인딩된 상태로 유지합니다.
  • .env, 토큰, 인증 헤더, 원시 TraeCN 프로필 데이터, audit-logs, demo-output, logs 또는 node_modules를 절대 커밋하지 마세요.
  • MCP 서버가 작업을 수행할 수 있는 경우 MCP/HTTP/CLI 표면을 GUI 제어 경로보다 선호합니다.
  • 라이브 TraeCN 대화 텍스트, 게이트웨이 상태, 정리 상태 및 외부 모델 큐 동작은 재검증될 때까지 환경별로 취급합니다.

관련 스킬