摘要
通过 AI 代理运营 Trendyol 卖家账户：商品（Product v2 列表、创建、内容、归档）、库存和价格、Buybox、批处理结果、带状态、物流追踪、承运商和发票链接的发货包裹、退货、客户问答、类目、属性和品牌、地址以及财务结算。使用 API 密钥和 secret 进行 Basic 认证。
引导式设置
2 分钟将 Trendyol 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Trendyol，再把你的 MCP URL 添加到 Microsoft Copilot。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Trendyol 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Trendyol、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Trendyol + Microsoft Copilot
通过 AI 代理运营 Trendyol 卖家账户：商品（Product v2 列表、创建、内容、归档）、库存和价格、Buybox、批处理结果、带状态、物流追踪、承运商和发票链接的发货包裹、退货、客户问答、类目、属性和品牌、地址以及财务结算。使用 API 密钥和 secret 进行 Basic 认证。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
TRENDYOL_API_HOST, TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET
步骤 1 — 获取凭证
- 用 master user（管理员角色）登录 Trendyol 卖家后台（
partner.trendyol.com）。只有 master user 能看到 API 密钥和 secret。 - 打开右上角的店铺名称 → Hesap Bilgilerim → Entegrasyon Bilgileri。把 Satıcı ID（一个数字）复制到
TRENDYOL_SELLER_ID，把 API Key 复制到TRENDYOL_API_KEY，把 API Secret Key 复制到TRENDYOL_API_SECRET。 - 对正式店铺，把
TRENDYOL_API_HOST设为https://apigw.trendyol.com。Stage（测试）主机https://stageapigw.trendyol.com需要单独的 stage 凭据，并且只响应已被 Trendyol 加入白名单的 IP 地址（其他地址会收到 503），因此适合自托管的测试安装，而不是你的正式店铺。 - 仅当你在 Trendyol 的国际站点销售时，才把
TRENDYOL_STOREFRONT_CODE设为该站点的两位国家代码。Trendyol 土耳其站请留空。 - 安装连接器并运行
trendyol_list_stock_and_prices。
订单使用 v2 接口：trendyol_list_orders 通过 Trendyol 的 v2 订单接口（/v2/orders）读取发货包裹。Trendyol 已规定自 2026 年 10 月 15 日起必须使用该接口，届时旧的订单列表将停止工作。它最多只能查到最近一个月，日期范围最长 2 周（不指定日期时为最近一周），且每个筛选条件只能取到前 10,000 个包裹，因此要查看更多时，AI 会缩小时间范围或按状态筛选。
先确认：价格和库存更新、内容修改、包裹状态、追踪单号、更换承运商、发票链接、批准退货、回答提问、归档和创建商品，都会直接作用于你的正式店铺。AI 会先给你看将要改变的内容（带新旧数值的条码、包裹及其明细行、回答文本），并等待你确认。商品写入是异步的：返回成功只表示请求已进入队列，因此 AI 会用 trendyol_get_batch_request 检查结果（结果保留 4 小时）。
安装时默认关闭：trendyol_delete_products（无法撤销）、trendyol_report_unsupplied（为客户取消订单明细行，无法撤销）和 trendyol_reject_claim_items（请求 Trendyol 拒绝退回的商品）。
限制：每个接口每 10 秒最多 50 次请求，另外还有按服务组计算的每分钟限制，具体取决于你店铺的商品刊登等级。一次价格和库存更新最多包含 1,000 个条码（每个商品最多 20,000 件，售价不高于标价），Trendyol 会拒绝 15 分钟内重复提交的相同请求，以及同一条码每分钟超过 30 次的价格更新。财务列表需要指定交易类型，时间范围最长 15 天。
常见错误：带 ClientApiAuthenticationException 或 basic.authorization.failed 的 401：凭据错误（stage 和正式环境的凭据不同）。403：请检查 TRENDYOL_SELLER_ID，因为 Trendyol 要求使用由它生成的 User-Agent。429 too.many.requests：稍等片刻再试。
该连接器不使用旧主机 api.trendyol.com/sapigw、旧的订单列表或旧的商品筛选。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name（例如
AnythingMCP）、说明连接器用途的 Server description，以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key，把 Type 设为 Header，请求头名称填
X-API-Key，然后选择 Create。 - 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试：提出需要用到
Trendyol的工具的请求。 - 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
trendyol_list_products | List the seller's approved products (Product v2 filter): one entry per content (productMainId, title, brand, category, images, attributes)… |
trendyol_list_unapproved_products | List products that are not approved yet: pending approval or rejected, with the reject reasons, price, stock and attributes |
trendyol_list_stock_and_prices | List only stock and prices of approved products (list price, sale price, quantity, last stock change per variant) |
trendyol_get_product | Read the basic state of one product by barcode: approved or not (and when), archived, listing id and content id |
trendyol_get_buybox | Check the buybox for up to 10 barcodes: your position in the buybox, the buybox price and whether other sellers offer the same product |
trendyol_get_batch_request | Read the result of an asynchronous product, price, stock, archive or delete request by its batchRequestId: overall status (IN_PROGRESS… |
trendyol_create_products | Create products (Product v2, up to 1,000 per call) |
trendyol_update_price_and_inventory | Update the stock and prices of approved products (up to 1,000 barcodes per call, at most 20,000 units per product) |
trendyol_update_product_content | Update the content of approved products (title, description, images, attributes) by contentId, up to 1,000 per call |
trendyol_update_unapproved_products | Correct products that are still waiting for approval or were rejected (title, description, brand, category, images, attributes, stock code… |
trendyol_archive_products | Archive products (take them off sale) or bring them back from the archive, by barcode, up to 1,000 per call |
trendyol_delete_products | Delete products from Trendyol by barcode |
trendyol_list_orders | List shipment packages (orders) with their lines, customer, addresses, amounts, status, cargo provider and tracking |
trendyol_update_package_status | Move a shipment package to Picking (you started preparing it) or Invoiced (with the invoice number) |
trendyol_update_tracking_number | Send the carrier's tracking number of a package shipped with your own carrier, mainly on the international storefronts (Europe, Gulf)… |
trendyol_change_cargo_provider | Change the cargo company of a shipment package |
trendyol_send_invoice_link | Send the link of the e-invoice (e-Fatura or e-Arşiv) of a shipment package; Trendyol forwards it to the customer |
trendyol_report_unsupplied | Report that lines of a package cannot be supplied, which cancels them for the customer |
trendyol_list_claims | List returns (claims) with the order, customer, cargo tracking and each returned item with the customer reason and status |
trendyol_get_claim_item_audit | Read the status history of one returned item: each status change, when and by whom |
trendyol_list_claim_issue_reasons | List the reasons a seller can give when rejecting a returned item, with their ids for trendyol_reject_claim_items |
trendyol_approve_claim_items | Approve returned items that arrived at your warehouse; the customer is refunded |
trendyol_reject_claim_items | Open a rejection request for returned items (for example a wrong or damaged item came back), with a reason from… |
trendyol_list_questions | List customer questions about your products: text, product, status (WAITING_FOR_ANSWER to answer), date and the answer if any |
trendyol_get_question | Read one customer question with the product, the answer and, if it was rejected or reported, the reason |
trendyol_answer_question | Answer a customer question (10 to 2,000 characters) |
trendyol_list_categories | Find categories for product creation |
trendyol_get_category_attributes | List the attributes of a leaf category: id, name, whether it is required, a variant attribute, allows several values or a free value |
trendyol_list_attribute_values | List the allowed values of one category attribute (attributeValueId and name), for attributeValueIds in trendyol_create_products |
trendyol_search_brands | Find brands by name to get the brandId for trendyol_create_products |
trendyol_list_brands | List all brands page by page (id and name) |
trendyol_list_cargo_providers | List the cargo companies available on the storefront (code and name) |
trendyol_list_addresses | List the seller's shipment, invoice and return addresses with their ids (shipmentAddressId and returningAddressId for products) and the… |
trendyol_list_settlements | List settlement lines: sales, returns, discounts, coupons, commissions and their payout, with amounts, commission rate, seller revenue… |
trendyol_list_other_financials | List other financial records: payment orders (payouts), wire transfers, incoming transfers, deduction and return invoices, commission… |
示例提示
- “过去 3 天的发货包裹中，哪些仍处于 Created 状态？每个包裹包含哪些明细行？”
- “检查条码 8680001234567 和 8680001234574 的 Buybox，告诉我是否有其他卖家拿到了 Buybox，价格是多少。”
- “列出等待回答的客户提问，并为每个问题起草回复，但在发送任何回复之前先给我看。”
- “根据 10 月 1 日至 15 日的结算，汇总我们的销售额、退货和佣金。”
FAQ
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?