Knowledge Base

Connecting the Seller Labs MCP Server via Claude Code app

Last updated:

🎬 Watch the 1-minute video version: You NEED This AI Tool (Short)

What’s the Seller Labs MCP Server — and why does it matter?

Think of the MCP Server as the bridge between your Amazon data and Claude.

It lets your AI assistant access real-time business data — safely and securely — without needing your Amazon login.

With the MCP Server connected, you can ask Claude questions like:

  • “What SKUs dropped in profit last week?”
    ​

  • “Which keywords are driving the most conversions this month?”
    ​

  • “How did my ad spend impact margin across top ASINs?”
    ​

Claude will instantly pull the data, analyze it, and give you clear answers — with charts, summaries, or SQL-style results if needed.

⚙️ Step-by-Step: How to Connect Seller Labs MCP Server using Claude Code app.

This guide explains how to connect the Seller Labs MCP server to Claude Code with OAuth authentication.

Prerequisites

  • Claude Code CLI installed

  • Access to Seller Labs Ignite API with valid credentials

Step 1: Add MCP Server Configuration

Edit your ~/.claude.json file (create it if it doesn’t exist) and add the MCP server configuration:

{
  "mcpServers": {
    "sellerlabs": {
      "type": "http",
      "url": "https://ignite-api.sellerlabs.com/mcp",
      "oauth": {
        "authorizationUrl": "https://ignite-api.sellerlabs.com/oauth2/authorize",
        "tokenUrl": "https://ignite-api.sellerlabs.com/oauth2/token",
        "scopes": [
          "openid",
          "mcp",
          "offline_access",
          "execute_sql",
          "get_org_info"
        ]
      }
    }
  }
}

The claude mcp add command does not support OAuth-specific parameters (authorizationUrl, tokenUrl, scopes).
It only supports basic HTTP server setup.

To add the base entry first, run:

claude mcp add --transport http --scope user sellerlabs https://ignite-api.sellerlabs.com/mcp

Then manually edit ~/.claude.json to add:

"oauth": {
  "authorizationUrl": "https://ignite-api.sellerlabs.com/oauth2/authorize",
  "tokenUrl": "https://ignite-api.sellerlabs.com/oauth2/token",
  "scopes": ["openid", "mcp", "offline_access", "execute_sql", "get_org_info"]
}

OAuth Field Details

  • authorizationUrl — URL where the user logs in

  • tokenUrl — URL where Claude exchanges auth codes for tokens

  • scopes:

    • openid: Basic user identity

    • mcp: Access to MCP server

    • offline_access: Allows refresh tokens

    • execute_sql: Permission to run SQL queries

    • get_org_info: Permission to retrieve organization information

Step 2: Restart Claude Code

After updating the config file:

  1. Exit Claude Code

  2. Start a new session

Step 3: Verify Server Configuration

Run:

claude mcp list

Expected output:

sellerlabs: https://ignite-api.sellerlabs.com/mcp (HTTP) - ⚠ Needs authentication

Step 4: Authenticate with OAuth

In Claude Code, type:

/mcp

This will:

  1. Open the MCP management menu

  2. Display the SellerLabs server

  3. Launch a browser window for OAuth login

  4. Prompt you to log in with SellerLabs credentials

  5. Return you to Claude Code after authentication

You should see:

Authentication successful. Connected to sellerlabs.

Step 5: Verify Connection

Run:

claude mcp get sellerlabs

Or test it directly in Claude Code:

Show me my venues

Available MCP Tools

1. execute_sql

Run SQL queries on your organization’s SellerLabs database.

  • Supports: SELECT, SHOW TABLES, DESCRIBE, EXPLAIN, SET

  • Example:

    SELECT * FROM venues LIMIT 10;

2. get_org_info

Retrieve organization metadata, such as org ID, venues, and related details.

Troubleshooting

Server shows “Needs authentication”

  • Run /mcp and complete the browser login

  • Confirm OAuth config is correct in .claude.json

OAuth flow doesn’t open a browser

  • Check OAuth config

  • Restart Claude Code

  • Try /mcp again

Authentication expires

  • offline_access allows automatic refresh

  • If needed:

    • Go to /mcp

    • Select the Seller Labs server

    • Choose Clear authentication

Can’t see the MCP server

  • Validate JSON syntax

  • Ensure the file is located at ~/.claude.json

  • Restart Claude Code

Managing Authentication

To clear or reset authentication:

  1. Type /mcp

  2. Select sellerlabs

  3. Choose Clear authentication

  4. Reauthenticate when prompted

Security Notes

  • OAuth tokens are securely stored

  • Refresh tokens extend session life automatically

  • offline_access minimizes reauthentication

  • You may revoke access using the /mcp menu

Ready to start? Once your MCP server is connected, check out our 55 Claude Prompts for Your Seller Labs MCP Server — copy-paste prompts for advertising, profitability, inventory, reviews, and more.

Need help? Our support team is happy to assist you!🙂

*No Credit Card Needed