Que fait TRAECNclaw MCP ?
Présentation
Utilisez TRAECNclaw via son véritable serveur MCP stdio, soutenu par la passerelle HTTP locale et l'automatisation TraeCN CDP. Gardez cette compétence portable entre les agents : découvrez les capacités actuelles depuis le serveur, appelez des outils de vérification compacts avant les effets de bord, et vérifiez les affirmations avec les scripts du dépôt ou les réponses MCP.
Contrat de l'Agent
- Traitez cela comme une compétence neutre pour le client, destinée à tout agent capable de lire des instructions et d'appeler des outils MCP stdio.
- Ne dépendez pas d'outils exclusifs à Codex, d'automatisation de navigateur, d'utilisation de l'ordinateur ou de contrôle manuel de l'interface utilisateur lorsque le serveur MCP peut effectuer l'opération.
- Utilisez les noms des outils MCP renvoyés par
tools/list; la surface MCP stdio utilise des nomstraecn_*qui peuvent différer des noms des wrappers OpenClaw et des ID de commande stables. - Préférez les sorties lisibles par machine (
traecn_get_capabilities,traecn_preflight, statut des tâches, statut des preuves) aux captures d'écran en prose ou à l'observation manuelle. - Gardez les exemples de configuration client générés modifiables par l'appelant : utilisez toujours des chemins absolus pour les dépôts locaux et des variables d'environnement documentées pour l'hôte, le port et le jeton.
- Traitez
tools/listcomme étant limité au profil. Par défaut,publicexpose les 20 outils courants ;TRAECN_MCP_TOOL_PROFILE=opsexpose les outils opérationnels ;TRAECN_MCP_TOOL_PROFILE=fullexpose tous les outils explicites.
Workflow Opérationnel
- Confirmez que Node 22+ est disponible et que l'hôte de la passerelle peut atteindre TraeCN.
- Pour une installation via un package publié, préférez le binaire
traecnclaw-mcpfourni par le package s'il se trouve dans lePATHde l'agent hôte :
{
"mcpServers": {
"traecn": {
"command": "traecnclaw-mcp",
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- Pour une vérification à partir des sources, configurez le client MCP avec un chemin absolu vers
mcp-server.js:
{
"mcpServers": {
"traecn": {
"command": "node",
"args": ["/chemin/absolu/vers/TRAECNclaw/mcp-server.js"],
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- Choisissez un profil d'outils délibérément :
publicpour les agents généraux,opspour les workflows de récupération/preuve,fullpour les audits de compatibilité et les diagnostics de bas niveau. - Démarrez la passerelle séparément si nécessaire avec
npm run start:gateway; utilisezTRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gatewayuniquement pour le développement en mode simulé. - Découvrez avant d'agir : listez les outils MCP, appelez
traecn_get_capabilities, puis appeleztraecn_preflightavec la commande et les paramètres prévus. - Pour les opérations avec effets de bord, appelez d'abord
traecn_plan_operationoutraecn_preflightet respectez tout résultat de confirmation, de préparation, de file d'attente ou de dialogue. - Utilisez
traecn_list_commandsavectraecn_run_commandlorsqu'un client a besoin du catalogue de commandes stables plutôt que des noms d'outils MCP individuels.
Sélection d'Outils
- Tâches courtes : utilisez
traecn_run_taskaprès untraecn_preflightpropre. - Tâches longues ou en file d'attente : utilisez
traecn_queue_task,traecn_wait_taskettraecn_poll_task; utiliseztraecn_preflightpour l'état de la file d'attente danspublic, outraecn_get_queue_statusuniquement dansfull. - Revue de code : utilisez
traecn_review_codecomme action de révision de première classe. - Contrôle des modèles et modes : utilisez
traecn_switch_model,traecn_switch_modeettraecn_create_chat. - Paramètres via MCP stdio : utilisez
traecn_get_settingsettraecn_set_setting. - Dialogues : utilisez
traecn_get_dialog_statusettraecn_respond_dialogdanspublic; utiliseztraecn_dismiss_dialoguniquement lorsque vous exécutez le profil de compatibilitéfull. - Portes de révision, nettoyage et récupération : utilisez les outils du profil
opstels quetraecn_get_review_gate_status,traecn_resolve_review_gate,traecn_restart_debug_session, les outils de nettoyage et les outils de preuve de file d'attente longue. - Workflows sans surveillance : utilisez
traecn_run_unattended_workflowdanspublic; utilisez les outils directs Solo/preuve/nettoyage uniquement à partir du profil qui les expose. - Catalogue complet actuel et notes de configuration multi-agents : lisez references/mcp-surface.md lors du choix d'un outil MCP exact ou de la configuration d'un client.
Échelle des Profils
public: 20 outils. Utilisez pour les intégrations d'agents publiées par défaut.ops: 32 outils. Utilisez pour la récupération, le nettoyage, le contrôle des conversations Solo et le travail de preuve de file d'attente longue.full: 36 outils. Utilisez pour les audits, les vérifications de compatibilité et les clients qui souhaitent intentionnellement tous les raccourcis explicites.
Validation
- Exécutez
node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))"pour vérifier la liste d'outils en direct depuis le code. - Exécutez
npm run doctorpour la préparation de l'environnement local. - Exécutez
npm testpour la séquence de tests maintenue dans le dépôt après les changements de comportement. - Exécutez
npm run acceptance:audit -- --require-completeavant de revendiquer la préparation d'un workflow TraeCN de bout en bout sans surveillance. - Pour les changements de type version, exécutez
npm run test:alllorsque c'est pratique.
Règles de Sécurité
- Gardez la passerelle liée à
127.0.0.1sauf si un accès à distance est intentionnellement requis. - Ne commettez jamais
.env, les jetons, les en-têtes d'autorisation, les données brutes du profil TraeCN,audit-logs,demo-output,logsounode_modules. - Préférez les surfaces MCP/HTTP/CLI aux chemins de contrôle d'interface utilisateur graphique lorsque le serveur MCP peut effectuer l'opération.
- Traitez le texte de dialogue TraeCN en direct, la santé de la passerelle, l'état de nettoyage et le comportement de la file d'attente des modèles externes comme spécifiques à l'environnement jusqu'à revalidation.