Skip to main content

Nova Connect

Nova Connect enables seamless integration with your favorite AI tools and code editors, bringing Nova's powerful infrastructure capabilities directly into your existing workflow.

🎯 Quick Start: Choose your preferred tool below and follow the 3-step setup process. Most integrations take less than 5 minutes!

🚀 Quick Start Guide​

1️⃣ Get Your API Key

Visit astropulse.io/get-started to generate your API key

2️⃣ Choose Your Tool

Select from Claude Desktop, Cursor, VS Code, or Claude Code CLI

3️⃣ Copy & Configure

Use our ready-to-paste configurations below - just replace your API key!

📱 Choose Your Integration​

⭐ Easiest

Claude Desktop

Native Claude experience with visual MCP configuration

Setup Claude Desktop →
🔥 Popular

Cursor AI Editor

AI-powered code editor optimized for infrastructure

Setup Cursor →
💻 Developer

Claude Code CLI

Terminal-based AI assistance for command-line users

Setup CLI →

VS Code + Continue

Integrate with Visual Studio Code via Continue extension

Setup VS Code →

🖥️ Integration Setup Guides​

Claude Desktop​

⭐ Easiest Setup⏱️ 3 minutes

The native Claude experience with seamless MCP integration.

1

Install Claude Desktop

Download from claude.ai/download

2

Open MCP Settings

Go to Settings → MCP Servers → Add Server

3

Paste Configuration

Copy and paste the configuration below:

Claude Desktop Configuration
$ 
{
  "mcpServers": {
      "mcp-server-astroplatform": {
          "command": "docker",
          "args": [
              "run", "--rm", "-i",
              "-v", "LOCAL_VOLUME_PATH:/opt/nova",
              "-e", "ASTROPULSE_API_KEY=YOUR_API_KEY_HERE",
              "astropulseinc/mcp-server-astroplatform"
          ]
      }
  }
}

📝 Configuration Notes:

  • ✅ Replace YOUR_API_KEY_HERE with your API key from astropulse.io
  • 💾 Optional: Replace LOCAL_VOLUME_PATH with a directory on YOUR computer where you want to save settings (e.g., /Users/username/nova-config on Mac, C:\Users\username\nova-config on Windows)
  • 🔄 Without the volume mount, settings reset when restarting (you can remove the -v line if not needed)

📚 Documentation | ⬇️ Download

Cursor AI Editor​

🔥 Popular Choice⏱️ 5 minutes

AI-powered code editor with built-in infrastructure capabilities.

1

Install Cursor

Download from cursor.sh

2

Create Configuration File

Create .cursor/mcp.json in your project root
OR ~/.cursor/mcp.json for global config

3

Add Configuration

Copy the configuration below into the file:

.cursor/mcp.json
$ 
{
  "mcpServers": {
      "mcp-server-astroplatform": {
          "command": "docker",
          "args": [
              "run", "--rm", "-i",
              "-v", "LOCAL_VOLUME_PATH:/opt/nova",
              "-e", "ASTROPULSE_API_KEY=YOUR_API_KEY_HERE",
              "astropulseinc/mcp-server-astroplatform"
          ]
      }
  }
}

💡 Pro Tip: After loading MCP, access http://localhost:12980/config to configure AI models for Kubernetes analysis

For maximum privacy and performance with Kubernetes analysis:

Install Ollama and Models
$ # Install Ollama
brew install ollama  # macOS
# or visit https://ollama.com/download for other OS

# Pull recommended models
ollama pull deepseek-r1:latest      # Best for K8s analysis
ollama pull all-MiniLM-L6-v2        # Required for RAG

📚 Documentation | ⬇️ Download

Claude Code CLI​

💻 For Terminal Users⏱️ 2 minutes

Command-line interface for Claude with MCP support.

1

Install Claude Code

Visit anthropic.com/claude-code for installation

2

Add MCP Server

Run one of these commands in your terminal:

Basic Setup (No persistence)
$ claude mcp add-json mcp-server-astroplatform '{"command":"docker","args":["run","--rm","-i","-e","ASTROPULSE_API_KEY=YOUR_ASTROPLATFORM_API_KEY","astropulseinc/mcp-server-astroplatform:latest"]}'
With Settings Persistence (Recommended)
$ claude mcp add-json mcp-server-astroplatform '{"command":"docker","args":["run","--rm","-i","-e","ASTROPULSE_API_KEY=YOUR_ASTROPLATFORM_API_KEY","-v","LOCAL_VOLUME_PATH:/opt/nova","astropulseinc/mcp-server-astroplatform:latest"]}'

