Skip to Content

Prerequisites

Before connecting to Tetrix AI MCP Server, ensure your system meets these requirements for optimal performance and compatibility.

System Requirements

Node.js Environment

Required: Node.js 18 or higher

Tetrix AI MCP Server uses npx to dynamically download and run the MCP client, which requires a modern Node.js environment.

# Check your Node.js version
node --version
 
# Should show v18.0.0 or higher

Installation Options:

macOS:

# Using Homebrew (recommended)
brew install node
 
# Using Node Version Manager (nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

Windows:

# Using Chocolatey
choco install nodejs
 
# Or download from nodejs.org

Linux (Ubuntu/Debian):

# Using NodeSource repository
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
 
# Using snap
sudo snap install node --classic

Internet Connectivity

Required: Stable internet connection

  • Download Speed: Minimum 10 Mbps recommended
  • Latency: Low latency preferred for real-time responses
  • Firewall: Must allow outbound HTTP connections on port 80
  • Proxy: If using corporate proxy, ensure it supports HTTP requests

Test Connectivity:

# Test basic internet connection
ping google.com
 
# Test Tetrix AI endpoint specifically
curl -I http://tetrix-level-1-dev-alb-463220232.us-east-1.elb.amazonaws.com/mcp

MCP-Compatible AI Platform

Choose one or more of these supported platforms:

Claude Desktop

Status: ✅ Fully Supported Requirements:

  • Claude Desktop app installed
  • Configuration file access
  • macOS, Windows, or Linux

Download: claude.ai/desktop 

Cursor IDE

Status: ✅ Fully Supported Requirements:

  • Cursor IDE installed
  • MCP settings access
  • Any operating system

Download: cursor.sh 

ChatGPT Desktop

Status: ✅ Supported Requirements:

  • ChatGPT Desktop app
  • MCP configuration support
  • macOS or Windows

CLINE

Status: ✅ Supported Requirements:

  • VS Code with CLINE extension
  • MCP server configuration
  • Any operating system

Custom MCP Clients

Status: ✅ Supported Requirements:

  • MCP protocol support
  • HTTP transport capability
  • Configuration management

Development Tools

Git (Optional but helpful):

# Check if Git is installed
git --version
 
# Install if needed (macOS)
brew install git
 
# Install if needed (Ubuntu/Debian)
sudo apt install git

curl (For testing):

# Usually pre-installed, but verify
curl --version
 
# Install if needed (Ubuntu/Debian)
sudo apt install curl

System Performance

RAM: 4GB minimum, 8GB recommended Storage: 1GB free space for Node.js modules CPU: Any modern processor (x64 or ARM64)

Network Configuration

Corporate Networks

If you’re on a corporate network, ensure:

Firewall Rules:

  • Allow outbound HTTP on port 80
  • Allow access to tetrix-level-1-dev-alb-463220232.us-east-1.elb.amazonaws.com
  • Allow npm/npx package downloads

Proxy Configuration:

# If using HTTP proxy, configure npm
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
 
# Or set environment variables
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

Security Considerations

Outbound Connections:

  • Tetrix AI MCP Server uses HTTP (not HTTPS) for the public endpoint
  • No sensitive data is transmitted - only query responses
  • Consider network monitoring if required by your organization

Verification Steps

Before proceeding with setup, verify all prerequisites:

1. Node.js Check

node --version && npm --version && npx --version

Expected: All commands should return version numbers

2. Network Check

curl -I http://tetrix-level-1-dev-alb-463220232.us-east-1.elb.amazonaws.com/mcp

Expected: HTTP response headers (200 OK or similar)

3. AI Platform Check

  • Ensure your chosen AI platform is installed and running
  • Verify you can access configuration settings
  • Confirm MCP support is available

4. Permissions Check

# Verify you can install packages globally (optional)
npm list -g --depth=0
 
# Test npx functionality
npx --version

Common Issues and Solutions

Node.js Version Issues

Problem: node: command not found Solution: Install Node.js using your platform’s package manager

Problem: Node.js version too old Solution: Update to Node.js 18+ using nvm or reinstall

Network Issues

Problem: ECONNREFUSED errors Solution:

  • Check internet connection
  • Verify firewall settings
  • Test with different network if possible

Problem: Proxy blocking requests Solution: Configure npm proxy settings or contact IT

Permission Issues

Problem: EACCES errors with npm Solution:

# Fix npm permissions (macOS/Linux)
sudo chown -R $(whoami) ~/.npm

AI Platform Issues

Problem: Can’t find configuration file Solution: Check platform-specific documentation for config file locations

Problem: MCP not supported Solution: Verify you have the latest version of your AI platform

Ready for Setup?

Once all prerequisites are met, you can proceed with:

Need Help?

If you encounter issues with prerequisites:

System ready? Proceed to Connecting to Tetrix MCP for the complete setup process.

Last updated on
Platform Integrations