configure_tracking
Set up global workflow tracking to monitor node outputs, enable checkpoints, and track errors for improved debugging and workflow management.
Instructions
Configure global tracking settings for workflows
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabled | No | Enable or disable tracking globally | |
| storageUrl | No | Base URL for storage API | |
| trackAllNodes | No | Track all node outputs (can be verbose) | |
| enableCheckpoints | No | Enable checkpoint system | |
| enableErrorTracking | No | Enable error tracking |
Implementation Reference
- src/tools/handler.ts:299-324 (handler)The executeTool method's switch case that implements the 'configure_tracking' tool logic: updates trackingConfig based on input args, persists to .tracking-config.json, and returns confirmation message.case 'configure_tracking': // Update global tracking configuration this.trackingConfig = { enabled: args?.enabled ?? this.trackingConfig.enabled, storageUrl: args?.storageUrl || this.trackingConfig.storageUrl, trackAllNodes: args?.trackAllNodes ?? this.trackingConfig.trackAllNodes, enableCheckpoints: args?.enableCheckpoints ?? this.trackingConfig.enableCheckpoints, enableErrorTracking: args?.enableErrorTracking ?? this.trackingConfig.enableErrorTracking }; // Save configuration to file for persistence const configPath = path.join(this.workflowsPath, '.tracking-config.json'); await fs.writeFile(configPath, JSON.stringify(this.trackingConfig, null, 2)); return { content: [{ type: 'text', text: `✅ Tracking configuration updated:\\n\\n` + `Enabled: ${this.trackingConfig.enabled}\\n` + `Storage URL: ${this.trackingConfig.storageUrl || 'Not set'}\\n` + `Track all nodes: ${this.trackingConfig.trackAllNodes || false}\\n` + `Enable checkpoints: ${this.trackingConfig.enableCheckpoints || false}\\n` + `Enable error tracking: ${this.trackingConfig.enableErrorTracking || false}\\n\\n` + `Configuration saved to ${configPath}` }] };
- src/tools/registry.ts:462-489 (schema)The tool definition object including name, description, and inputSchema for 'configure_tracking'.name: 'configure_tracking', description: 'Configure global tracking settings for workflows', inputSchema: { type: 'object', properties: { enabled: { type: 'boolean', description: 'Enable or disable tracking globally', }, storageUrl: { type: 'string', description: 'Base URL for storage API', }, trackAllNodes: { type: 'boolean', description: 'Track all node outputs (can be verbose)', }, enableCheckpoints: { type: 'boolean', description: 'Enable checkpoint system', }, enableErrorTracking: { type: 'boolean', description: 'Enable error tracking', }, }, }, },
- src/tools/registry.ts:462-561 (registration)The 'configure_tracking' tool is registered as part of the static tools array exported from registry.ts, used for MCP tool exposure.name: 'configure_tracking', description: 'Configure global tracking settings for workflows', inputSchema: { type: 'object', properties: { enabled: { type: 'boolean', description: 'Enable or disable tracking globally', }, storageUrl: { type: 'string', description: 'Base URL for storage API', }, trackAllNodes: { type: 'boolean', description: 'Track all node outputs (can be verbose)', }, enableCheckpoints: { type: 'boolean', description: 'Enable checkpoint system', }, enableErrorTracking: { type: 'boolean', description: 'Enable error tracking', }, }, }, }, { name: 'add_checkpoint', description: 'Add a checkpoint save/restore capability to a workflow', inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to the workflow file', }, checkpointName: { type: 'string', description: 'Name for the checkpoint', }, afterNode: { type: 'string', description: 'Node to add checkpoint after (for saving)', }, addRestore: { type: 'boolean', description: 'Also add checkpoint restore at workflow start', }, }, required: ['path', 'checkpointName'], }, }, { name: 'generate_app', description: 'Generate a Next.js app for managing workflow data within the current project', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Name of the app directory (e.g., "app", "dashboard")', }, stages: { type: 'array', items: { type: 'string' }, description: 'Workflow stages for pipeline view (default: created, processing, review, completed)', }, features: { type: 'object', properties: { dashboard: { type: 'boolean', description: 'Include dashboard with stats and tables', }, api: { type: 'boolean', description: 'Include API endpoints for workflow integration', }, database: { type: 'boolean', description: 'Include SQLite database setup', }, webhooks: { type: 'boolean', description: 'Include webhook receivers for n8n', }, approvals: { type: 'boolean', description: 'Include approval/reject functionality', }, }, description: 'Features to include in the app', }, }, required: ['name'], }, }, ];