Windsurf

Connect Ned to Windsurf (by Codeium) so you can query your Shopify data while you code.

What You'll Need

• Windsurf installed
• A Ned AI API key
• Node.js 18+ installed

Step 1: Get Your API Key

1. Go to app.meetned.com
2. Open Settings → Developer
3. Click Create API Key
4. Copy the key

Step 2: Open MCP Settings

1. Open Windsurf
2. Click the Cascade icon (the AI assistant panel)
3. Click the hammer icon or go to Settings → MCP

Step 3: Add the Ned Server

Click Add Server and enter:

{
  "ned": {
    "command": "npx",
    "args": ["@ned-ai/mcp-server"],
    "env": {
      "NED_API_KEY": "ned_live_YOUR_API_KEY_HERE"
    }
  }
}

Alternatively, add it to your ~/.codeium/windsurf/mcp_config.json file:

{
  "mcpServers": {
    "ned": {
      "command": "npx",
      "args": ["@ned-ai/mcp-server"],
      "env": {
        "NED_API_KEY": "ned_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

Step 4: Verify It Works

Open Cascade and ask:

• "What are my sales today?"
• "How did my store perform last week?"

Windsurf will call the Ned tools and show your store data.

Step 5: Try These Prompts

• "Check my revenue this month and help me build a sales dashboard"
• "What's my most profitable product? Show me its data"
• "Pull my marketing metrics and suggest optimizations"

Troubleshooting

Server doesn't appear

• Make sure Node.js is installed: node --version
• Try running the command manually: npx @ned-ai/mcp-server --version
• Restart Windsurf after adding the config

"Authentication failed"

• Verify your API key starts with ned_live_
• Check for extra spaces around the key
• Make sure the key hasn't been revoked in Settings → Developer

Need Help?

• GitHub Issues
• Ned Support