Cursor IDE Integration

Integrate Tetrix AI with Cursor IDE to get intelligent code assistance that understands your entire software system. This guide will help you set up the connection in just a few minutes.

Prerequisites

Before you begin, make sure you have:

✅ Cursor IDE installed (Download here )
✅ Node.js 18+ installed on your system
✅ A project open in Cursor (recommended for testing)

Step-by-Step Setup

Step 1: Open Cursor Settings

Open Cursor IDE
Access Settings using one of these methods:
- Press Cmd/Ctrl + ,
- Go to File → Preferences → Settings (Windows/Linux)
- Go to Cursor → Preferences → Settings (macOS)

Step 2: Navigate to MCP Settings

Search for “MCP” in the settings search bar
Look for “MCP Servers” or “Model Context Protocol” section
Click on “Edit in settings.json” if available

Step 3: Add Tetrix AI Configuration

Add the Tetrix AI MCP server to your Cursor configuration:


{
  "mcp": {
    "servers": {
      "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"
        ]
      }
    }
  }
}

Alternative: If you already have MCP servers configured:


{
  "mcp": {
    "servers": {
      "existing-server": {
        "command": "existing-command",
        "args": ["existing-args"]
      },
      "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 Cursor

Save your settings (Cmd/Ctrl + S)
Restart Cursor IDE completely
Reopen your project

Step 5: Verify Connection

To verify that Tetrix AI is working:

Open a code file in your project
Start a chat with Cursor’s AI (usually Cmd/Ctrl + L)
Ask about your project - Try something like: “What can you tell me about this codebase?”

Cursor-Specific Features

With Tetrix AI integrated into Cursor, you get enhanced capabilities:

🔍 Intelligent Code Completion

Context-aware suggestions based on your entire codebase
Cross-file understanding that considers related files
Architecture-aware recommendations that fit your project structure

🏗️ Project Analysis

Codebase overview - Understand your project’s architecture
Dependency analysis - See how components connect
Technical debt identification - Find areas for improvement

⚡ Development Workflow

Smart refactoring - Get suggestions that consider the entire system
Bug detection - Identify potential issues across files
Performance optimization - Find bottlenecks and optimization opportunities

Example Use Cases in Cursor

Code Review and Analysis


"Review this component and suggest improvements considering the overall architecture"

Refactoring Assistance


"Help me refactor this function to better fit the existing codebase patterns"

Debugging Help


"This error is occurring - can you analyze the related code to find the root cause?"

Architecture Guidance


"I'm adding a new feature - what's the best way to integrate it with the existing code?"

Troubleshooting

Common Issues

Problem: Cursor doesn’t recognize the MCP server

✅ Check JSON syntax - Ensure configuration is valid JSON
✅ Restart Cursor - Close completely and reopen
✅ Check Node.js - Ensure Node.js 18+ is installed

Problem: Connection timeout errors

✅ Check internet connection - MCP server requires internet access
✅ Firewall settings - Ensure outbound HTTP connections are allowed
✅ Try again - Initial connection may take 30-60 seconds

Problem: Features not working as expected

✅ Wait for initialization - Give the server time to connect
✅ Check project context - Ensure you have a project open
✅ Restart connection - Reload Cursor settings

Configuration Validation

Validate your MCP configuration with this checklist:

✅ Valid JSON format - No syntax errors
✅ Correct indentation - Proper JSON structure
✅ Quoted strings - All strings in double quotes
✅ Proper nesting - Configuration under correct sections

Advanced Configuration

Custom Environment Variables


{
  "mcp": {
    "servers": {
      "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": {
          "DEBUG": "true",
          "LOG_LEVEL": "info"
        }
      }
    }
  }
}

Working Directory


{
  "mcp": {
    "servers": {
      "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"
        ],
        "cwd": "/path/to/your/project"
      }
    }
  }
}

Best Practices for Cursor + Tetrix AI

1. Project Context

Keep projects organized - Well-structured projects get better analysis
Use clear naming - Descriptive file and function names help AI understanding
Maintain documentation - Comments and README files improve context

2. Effective Queries

Be specific - Ask about particular files or components
Provide context - Mention what you’re trying to achieve
Ask follow-up questions - Build on previous responses

3. Workflow Integration

Start conversations in relevant files - Open the file you’re working on
Use project-wide queries - Ask about overall architecture when needed
Combine with Cursor’s features - Use alongside Cursor’s native AI capabilities

Next Steps

Now that you have Tetrix AI integrated with Cursor:

Explore your codebase - Ask questions about your project structure
Try different query types - Test code analysis, debugging, and refactoring
Learn advanced features - Check out our Capabilities guide
Optimize your workflow - Review Configuration for advanced options

You’re all set! 🎉 Tetrix AI is now integrated with Cursor IDE, giving you intelligent assistance that understands your entire software system.