TRAECNclaw MCP は何をしますか?
概要
TRAECNclawを、実際のstdio MCPサーバー(ローカルHTTPゲートウェイとTraeCN CDP自動化をバックエンドとして使用)を通じて利用します。このスキルはエージェント間でポータブルに保ってください。サーバーから現在の機能を発見し、副作用の前にコンパクトな準備状態確認ツールを呼び出し、リポジトリスクリプトやMCP応答で主張を検証します。
エージェント契約
- これは、指示を読み、stdio MCPツールを呼び出せる任意のエージェント向けのクライアントニュートラルなスキルとして扱ってください。
- MCPサーバーが操作を実行できる場合、Codex専用ツール、ブラウザ自動化、Computer Use、手動UI制御に依存しないでください。
tools/listで返されるMCPツール名を使用してください。stdio MCPサーフェスはtraecn_*という名前を使用しており、これはOpenClawラッパー名や安定したコマンドIDと異なる場合があります。- 機械可読な出力(
traecn_get_capabilities、traecn_preflight、タスクステータス、証明ステータス)を、散文的なスクリーンショットや手動観察よりも優先してください。 - 生成されたクライアント設定例は、呼び出し元が編集可能に保ってください。ローカルチェックアウトには常に絶対パスを使用し、ホスト、ポート、トークンには文書化された環境変数を使用してください。
tools/listはプロファイルスコープごとに異なるものとして扱ってください。デフォルトのpublicは一般的な20ツールを公開し、TRAECN_MCP_TOOL_PROFILE=opsは運用ツールを公開し、TRAECN_MCP_TOOL_PROFILE=fullはすべての明示的ツールを公開します。
操作ワークフロー
- Node 22以上が利用可能で、ゲートウェイホストがTraeCNに到達可能であることを確認します。
- 公開パッケージインストールの場合は、エージェントホストの
PATHにあれば、パッケージが提供するtraecnclaw-mcpバイナリを優先します。
{
"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を使用します。traecn_dismiss_dialogはfull互換性プロファイルを実行している場合にのみ使用します。 - レビューゲート、クリーンアップ、復旧:
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サーバーが操作を実行できる場合は、GUI制御パスよりもMCP/HTTP/CLIサーフェスを優先します。
- 実際のTraeCNダイアログテキスト、ゲートウェイの健全性、クリーンアップ状態、外部モデルキューの動作は、再検証されるまで環境固有のものとして扱ってください。