Claude Desktop Integration

Connect Tetrix AI to Claude Desktop for powerful AI assistance that understands your entire software system. This guide will walk you through the setup process step by step.

Prerequisites

Before you begin, make sure you have:

✅ Claude Desktop installed (Download here )
✅ Node.js 18+ installed on your system
✅ Basic familiarity with JSON configuration files

Step-by-Step Setup

Step 1: Locate Claude Desktop Configuration

Claude Desktop stores its configuration in a specific location depending on your operating system:

macOS:


~/Library/Application Support/Claude/claude_desktop_config.json

Windows:


%APPDATA%\Claude\claude_desktop_config.json

Linux:


~/.config/Claude/claude_desktop_config.json

Step 2: Open Configuration File

Open your file manager or terminal
Navigate to the configuration directory for your OS (see above)
Open claude_desktop_config.json in your preferred text editor

If the file doesn’t exist, create it with an empty JSON object:

{}

Step 3: Add Tetrix AI MCP Server

Add the Tetrix AI MCP server configuration to your claude_desktop_config.json:


{
  "mcpServers": {
    "tetrix": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://tetrix-level-1-dev-alb-463220232.us-east-1.elb.amazonaws.com/mcp",
        "--transport",
        "http-only",
        "--allow-http"
      ]
    }
  }
}

Step 4: Restart Claude Desktop

Close Claude Desktop completely
Reopen Claude Desktop
Wait for the connection to establish (usually takes 10-30 seconds)

Step 5: Verify Connection

To verify that Tetrix AI is connected:

Start a new conversation in Claude Desktop
Ask Claude to list available tools or resources
Look for Tetrix AI in the response - you should see Tetrix-related capabilities

You can test the connection with a simple query like:

“What tools and resources do you have access to?”

What You Can Do Now

With Tetrix AI connected to Claude Desktop, you can:

🔍 Code Analysis

Analyze entire codebases - Get insights about your project structure
Understand dependencies - See how different parts of your code connect
Find patterns - Identify architectural patterns and potential improvements

🏗️ Infrastructure Insights

AWS resource analysis - Understand your cloud infrastructure
Cost optimization - Get recommendations for reducing AWS costs
Security assessment - Identify potential security issues

🤖 Expert Knowledge

Domain-specific advice - Get specialized knowledge for different technologies
Best practices - Learn industry best practices for your tech stack
Troubleshooting - Get help debugging complex issues

Example Queries

Try these example queries to get started:


"Analyze the architecture of my React application"


"What AWS resources am I using and how can I optimize costs?"


"Help me understand the dependencies in my Node.js project"


"Review my code for potential security vulnerabilities"

Troubleshooting

Connection Issues

Problem: Claude Desktop doesn’t recognize Tetrix AI

✅ Check configuration - Ensure JSON syntax is correct
✅ Restart Claude Desktop - Close completely and reopen
✅ Check internet connection - MCP server requires internet access

Problem: “Command not found” error

✅ Install Node.js - Make sure Node.js 18+ is installed
✅ Check PATH - Ensure npx is available in your system PATH

Performance Issues

Problem: Slow responses from Tetrix AI

✅ Check internet speed - Slow connection affects performance
✅ Simplify queries - Break complex questions into smaller parts
✅ Wait for initialization - First connection may take longer

Configuration Problems

Problem: JSON syntax errors

✅ Validate JSON - Use a JSON validator to check syntax
✅ Check commas - Ensure proper comma placement
✅ Quote strings - All strings must be in double quotes

Advanced Configuration

Multiple MCP Servers

If you’re using other MCP servers, add Tetrix AI alongside them:


{
  "mcpServers": {
    "tetrix": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://tetrix-level-1-dev-alb-463220232.us-east-1.elb.amazonaws.com/mcp",
        "--transport",
        "http-only",
        "--allow-http"
      ]
    },
    "other-server": {
      "command": "other-command",
      "args": ["other-args"]
    }
  }
}

Environment Variables

For advanced users, you can use environment variables in your configuration:


{
  "mcpServers": {
    "tetrix": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "http://tetrix-level-1-dev-alb-463220232.us-east-1.elb.amazonaws.com/mcp",
        "--transport",
        "http-only",
        "--allow-http"
      ],
      "env": {
        "CUSTOM_VAR": "value"
      }
    }
  }
}

Next Steps

Now that you have Tetrix AI connected to Claude Desktop:

Explore capabilities - Try different types of queries to see what’s possible
Learn advanced features - Check out our Capabilities guide
Optimize your setup - Review Configuration for advanced options
Get help - Visit our Troubleshooting guide if you need assistance

Setup complete! 🎉 You now have access to Tetrix AI’s system-wide intelligence directly in Claude Desktop.