Claude Code (CLI)

Connect Ned to Claude Code so you can query your Shopify data directly from the terminal.

What You'll Need

• Claude Code 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: Add the Ned MCP Server

You have two options — pick whichever you prefer.

Option A: CLI Command (Quick)

Run this in your terminal:

claude mcp add ned -- npx @ned-ai/mcp-server

Then set the API key as an environment variable:

# macOS / Linux
export NED_API_KEY="ned_live_YOUR_API_KEY_HERE"

# Windows (PowerShell)
$env:NED_API_KEY = "ned_live_YOUR_API_KEY_HERE"

TIP

Add the export line to your ~/.bashrc or ~/.zshrc so it persists across sessions.

Option B: Project Config (Recommended for Teams)

Create a .mcp.json file in your project root:

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

WARNING

Don't commit .mcp.json with your real API key. Add it to .gitignore or use an environment variable reference instead.

Step 3: Verify It Works

Start Claude Code and ask it something:

claude "What are my sales today?"

Claude will use the Ned MCP tools to fetch your data and respond.

Step 4: Try These Prompts

• "How did last week compare to the week before?"
• "Which products are most profitable this month?"
• "What's my customer acquisition cost?"
• "Show me my revenue forecast"

Troubleshooting

"MCP server not found"

Check that npx can find the package:

npx @ned-ai/mcp-server --version

"Authentication failed"

• Verify NED_API_KEY is set: echo $NED_API_KEY
• Make sure the key starts with ned_live_ and hasn't been revoked

Need Help?

• GitHub Issues
• Ned Support