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은 모든 명시적 도구를 노출합니다.
운영 워크플로우
- Node 22+를 사용할 수 있고 게이트웨이 호스트가 TraeCN에 도달할 수 있는지 확인합니다.
- 게시된 패키지 설치의 경우, 패키지에서 제공하는
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"
}
}
}
}
- 소스 체크아웃의 경우, 절대
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"
}
}
}
}
- 의도적으로 도구 프로필을 선택하세요: 일반 에이전트용
public, 복구/증명 워크플로우용ops, 호환성 감사 및 저수준 진단용full. - 필요할 때
npm run start:gateway로 게이트웨이를 별도로 시작하고, 모의 모드 개발용으로만TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway를 사용하세요. - 행동하기 전에 발견하세요: MCP 도구를 나열하고,
traecn_get_capabilities를 호출한 다음 의도한 명령 및 매개변수로traecn_preflight를 호출합니다. - 부수 효과가 있는 작업의 경우, 먼저
traecn_plan_operation또는traecn_preflight를 호출하고 확인, 준비 상태, 큐 또는 대화 결과를 준수합니다. - 클라이언트가 개별 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 대화 텍스트, 게이트웨이 상태, 정리 상태 및 외부 모델 큐 동작은 재검증될 때까지 환경별로 취급합니다.