MCP 経由で Trendyol を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Trendyol をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Trendyol + Gemini

AI エージェントから Trendyol のセラーアカウントを運用：商品（Product v2 の一覧、作成、コンテンツ、アーカイブ）、在庫と価格、Buybox、バッチ結果、ステータス、追跡、配送業者、請求書リンク付きの出荷パッケージ、返品、顧客の質問と回答、カテゴリ、属性、ブランド、住所、財務精算。API キーとシークレットによる Basic 認証です。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

TRENDYOL_API_HOST, TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET

ステップ 1 — 認証情報を取得

1. master user（管理者ロール）で Trendyol のセラーパネル（partner.trendyol.com）にサインインします。API キーとシークレットを見られるのは master user だけです。
2. 右上のストア名 → Hesap Bilgilerim → Entegrasyon Bilgileri を開きます。Satıcı ID（数字）を TRENDYOL_SELLER_ID に、API Key を TRENDYOL_API_KEY に、API Secret Key を TRENDYOL_API_SECRET にコピーします。
3. 本番ストアでは TRENDYOL_API_HOST を https://apigw.trendyol.com に設定します。ステージ（テスト）用ホスト https://stageapigw.trendyol.com には専用のステージ認証情報が必要で、Trendyol がホワイトリストに登録した IP アドレスにしか応答しません（それ以外には 503 が返ります）。セルフホストのテスト環境向けで、本番ストアには使いません。
4. Trendyol の海外ストアフロントで販売している場合のみ、TRENDYOL_STOREFRONT_CODE にその 2 文字の国コードを設定します。Trendyol トルコの場合は空のままにします。
5. コネクターをインストールし、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 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Trendyol のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「過去 3 日間の出荷パッケージのうち、まだ Created ステータスのものはどれですか。それぞれに含まれる明細も教えてください。」
• 「バーコード 8680001234567 と 8680001234574 の Buybox を確認し、ほかのセラーが Buybox を取っているか、その価格はいくらかを教えてください。」
• 「回答待ちの顧客の質問を一覧にして、それぞれの回答案を作ってください。ただし送信する前に回答を見せてください。」
• 「10 月 1 日から 15 日までの精算から、売上、返品、手数料をまとめてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続