インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Trendyol をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI エージェントから Trendyol のセラーアカウントを運用：商品（Product v2 の一覧、作成、コンテンツ、アーカイブ）、在庫と価格、Buybox、バッチ結果、ステータス、追跡、配送業者、請求書リンク付きの出荷パッケージ、返品、顧客の質問と回答、カテゴリ、属性、ブランド、住所、財務精算。API キーとシークレットによる Basic 認証です。
こう聞いてみよう
Trendyol のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Trendyol をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Trendyol + ChatGPT
AI エージェントから Trendyol のセラーアカウントを運用：商品（Product v2 の一覧、作成、コンテンツ、アーカイブ）、在庫と価格、Buybox、バッチ結果、ステータス、追跡、配送業者、請求書リンク付きの出荷パッケージ、返品、顧客の質問と回答、カテゴリ、属性、ブランド、住所、財務精算。API キーとシークレットによる Basic 認証です。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
TRENDYOL_API_HOST, TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET
ステップ 1 — 認証情報を取得
- master user（管理者ロール）で Trendyol のセラーパネル（
partner.trendyol.com）にサインインします。API キーとシークレットを見られるのは master user だけです。 - 右上のストア名 → 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に設定します。ステージ（テスト）用ホストhttps://stageapigw.trendyol.comには専用のステージ認証情報が必要で、Trendyol がホワイトリストに登録した IP アドレスにしか応答しません（それ以外には 503 が返ります）。セルフホストのテスト環境向けで、本番ストアには使いません。 - Trendyol の海外ストアフロントで販売している場合のみ、
TRENDYOL_STOREFRONT_CODEにその 2 文字の国コードを設定します。Trendyol トルコの場合は空のままにします。 - コネクターをインストールし、
trendyol_list_stock_and_pricesを実行します。
注文は v2 エンドポイントで取得します: trendyol_list_orders は Trendyol の v2 注文エンドポイント（/v2/orders）で出荷パッケージを読み取ります。Trendyol は 2026 年 10 月 15 日にこれを必須とし、その日以降は旧来の注文一覧が使えなくなります。取得できるのは直近 1 か月までで、日付の範囲は最大 2 週間（日付を指定しない場合は直近 1 週間）、1 つのフィルターで取得できるのは最初の 10,000 パッケージまでです。それ以上を見るには、AI が期間を絞り込むかステータスで絞り込みます。
先に確認します: 価格と在庫の更新、コンテンツの変更、パッケージのステータス、追跡番号、配送業者の変更、請求書リンク、返品の承認、質問への回答、商品のアーカイブと作成は、すべて本番ストアに反映されます。AI は変更内容（新旧の値を含むバーコード、パッケージとその明細、回答文）を示し、あなたの承認を待ちます。商品の書き込みは非同期です。成功の応答はリクエストがキューに入ったことを意味するだけなので、AI は trendyol_get_batch_request で結果を確認します（結果は 4 時間参照できます）。
インストール時に無効なツール: trendyol_delete_products（元に戻せません）、trendyol_report_unsupplied（顧客の注文明細をキャンセルし、元に戻せません）、trendyol_reject_claim_items（返品された商品の却下を Trendyol に申請します）。
制限: 1 つのエンドポイントにつき 10 秒あたり最大 50 リクエストで、さらにストアのリスティング階層に応じたサービスグループごとの毎分の上限があります。価格と在庫の更新 1 回で扱えるのは最大 1,000 バーコードです（1 商品あたり最大 20,000 個、販売価格は定価以下）。Trendyol は 15 分以内の同一リクエストと、1 つのバーコードに対する毎分 30 回を超える価格更新を拒否します。財務の一覧には取引種別と最大 15 日間の期間が必要です。
よくあるエラー: ClientApiAuthenticationException または basic.authorization.failed を伴う 401: 認証情報が間違っています（ステージと本番の認証情報は異なります）。403: TRENDYOL_SELLER_ID を確認してください。Trendyol はそこから作られる User-Agent を必要とします。429 too.many.requests: 少し待ってから再試行してください。
このコネクターは、旧ホスト api.trendyol.com/sapigw、旧来の注文一覧、旧来の商品フィルターを使いません。
ステップ 2 — アダプターをインストール
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 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、+ をクリックして Add custom MCP server を選びます。
- 名前を入力します（例: Name:
Trendyol）。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| 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
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?
