Claude Desktop (macOS / Windows) — OAuth

1. Download from claude.com/download
2. Go to Settings → Developer → Edit Config to open claude_desktop_config.json
3. Paste the config below and save
4. Fully quit Claude Desktop (Cmd+Q / Alt+F4) and re-open it
5. On the first SellerSheet tool call a browser tab opens for Google authorization

{
  "mcpServers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_xxxxxxxxxxxx"
      }
    }
  }
}

Cursor — OAuth

Open Cursor Settings → MCP → Add new global MCP server, or edit ~/.cursor/mcp.json directly:

{
  "mcpServers": {
    "sellersheet": {
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

On the first tool call Cursor detects the 401, reads the OAuth metadata, and opens your browser for Google sign-in. The bearer token is stored in the Cursor keychain and reused for every future chat.

{
  "mcpServers": {
    "sellersheet": {
      "url": "https://sellersheetai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_xxxxxxxxxxxx"
      }
    }
  }
}

Windsurf — OAuth

Edit ~/.codeium/windsurf/mcp_config.json, or use Windsurf Settings → MCP Servers → Add Server. Note Windsurf uses serverUrl (not url):

{
  "mcpServers": {
    "sellersheet": {
      "serverUrl": "https://sellersheetai.com/mcp"
    }
  }
}

Restart Windsurf. The Google OAuth flow fires on the first tool call.

{
  "mcpServers": {
    "sellersheet": {
      "serverUrl": "https://sellersheetai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_xxxxxxxxxxxx"
      }
    }
  }
}

VS Code (GitHub Copilot Chat) — OAuth

VS Code 1.102+ has native MCP support for Agent Mode. Open the command palette and run MCP: Add Server, or add directly to your user settings.json:

{
  "chat.mcp.servers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

Open Copilot Chat, switch to Agent Mode, and VS Code will prompt you for Google OAuth on the first tool call.

{
  "chat.mcp.servers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_xxxxxxxxxxxx"
      }
    }
  }
}

OpenAI Codex CLI — OAuth

Add to ~/.codex/config.toml:

[[mcpServers]]
name = "sellersheet"
url  = "https://sellersheetai.com/mcp"

Or add inline without editing the file:

codex --mcp-server sellersheet=https://sellersheetai.com/mcp

A browser tab opens for Google OAuth the first time Codex calls a SellerSheet tool. The token is persisted under ~/.codex/auth/.

[[mcpServers]]
name = "sellersheet"
url  = "https://sellersheetai.com/mcp"

[mcpServers.headers]
Authorization = "Bearer sk_live_xxxxxxxxxxxx"

Cline (VS Code extension) — OAuth

Open the Cline panel → MCP Servers → Configure MCP Servers. Add to cline_mcp_settings.json:

{
  "mcpServers": {
    "sellersheet": {
      "type": "streamableHttp",
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

Click Restart Server — Cline will open your browser for Google authorization, then list every SellerSheet tool.

{
  "mcpServers": {
    "sellersheet": {
      "type": "streamableHttp",
      "url": "https://sellersheetai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_xxxxxxxxxxxx"
      }
    }
  }
}

ChatGPT (Custom Connectors / Deep Research) — OAuth

ChatGPT Team, Enterprise, Edu, and Pro plans support remote MCP servers as Custom Connectors (used by Deep Research and Agent mode).

1. Open ChatGPT → Settings → Connectors → Create Connector
2. Set MCP Server URL to https://sellersheetai.com/mcp
3. Set Auth type to OAuth
4. Save, then start a Deep Research chat and pick the sellersheet connector
5. ChatGPT redirects you through Google sign-in on the first call

Header name:  Authorization
Header value: Bearer sk_live_xxxxxxxxxxxx

Coze (ByteDance) — Manual API Key

Coze runs in its own cloud, so the browser OAuth redirect isn't available. Use a Bearer API key instead:

1. Get your API key from dashboard.sellersheetai.com → Settings → SellerSheet MCP → Generate API Key
2. In your Coze Bot → Skills → MCP Tool → Add MCP Tool
3. Select Connect via URL and enter https://sellersheetai.com/mcp
4. Add a custom header: Authorization: Bearer <your-api-key>
5. Save and publish the bot

{
  "name": "SellerSheet MCP",
  "url": "https://sellersheetai.com/mcp",
  "headers": {
    "Authorization": "Bearer sk_live_xxxxxxxxxxxx"
  }
}

The same pattern works for n8n, Dify, Make.com, Zapier, and any other headless AI platform.

OpenClaw — OAuth

Open Settings → MCP Servers → Add Remote Server and enter:

{
  "mcpServers": {
    "sellersheet": {
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

OpenClaw uses the same Google OAuth flow as Cursor — a browser tab opens on first use. No API key needed.

{
  "mcpServers": {
    "sellersheet": {
      "url": "https://sellersheetai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_xxxxxxxxxxxx"
      }
    }
  }
}

Any Other MCP Client

Any tool that speaks the MCP streamable HTTP transport can talk to SellerSheet. The universal config:

Test your API key with curl

Generate a key at dashboard.sellersheetai.com → Settings → SellerSheet MCP → Generate API Key, then:

export SELLERSHEET_API_KEY="sk_live_xxxxxxxxxxxx"

curl -sS https://sellersheetai.com/mcp \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A successful response lists every available SellerSheet tool with its JSON schema — feed that directly into your own agent framework.

Env-var substitution (recommended)

Most clients let you reference an env var instead of hard-coding the token so the key never lands in any config file:

{
  "mcpServers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${{SELLERSHEET_API_KEY}}"
      }
    }
  }
}

Then export the key in your shell profile: export SELLERSHEET_API_KEY=sk_live_xxxxxxxxxxxx. Restart the client so it picks up the env.