MCP

适用场景

• 客户用自有 AI / Agent 查询本社订单、产品与团单
• 在确认后由 Agent 创建产品、草稿订单、调整状态或组团（写操作需 confirm）
• 与 OpenAPI 共用同一套租户 Token，REST 与 MCP 可并存

Tools（读）

• list_orders

  分页查询订单列表

• get_order

  按 orderId 获取订单详情

• list_products

  分页查询产品/线路

• get_product

  按 productId 获取产品详情

• list_groups

  分页查询团单（支持 createStartDate/createEndDate）

• get_group

  按 groupId 获取团单详情（关联请用 groupId，勿用 groupNo）

• list_quotations

  分页查询定制游报价单列表

• get_quotation

  按 quotationId 获取报价单详情

• list_order_guests

  查询订单/报价游客名单

• list_customers

  分页查询客户/同行

• get_customer

  按 customerId 获取客户详情

• get_today_realtime_summary

  今日实时运营汇总（新单/成团/待出行）

• get_order_dashboard_summary

  首页订单仪表盘汇总

• get_finance_period_summary

  财务期间收支汇总（默认上月）

Tools（写）

写工具均需传入 confirm: true，避免 Agent 误操作。

• create_product

  创建线路产品（可选 tripList 行程大纲）；需 confirm=true

• import_product_images

  从远程 URL 转存产品相册（建议每批 ≤10 张）；需 confirm=true

• save_quotation

  保存定制游报价单（扁平入参）；默认报价中，finalize=true 成单；需 confirm=true

• create_draft_order

  创建草稿订单（服务端固定 orderStatus=1）；需 confirm=true

• update_order

  部分更新订单字段；需 confirm=true

• update_order_status

  修改订单状态（0/1/2/3/4/5/10）；需 confirm=true

• batch_update_order_status

  批量改订单状态（拼团前确认常用）；需 confirm=true

• save_order_guests

  全量替换游客名单；需 confirm=true

• create_customer

  创建客户/同行；需 confirm=true

• pack_orders_to_group

  组团：新建团或并入现有团；需 confirm=true

• update_group_status

  修改团单状态；需 confirm=true

AI 客户端配置示例

{
  "mcpServers": {
    "meitu-erp": {
      "url": "https://service.meitu.io/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_TOKEN>"
      }
    }
  }
}

将 url 换成贵司云端 API 域名；Token 请妥善保管，勿提交到代码仓库。多实例部署时 Streamable HTTP 会话建议开启粘性会话。