インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、n11 をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
n11 出品者連携 API（トルコ）：作成、更新、価格と在庫のタスクとその結果を含む商品、カテゴリーツリーと属性、承認、分割、集荷、請求書リンクを含む配送パッケージとしての注文、返品依頼、顧客の質問。商品の削除と返品の拒否はインストール時にオフです。
こう聞いてみよう
n11 のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → n11 をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
n11 + Meta Muse
n11 出品者連携 API（トルコ）：作成、更新、価格と在庫のタスクとその結果を含む商品、カテゴリーツリーと属性、承認、分割、集荷、請求書リンクを含む配送パッケージとしての注文、返品依頼、顧客の質問。商品の削除と返品の拒否はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
N11_APP_KEY, N11_APP_SECRET
ステップ 1 — 認証情報を取得
設定は約 5 分です。n11 の出品者アカウントが必要です。
- n11 出品者パネル（so.n11.com）にサインインし、Hesabım > API Hesapları（アカウント > API アカウント）を開きます。API アカウントがなければ作成します。
- API anahtarı（キー）を
N11_APP_KEYに、API şifresi（シークレット）をN11_APP_SECRETにコピーします。 - コネクタをインストールし、
n11_list_productsを実行します。商品の一覧が返り、キーとシークレットの組み合わせが確認できます。
使用する API: https://api.n11.com の n11 出品者連携 API（ドキュメントは developer.n11.com）。商品、価格と在庫、カテゴリー、注文は n11 の現行 REST サービスを使い、キーとシークレットを appkey と appsecret ヘッダーで渡します。返品、顧客の質問、請求書リンクは n11 の SOAP サービスにしかなく、コネクタがキーとシークレットをリクエスト内に入れます。2025 年 8 月 15 日以降、カテゴリーサービスにもキーが必要です。
読み取れるデータ: n11 商品 ID、ストックコード、タイトル、カテゴリー、product main id（グループ）、ステータス、販売ステータス、価格、在庫、VAT 率と手数料率、属性、画像を含む商品（ストックコード、グループコード、販売または承認ステータス、ブランド、カテゴリーで絞り込み。productStatus が InApproval なら n11 があなたの対応を待っており、CatalogRejected には rejectInfo が付きます）；カテゴリーツリー全体と、末端カテゴリーの属性と許容値；商品タスクの結果；注文番号、ステータス、購入者、請求先と配送先住所、配送会社と追跡、約束した出荷日、明細（orderLineId、商品、ストックコード、数量、価格、割引、sellerInvoiceAmount、手数料）を含む配送パッケージとしての注文；理由、注文番号、商品、数量、価格、購入者、配送追跡を含む返品依頼と、保留や拒否のときに指定できる理由；購入者、商品、質問日と回答日を含む顧客の質問。
商品の書き込みはすべてタスク: n11_create_products、n11_update_products（ステータス Suspended で販売停止）、n11_update_price_and_stock、n11_delete_products は 1 回最大 1,000 件のストックコードを受け付け、タスク id とステータス IN_QUEUE（理由付きの REJECT の場合も）を返します。AI はその後、ステータスが PROCESSED になるまで n11_get_task_details を呼び、ストックコードごとの status（SUCCESS または FAIL）と reasons を読みます。書き込みの 200 はタスクがキューに入ったことしか意味しません。商品を作成するとき、AI は末端カテゴリー（subCategories が null）を選び、必須属性をすべて送ります。isCustomValue が false なら valueId、それ以外は customValue です。同じ productMainId がバリエーションをまとめます。
注文: 新しいパッケージのステータスは Created です。n11_approve_order_lines で明細を Picking に進め、n11 の配送キャンペーンコードを cargoTrackingNumber に入れて出荷すると、パッケージは Shipped、Delivered に進みます。Picking のパッケージは明細単位（n11_split_package）か数量単位（n11_split_package_by_quantity）で分割でき、必要に応じて数量をキャンセルできます（理由 61 在庫切れ、62 不良品、63 価格誤り、64 不可抗力、65 その他）。大型商品は n11_create_collection_request で集荷を依頼し、宝飾品の明細は n11_send_labor_costs で加工費を送り、n11_send_invoice_link は請求書リンクを保存します（micro が true の e-export 注文では請求書番号と日付も）。
返品と質問: n11_list_claim_returns は既定で REQUESTED の返品を表示します（全ステータスは ALL、注文番号で探すなら searchInfoType ORDERID）。n11_approve_claim_return は購入者に返金し、n11_postpone_claim_return は理由を付けて判断を保留します。n11_answer_product_question は質問に 1 回だけ回答でき、回答は公開されます。
書き込みは先に確認: 価格、在庫、商品ステータス、注文の承認、分割とキャンセル、返品、回答は稼働中のストアに作用します。呼び出しの前に、AI は変更内容（ストックコードと変更前後の価格や在庫、明細、回答文）を示してあなたの同意を待ちます。
インストール時はオフ: n11_delete_products と n11_deny_claim_return です。チームが必要とするときに管理者がオンにします。
データ形式: 注文の日付（startDate、endDate、lastModifiedDate、invoiceDateTime）はトルコ時間（UTC+3）のエポックミリ秒です（例 1793318400000）。SOAP サービスは dd/mm/yyyy を使います。日付を指定しないとパッケージ一覧は直近 15 日分を表示し、それより長い期間は 15 日に短縮されます。価格は currencyType が USD か EUR でない限り TL で、小数点はドット、小数 2 桁で送ります。salePrice は listPrice を超えられません。orderNumber や n11ProductId などの ID は桁数が増えることがあるので、文字列として扱ってください。2024 年 11 月より前の注文データは取得できません。
ページング: REST の一覧はページ 0 から始まり totalPages を返します。content が空になったら AI は止めます。商品は 1 ページ最大 250 件、パッケージは 100 件、返品は 20 件です。
制限: 注文一覧は毎分 1,000 リクエスト、商品の書き込みは 1 回 1,000 ストックコード、質問一覧は毎分 1 回までです。
よくあるエラー: 401（SellerApiUserUnauthorizedException）は n11 がキーとシークレットを拒否したことを意味します。Hesabım > API Hesapları から両方をコピーし直してください。403 Authentication failed はキーとシークレットの組み合わせが違うか、API アカウントが無効です。ステータスが failure の SOAP 応答には n11 の errorMessage が含まれます。REJECT のタスクや FAIL のストックコードには、必須属性の不足などの理由が示されます。
このコネクタは配送ラベルの作成や n11 の入金や精算の読み取りはできません。そのためのツールはありません。
ステップ 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 — Muse にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。
- Muse で Settings → Connectors を開き、Add custom connector を選びます。
- MCP サーバーの URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを貼り付けます。 - Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
n11のツールが必要になる依頼を Muse にしてみましょう。
チャットから設定することもできます（Web、iOS・Android アプリ、WhatsApp）。Muse に次のメッセージを送ってください:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
n11_list_products | List your n11 products: n11 product id, stock code, title, category, product main id (group), status, sale status, prices, stock, VAT and… |
n11_list_categories | Get the whole n11 category tree in one call (id, parentId, name, subCategories) |
n11_get_category_attributes | Get the attributes of a leaf category with their allowed values: attributeId, name, isMandatory, isVariant (same productMainId groups… |
n11_get_task_details | Read the result of a product task (create, update, price and stock, delete): task status PROCESSED, IN_QUEUE or REJECT and per stock code… |
n11_list_shipment_packages | List orders as shipment packages: order number, package id, status, buyer, billing and shipping address, cargo company and tracking, agreed… |
n11_list_claim_returns | List return requests (claims) with id, status, reason, order number, product, quantity, prices, buyer and cargo tracking; 20 per page… |
n11_list_return_deny_reasons | List the reasons (id and text) you may give when refusing a return with n11_deny_claim_return |
n11_list_return_pending_reasons | List the reasons (id and text) you may give when postponing the decision on a return with n11_postpone_claim_return |
n11_list_product_questions | List customer questions about your products (id, product, subject, question, answer). startDate, endDate, currentPage and pageSize are… |
n11_get_product_question | Get one customer question with buyer name and email, product, question and answer dates, visibility and status |
n11_update_price_and_stock | Update price and/or stock of products by stock code (up to 1,000 per call). listPrice and salePrice go together, with a dot and two… |
n11_create_products | Create products (up to 1,000 per call) in leaf categories with title, description, categoryId, productMainId, stockCode, barcode, images… |
n11_update_products | Update product data by stock code (up to 1,000 per call): status (Active or Suspended to take it off sale), preparingDay, shipmentTemplate… |
n11_delete_products | Delete products by stock code (up to 1,000 per call) |
n11_approve_order_lines | Approve (accept) new order lines: moves Created lines to Picking |
n11_split_package | Split a Picking package into several packages by order line (each group becomes its own package with its own tracking code; lines not… |
n11_split_package_by_quantity | Split a Picking package by quantity, optionally cancelling part of a line (cancelReasonId 61 out of stock, 62 defective, 63 wrong price, 64… |
n11_create_collection_request | Create a collection (pickup) request with a logistics company for Picking packages of bulky goods: every line of the package with box… |
n11_send_labor_costs | Send the labour cost (excluding VAT, with its VAT rate 0, 1, 10 or 20, default 20) of order lines, for gold, jewellery and similar… |
n11_send_invoice_link | Save the invoice link (https, pdf, png or jpeg) of an order; a new link replaces the previous one |
n11_approve_claim_return | Approve a return request: the buyer gets the refund |
n11_postpone_claim_return | Postpone the decision on a return request by some days, with a reason from n11_list_return_pending_reasons and a note |
n11_deny_claim_return | Refuse a return request with a reason from n11_list_return_deny_reasons and a note; for most reasons say how the product goes back… |
n11_answer_product_question | Answer a customer question (1 to 2,048 characters) |
プロンプトの例
- 「n11 の商品のうち InApproval または CatalogRejected のものはどれで、理由は何ですか？」
- 「ストックコード ABC-1 の在庫を 40、販売価格を 199.90 TL にしてください。先に変更前後の値を見せ、その後タスクの結果を確認してください。」
- 「直近 3 日間の n11 の新規パッケージ（Created）を明細付きで一覧にしてください。」
- 「n11 の未処理の返品依頼と、購入者が挙げた理由を見せてください。」
- 「今週の未回答の顧客の質問に回答案を作り、送信する前に 1 件ずつ私に承認させてください。」
FAQ
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?