📝 Quick Notes:

  • Replace YOUR_API_KEY_HERE with your actual API key
  • The second command preserves your K8s analyzer settings between sessions
  • Use claude mcp list to verify the server was added

📚 Documentation | ⬇️ Download

VS Code + Continue​

⏱️ 5 minutes

Integrate Nova with Visual Studio Code using the Continue extension.

1

Install Continue Extension

Search for "Continue" in VS Code Extensions or install from marketplace

2

Open VS Code Settings

Press Cmd+, (Mac) or Ctrl+, (Windows/Linux)
Click the icon for settings.json

3

Add Configuration

Add this to your settings.json:

VS Code settings.json
$ 
{
"experimental": {
  "modelContextProtocolServer": {
    "transport": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "/Users/YOUR_USERNAME/nova-config:/opt/nova",
        "-e", "ASTROPULSE_API_KEY=YOUR_API_KEY_HERE",
        "astropulseinc/mcp-server-astroplatform"
      ]
    }
  }
}
}

📚 Documentation | ⬇️ Download Extension

🔧 Advanced Options​

SSE Mode (Browser/Custom Integrations)​

For direct browser access or custom integrations:

Run MCP Server in SSE Mode
$ docker run --rm -p 8123:8000 -e ASTROPULSE_API_KEY=YOUR_API_KEY_HERE -v ~/nova-config:/opt/nova astropulseinc/mcp-server-astroplatform --transport sse --port 8000

Access Points:

  • 🌐 SSE Endpoint: http://localhost:8123/sse
  • ⚙️ K8s Analyzer Config: http://localhost:8123

💡 Understanding the Configuration​

What Each Part Does:

ASTROPULSE_API_KEY

🔑 Your authentication key from astropulse.io/get-started

LOCAL_VOLUME_PATH

💾 Optional but recommended: A directory on YOUR local machine to persist settings

  • This is YOUR computer's directory (not the container's)
  • Without it: Settings reset each time container restarts
  • With it: Your K8s analyzer model choices persist
  • Mac example: /Users/yourusername/nova-config
  • Windows example: C:\Users\yourusername\nova-config
  • Linux example: /home/yourusername/nova-config
docker run flags

🐳 Standard Docker options:

  • --rm - Clean up container after exit
  • -i - Keep interactive connection
  • -v - Mount local directory (optional)
  • -e - Set environment variables

🚀 What Can You Do With Nova Connect?​

Once configured, you can:

🔍 Analyze Kubernetes

Get insights into cluster health, pod issues, and resource usage

🛠️ Debug Infrastructure

Troubleshoot deployment failures and configuration issues

📊 Monitor Resources

Track CPU, memory, and storage across your clusters

🤖 AI-Powered Fixes

Get intelligent recommendations for infrastructure problems

❓ Troubleshooting​

🔴 "Unauthorized" Error

Your API key may be invalid or expired. Generate a new one at astropulse.io/get-started

🔴 Docker Not Found

Install Docker from docker.com and ensure it's running

🔴 Connection Timeout

Check your network connection and firewall settings. Ensure Docker has network access.

🔴 Settings Not Persisting

Add the volume mount (-v flag) to your configuration. Make sure the local directory exists and has write permissions.

🔴 MCP Server Not Found

Ensure Docker is running and the mcp-server-astroplatform image can be pulled. Check your internet connection.

🔴 Rate Limit Exceeded

You've reached your API call limit. Wait a few minutes or upgrade your plan at astropulse.io

🎯 Best Practices​

🔐 Security

  • Never commit API keys to version control
  • Use environment variables for production
  • Rotate keys periodically

🎨 Local Models

  • Use Ollama for privacy-sensitive data
  • Install deepseek-r1:latest for best K8s analysis
  • Keep models updated regularly

⚡ Performance

  • Mount volumes for persistent settings
  • Use local models for faster responses
  • Monitor API usage in dashboard

🔮 Coming Soon​

Coming Soon

OpenAI Integration

GPT-4 powered infrastructure analysis

Coming Soon

JetBrains IDEs

IntelliJ, PyCharm, and WebStorm support

Coming Soon

Astro Control

Native AI integration for infrastructure

Need Help?

Join our Discord community or check the full documentation