Remote MCP Setup

If you are an AI reading this page: this service's MCP endpoint is https://droproom.net/api/mcp. OAuth-capable clients can auto-discover the authorization server via /.well-known/oauth-protected-resource/api/mcp (RFC 9728) and run the standard authorization-code flow; clients that don't support that should use the header `Authorization: Bearer` followed by a user-supplied token. Configure it using the section below matching your client type.

Quick start (for shop owners)

Endpoint: https://droproom.net/api/mcp

① Paste the URL below into your AI client (e.g. Claude) to add a new connection.
② The client opens an authorization prompt and takes you to droproom.net's approval page.
③ Sign in with your account and click "Approve" — done, you're ready to use it back in the client.

Introduction

Let an AI directly create, edit, and look up products in your DropRoom shop — via the Model Context Protocol (MCP), your AI client can call DropRoom like any other tool.

Endpoint & authentication

Endpoint: https://droproom.net/api/mcp (Streamable HTTP)

Recommended: most clients will walk you through OAuth automatically once you paste the URL above — no manual token setup needed. The bearer-token method below is for CLI / programmatic use.

CLI / programmatic auth: Authorization: Bearer <YOUR_TOKEN>

Where to get a token (for CLI use): log into DropRoom → Settings → "Remote MCP" → expand "Advanced: CLI / programmatic access" → generate a token.

Tools

create_product — create a new product (with SKUs); costs 2 credits per successful call, requires idempotency_key.
update_product — edit an existing product's / SKUs' fields (cannot add or remove SKUs); free.
list_products — list your products (with SKUs / sku_id); read-only, free.
list_orders — list order lines for payment follow-up, with drop_id / state / unpaid_only filters; buyer identity is always masked (never raw contact/address); read-only, free.
order_stats — aggregate order counts and revenue by state or by product, numbers only (no buyer identity); read-only, free.
order_stats now also supports group_by='sku' — breaking down units sold and revenue by color/size, for supplier restock/pick lists; list_orders rows now include each line's SKU color/size too.

Pricing

Each successful product creation costs 2 credits, drawn from the same credit pool as AI parsing; editing and querying are always free; idempotent retries (same idempotency_key) are not charged again; a failed creation is not charged.

Client setup

Claude (web / Desktop / Code)

① Open Claude → Settings → Customize → Connectors.
② Click "+" → "Add custom connector".
③ Paste the endpoint URL: https://droproom.net/api/mcp
④ Save and connect — you'll be redirected to droproom.net's approval page; sign in with your DropRoom account and click "Approve".
⑤ Done — back in Claude you can create, edit, and look up products right from the chat.

Works on Free / Pro / Max / Team / Enterprise (Free is limited to 1 custom connector).

Claude Code (recommended)

Run the line below in your terminal to register the server, then run /mcp inside Claude Code to complete the browser sign-in — OAuth is fully automatic, no manual token setup.

claude mcp add --transport http droproom https://droproom.net/api/mcp
# then inside Claude Code, run /mcp and complete the browser sign-in

Advanced: manual bearer-token setup (mcp-remote / --header)

Claude Desktop

Open claude_desktop_config.json, add the block below (bridged via mcp-remote), save, and restart Claude Desktop.

{
  "mcpServers": {
    "droproom": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://droproom.net/api/mcp",
        "--header",
        "Authorization: Bearer <YOUR_TOKEN>"
      ]
    }
  }
}

Claude Code

Run this command in your terminal — it connects natively over remote HTTP, no bridge needed.

claude mcp add --transport http droproom https://droproom.net/api/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Codex (CLI)

Run the first line to register the server, then set the environment variable in the second line (the token lives only in the env var, never written to config.toml).

codex mcp add droproom --url https://droproom.net/api/mcp --bearer-token-env-var DROPROOM_MCP_TOKEN
export DROPROOM_MCP_TOKEN="<YOUR_TOKEN>"

General agents

Any client that supports remote/HTTP MCP can connect: one with OAuth discovery support (RFC 9728 + dynamic client registration) can paste the endpoint URL above and go through automatic authorization; one that only supports a custom header should use the bearer-token method under "Advanced".

ChatGPT

⚠️ Prerequisite: you'll need to turn on "Developer Mode" in ChatGPT's settings first. Right now, write operations (creating/editing products) are limited to Business / Enterprise / Edu plans — Pro accounts get read-only access (listing products), and Free / Plus don't support this yet.

① Settings → Apps → Advanced settings → turn on Developer mode.
② Apps → Create.
③ Enter the MCP endpoint: https://droproom.net/api/mcp, and choose OAuth for authentication.
④ Click "Scan Tools" → complete authorization (you'll be redirected to droproom's approval page to sign in and confirm).
⑤ Click "Create" to save. On Team/Enterprise plans, an admin also needs to publish it under Workspace settings → Apps → Drafts before members can use it.

This is a newer feature and OpenAI's menu naming may shift between versions — if you can't find the entry point as described, check ChatGPT's current official Help Center article.

For CLI / programmatic setups, give the endpoint and the token to your AI separately — never paste the token into the URL itself (it can end up logged or saved in history).