远程 MCP 接入

如果你是一个正在读这页的 AI：本服务 MCP 端点是 https://droproom.net/api/mcp。支持 OAuth 的客户端可通过 /.well-known/oauth-protected-resource/api/mcp（RFC 9728）自动发现鉴权服务器并走标准授权码流程；不支持的，用 header `Authorization: Bearer` 加用户提供的 token。按你所在客户端类型照下面对应段配置。

快速开始（团长上手）

端点： https://droproom.net/api/mcp

① 把下面这个网址粘贴进你的 AI 客户端（如 Claude），添加一个新连接。
② 客户端会弹出授权提示，跳转到 droproom.net 的授权页。
③ 用你的团长账号登录并点「同意」——完成，回到客户端就能用。

简介

让 AI 直接在你的 DropRoom 店里建 / 改 / 查商品 —— 通过 Model Context Protocol (MCP)，你的 AI 客户端可以像使用任何其它工具一样调用 DropRoom。

端点与鉴权

端点： https://droproom.net/api/mcp (Streamable HTTP)

推荐：多数客户端会在你粘贴上面这个网址后自动引导你完成 OAuth 授权，无需手动配置 token。下面的 Bearer token 方式面向命令行 / 程序化场景。

命令行 / 程序化鉴权： Authorization: Bearer <YOUR_TOKEN>

token 从哪来（命令行场景）：登录 DropRoom → 设置 →「远程 MCP」→ 展开「高级：命令行 / 程序化接入」→ 生成 token。

工具

create_product —— 建新商品（含 SKU），每次成功扣 2 额度，需要 idempotency_key。
update_product —— 改已有商品 / SKU 的字段（不加不删 SKU），免费。
list_products —— 查商品列表（含 SKU / sku_id），只读，免费。
list_orders —— 查订单行、理催付，支持 drop_id / state / unpaid_only 筛选；买家身份始终脱敏（绝不返回原始联系方式 / 地址），只读，免费。
order_stats —— 按状态或按商品聚合订单数量与营收，纯数字（不含买家身份），只读，免费。
order_stats 现在也支持 group_by='sku'——按颜色 / 尺码细分销量与营收，用于生成分色分码的供货商补货 / 拣货单；list_orders 每行也带上该行 SKU 的颜色 / 尺码。

收费

每成功建 1 个商品扣 2 额度，与 AI 解析共用同一个额度池；改 / 查始终免费；幂等重放（同 idempotency_key）不再扣；建品失败不扣。

分客户端接入

Claude（网页版 / Desktop / Code）

① 打开 Claude → 设置（Settings）→ Customize → Connectors（连接器）
② 点「+」→「Add custom connector」（添加自定义连接器）
③ 粘贴端点网址：https://droproom.net/api/mcp
④ 保存并点击连接 → 跳转到 droproom.net 的授权页 → 用你的团长账号登录并点「同意」
⑤ 完成，回到 Claude 就能在对话里直接建品 / 改价 / 查列表

Free / Pro / Max / Team / Enterprise 均可用（Free 版最多添加 1 个自定义连接器）。

Claude Code（推荐）

在终端运行下面这行注册服务器，再在 Claude Code 里运行 /mcp 完成浏览器授权——OAuth 全程自动，不需要手动配置 token。

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

高级：手动配置 bearer token（mcp-remote / --header）

Claude Desktop

打开 claude_desktop_config.json，加入下面这段（通过 mcp-remote 桥接），保存后重启 Claude Desktop。

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

Claude Code

在终端里运行这条命令即可完成接入，原生支持远程 HTTP，无需额外桥接。

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

Codex（CLI）

运行第一行命令注册服务器，再设置第二行的环境变量（token 只存在环境变量里，不会写进 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>"

通用 Agent

任何支持 remote/HTTP MCP 的客户端都能连：支持 OAuth 发现（RFC 9728 + 动态客户端注册）的客户端可以直接粘贴上面的端点网址、走自动授权；只支持自定义 header 的客户端，就用「高级」里的 bearer token 方式。

ChatGPT

⚠️ 前置条件：需先在 ChatGPT 设置里打开「开发者模式（Developer Mode）」；且目前【建品 / 改价等写操作仅 Business / Enterprise / Edu 套餐可用】，Pro 套餐仅支持只读（查列表），Free / Plus 暂不支持。

① 设置 → Apps → Advanced settings → 打开 Developer mode（开发者模式）
② Apps → Create（新建）
③ 填入 MCP 端点：https://droproom.net/api/mcp，认证方式选 OAuth
④ 点「Scan Tools」→ 完成授权（跳转到 droproom 的同意页并登录确认）
⑤ 点「Create」保存；企业 / 团队版还需管理员在 Workspace settings → Apps → Drafts 里发布后，成员才能使用

该功能较新，OpenAI 的界面命名可能随版本调整；如按上述路径找不到入口，请以 ChatGPT 官方帮助中心当前文档为准。

命令行 / 程序化接入时，把网址和 token 分开交给 AI —— 别把 token 拼进网址（会进日志/历史泄漏）。