¿Qué hace TRAECNclaw MCP?
Descripción General
Usa TRAECNclaw a través de su servidor MCP stdio real, respaldado por la puerta de enlace HTTP local y la automatización CDP de TraeCN. Mantén esta habilidad portable entre agentes: descubre las capacidades actuales desde el servidor, llama a herramientas compactas de preparación antes de efectos secundarios y verifica afirmaciones con scripts del repositorio o respuestas MCP.
Contrato del Agente
- Trata esto como una habilidad neutral al cliente para cualquier agente que pueda leer instrucciones y llamar a herramientas MCP stdio.
- No dependas de herramientas exclusivas de Codex, automatización del navegador, Computer Use o control manual de la interfaz de usuario cuando el servidor MCP pueda realizar la operación.
- Usa los nombres de herramientas MCP devueltos por
tools/list; la superficie MCP stdio usa nombrestraecn_*que pueden diferir de los nombres del envoltorio OpenClaw y los IDs de comando estables. - Prefiere salidas legibles por máquina (
traecn_get_capabilities,traecn_preflight, estado de tarea, estado de comprobación) sobre capturas de pantalla en prosa u observación manual. - Mantén los ejemplos de configuración de cliente generados editables por el llamador: usa siempre rutas absolutas para los repositorios locales y variables de entorno documentadas para host, puerto y token.
- Trata
tools/listcomo un ámbito de perfil. El perfilpublicpredeterminado expone las 20 herramientas comunes;TRAECN_MCP_TOOL_PROFILE=opsexpone herramientas operativas;TRAECN_MCP_TOOL_PROFILE=fullexpone todas las herramientas explícitas.
Flujo de Trabajo Operativo
- Confirma que Node 22+ está disponible y que el host de la puerta de enlace puede alcanzar TraeCN.
- Para una instalación de paquete publicado, prefiere el binario
traecnclaw-mcpproporcionado por el paquete cuando esté en elPATHdel host del 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 un repositorio local, configura el cliente MCP con una ruta absoluta a
mcp-server.js:
{
"mcpServers": {
"traecn": {
"command": "node",
"args": ["/ruta/absoluta/hacia/TRAECNclaw/mcp-server.js"],
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- Elige un perfil de herramientas deliberadamente:
publicpara agentes generales,opspara flujos de recuperación/comprobación,fullpara auditorías de compatibilidad y diagnósticos de bajo nivel. - Inicia la puerta de enlace por separado cuando sea necesario con
npm run start:gateway; usaTRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gatewaysolo para desarrollo en modo simulado. - Descubre antes de actuar: lista las herramientas MCP, llama a
traecn_get_capabilities, luego llama atraecn_preflightcon el comando y parámetros previstos. - Para operaciones con efectos secundarios, llama primero a
traecn_plan_operationotraecn_preflighty respeta cualquier resultado de confirmación, preparación, cola o diálogo. - Usa
traecn_list_commandsjunto contraecn_run_commandcuando un cliente necesite el catálogo de comandos estables en lugar de nombres individuales de herramientas MCP.
Selección de Herramientas
- Tareas cortas: usa
traecn_run_taskdespués de untraecn_preflightlimpio. - Tareas largas o en cola: usa
traecn_queue_task,traecn_wait_taskytraecn_poll_task; usatraecn_preflightpara el estado de la cola enpublic, otraecn_get_queue_statussolo enfull. - Revisión de código: usa
traecn_review_codecomo acción de revisión de primera clase. - Control de modelo y modo: usa
traecn_switch_model,traecn_switch_modeytraecn_create_chat. - Configuraciones a través de MCP stdio: usa
traecn_get_settingsytraecn_set_setting. - Diálogos: usa
traecn_get_dialog_statusytraecn_respond_dialogenpublic; usatraecn_dismiss_dialogsolo cuando ejecutes el perfil de compatibilidadfull. - Puertas de revisión, limpieza y recuperación: usa las herramientas del perfil
opscomotraecn_get_review_gate_status,traecn_resolve_review_gate,traecn_restart_debug_session, herramientas de limpieza y herramientas de comprobación de cola larga. - Flujos de trabajo no supervisados: usa
traecn_run_unattended_workflowenpublic; usa herramientas directas de Solo/comprobación/limpieza solo desde el perfil que las expone. - Catálogo completo actual y notas de configuración entre agentes: lee references/mcp-surface.md al elegir una herramienta MCP exacta o configurar un cliente.
Escala de Perfiles
public: 20 herramientas. Úsalo para integraciones de agente publicadas por defecto.ops: 32 herramientas. Úsalo para recuperación, limpieza, control de conversaciones Solo y trabajo de comprobación de cola larga.full: 36 herramientas. Úsalo para auditorías, comprobaciones de compatibilidad y clientes que quieren intencionadamente todos los atajos explícitos.
Validación
- Ejecuta
node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))"para verificar la lista de herramientas activas desde el código. - Ejecuta
npm run doctorpara la preparación del entorno local. - Ejecuta
npm testpara la secuencia de pruebas mantenida en el repositorio después de cambios de comportamiento. - Ejecuta
npm run acceptance:audit -- --require-completeantes de reclamar preparación para flujos de trabajo no supervisados de extremo a extremo en TraeCN. - Para cambios de tipo release, ejecuta
npm run test:allcuando sea práctico.
Reglas de Seguridad
- Mantén la puerta de enlace vinculada a
127.0.0.1a menos que se requiera acceso remoto intencionadamente. - Nunca confirmes
.env, tokens, cabeceras de autorización, datos de perfil de TraeCN en bruto,audit-logs,demo-output,logsonode_modules. - Prefiere superficies MCP/HTTP/CLI sobre rutas de control GUI cuando el servidor MCP pueda realizar la operación.
- Trata el texto de diálogo de TraeCN en vivo, el estado de la puerta de enlace, el estado de limpieza y el comportamiento de la cola de modelos externos como específicos del entorno hasta que se revaliden.