MCP Server

Connect Ned AI to Claude Desktop and other AI assistants using the Model Context Protocol (MCP).

What is MCP?

The Model Context Protocol allows AI assistants like Claude to access external tools and data sources. With the Ned MCP server, you can ask Claude natural language questions about your Shopify data.

Installation

# Run directly
npx @ned-ai/mcp-server

# Or install globally
npm install -g @ned-ai/mcp-server

Claude Desktop Setup

1. Create an API Key

1. Go to app.meetned.com → Settings → Developer
2. Click Create API Key
3. Copy the key (you'll need it in step 3)

2. Find Your Config File

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

3. Add the Ned MCP Server

Edit claude_desktop_config.json:

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

4. Restart Claude Desktop

Quit and reopen Claude Desktop. You should see "ned" in the MCP servers list.

Available Tools

Once connected, Claude can use these tools:

get_sales_context

Get sales metrics for a time period.

Example prompts:

• "What are my sales today?"
• "How did last week compare to the week before?"
• "Show me my top products this month"

get_profitability

Get profit metrics and product profitability.

Example prompts:

• "What's my gross margin this month?"
• "Which products are most profitable?"
• "Show me my profitability summary"

get_customer_summary

Get customer analytics and segments.

Example prompts:

• "How many new customers did I get this week?"
• "What's my average customer lifetime value?"
• "Show me customer segments"

get_marketing_metrics

Get marketing efficiency metrics.

Example prompts:

• "What's my MER for the last 30 days?"
• "How is my ad spend performing?"
• "Show me ROAS by channel"

get_forecast (Growth tier)

Get revenue forecasts.

Example prompts:

• "What's my projected revenue for next month?"
• "Show me the sales forecast"

Example Conversations

Daily Check-in

You: How's business doing today?

Claude: Let me check your sales data...

Today you've made $1,234 in revenue from 12 orders, with an average order value of $102.83. That's up 15% compared to yesterday.

Your top seller today is the "Premium Widget" with 4 units sold.

Weekly Analysis

You: Give me a summary of last week's performance

Claude: Here's your weekly summary:

Revenue: $8,450 (↑ 12% vs prior week) Orders: 67 (↑ 8%) AOV: $126.12 (↑ 4%)

Top Products:

1. Premium Widget - $2,100
2. Standard Widget - $1,450
3. Widget Accessory Pack - $890

Your MER was 4.2, meaning you made $4.20 for every $1 spent on ads.

Marketing Deep Dive

You: How are my Meta ads performing?

Claude: Your Meta ads over the last 30 days:

Spend: $5,200 Revenue: $19,800 ROAS: 3.81

Your best performing campaign is "Summer Sale 2025" with a 4.2 ROAS. The "Lookalike - Purchasers" ad set is outperforming your interest-based targeting.

Troubleshooting

"MCP server not found"

Make sure npx can find the package:

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

"Authentication failed"

1. Verify your API key is correct
2. Check the key hasn't been revoked
3. Ensure no extra spaces in the config

"Tool call failed"

Check Claude Desktop logs:

• macOS: ~/Library/Logs/Claude/
• Windows: %APPDATA%\Claude\logs\

Need help?

• GitHub Issues
• Ned Support