mirror of https://github.com/czlonkowski/n8n-mcp.git synced 2026-01-30 06:22:04 +00:00

Files

czlonkowski 09e69df5a7 feat: implement anonymous telemetry system with Supabase integration

Adds zero-configuration anonymous usage statistics to track:
- Number of active users with deterministic user IDs
- Which MCP tools AI agents use most
- What workflows are built (sanitized to protect privacy)
- Common errors and issues

Key features:
- Zero-configuration design with hardcoded write-only credentials
- Privacy-first approach with comprehensive data sanitization
- Opt-out support via config file and environment variables
- Docker-friendly with environment variable support
- Multi-process safe with immediate flush strategy
- Row Level Security (RLS) policies for write-only access

Technical implementation:
- Supabase backend with anon key for INSERT-only operations
- Workflow sanitization removes all sensitive data
- Environment variables checked for opt-out (TELEMETRY_DISABLED, etc.)
- Telemetry enabled by default but respects user preferences
- Cleaned up all debug logging for production readiness

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-09-26 09:06:19 +02:00

2.3 KiB

Raw Blame History

Privacy Policy for n8n-mcp Telemetry

Overview

n8n-mcp collects anonymous usage statistics to help improve the tool. This data collection is designed to respect user privacy while providing valuable insights into how the tool is used.

What We Collect

Anonymous User ID: A hashed identifier derived from your machine characteristics (no personal information)
Tool Usage: Which MCP tools are used and their performance metrics
Workflow Patterns: Sanitized workflow structures (all sensitive data removed)
Error Types: Categories of errors encountered (no error messages with user data)
System Information: Platform, architecture, Node.js version, and n8n-mcp version

What We DON'T Collect

Personal information or usernames
API keys, tokens, or credentials
URLs, endpoints, or hostnames
Email addresses or contact information
File paths or directory structures
Actual workflow data or parameters
Database connection strings
Any authentication information

Data Sanitization

All collected data undergoes automatic sanitization:

URLs are replaced with [URL] or [REDACTED]
Long alphanumeric strings (potential keys) are replaced with [KEY]
Email addresses are replaced with [EMAIL]
Authentication-related fields are completely removed

Data Storage

Data is stored securely using Supabase
Anonymous users have write-only access (cannot read data back)
Row Level Security (RLS) policies prevent data access by anonymous users

Opt-Out

You can disable telemetry at any time:

npx n8n-mcp telemetry disable

To re-enable:

npx n8n-mcp telemetry enable

To check status:

npx n8n-mcp telemetry status

Data Usage

Collected data is used solely to:

Understand which features are most used
Identify common error patterns
Improve tool performance and reliability
Guide development priorities

Data Retention

Data is retained for analysis purposes
No personal identification is possible from the collected data

Changes to This Policy

We may update this privacy policy from time to time. Updates will be reflected in this document.

Contact

For questions about telemetry or privacy, please open an issue on GitHub: https://github.com/czlonkowski/n8n-mcp/issues

Last updated: 2025-09-25

2.3 KiB Raw Blame History