概要
AIエージェントからTiendanimalマーケットプレイスでショップを運営します:注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはスペインで販売されており、Tiendanimalの販売者バックオフィスからショップAPIキーでサインインします。
ガイド付きセットアップ
Tiendanimal Marketplace を ChatGPT に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Tiendanimal Marketplace を接続して、MCP URL を ChatGPT に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
ChatGPT のプラグインディレクトリにある AnythingMCP プラグインは、AnythingMCP Cloud 上で社内データベース(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB、読み取り専用)への質問に答えます。掲載ページを開き (新しいタブで開きます)、Install plugin をクリックしてください。それ以外のコネクタは、AnythingMCP の MCP URL を使ってカスタム MCP サーバーとして ChatGPT に追加します。
こう聞いてみよう
Tiendanimal Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Tiendanimal Marketplaceをクリックし、資格情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Tiendanimal Marketplace + ChatGPT
AIエージェントからTiendanimalマーケットプレイスでショップを運営します:注文、受け入れ、追跡と配送、インシデント、価格と在庫のあるオファー、インポート、メッセージ、返品、請求書と取引。マーケットプレイスはスペインで販売されており、Tiendanimalの販売者バックオフィスからショップAPIキーでサインインします。
前提条件
コネクタに組み込まれている完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
TIENDANIMAL_API_KEY
ステップ1 — 資格情報を取得する
国:スペイン。マーケットプレイスの注文はスペイン国内で配送され、カナリア諸島、セウタ、メリリャは含まれません。
誰が販売できるか:Tiendanimalは各申請を審査し、各販売者と契約を結びます:マーケットプレイスの営業チームに連絡してください。製品は新品でEANを持ち、価格には税金が含まれます。販売者は自社の運送業者を使用し、各注文を5営業日以内に受け入れ、14日以内に返品を受け付けます。このコネクタには、Tiendanimalがすでに開設した販売者アカウントが必要です。
このコネクタの販売者アドレスは、プラットフォームがこの小売業者に割り当てたものです。まだ販売者ガイドには名前が付けられていません。もしあなたの販売者バックオフィスが異なるアドレスで開設されている場合は、チャットでお知らせください。修正します。
設定には約5分かかります。
- Tiendanimalの販売者バックオフィスにサインインします:
https://tiendanimal-prod.mirakl.net/login。 - バックオフィスでユーザー名(右上)を開き、My user settings > API keyを選択し、Generate a new keyをクリックします(または既存のキーをコピーします)。それを
TIENDANIMAL_API_KEYに貼り付けます。キーはそのままAuthorizationヘッダーに送信され、Bearerは不要です。新しいキーを生成すると古いキーが無効になるため、他のツールで使用している場合は動作しなくなります。 TIENDANIMAL_SHOP_IDは空のままにします。もしあなたのユーザーがTiendanimalで複数のショップを管理している場合のみ、TIENDANIMAL_SHOP_IDをこのコネクタが動作するショップの数値IDに設定します(バックオフィスのダッシュボードでIdentifierまたはShop IDの隣に表示され、tiendanimal_get_accountによってshop_idとして返されます)。これがない場合はデフォルトのショップが使用されます。tiendanimal_get_accountをインストールして実行します:キーに属するショップを返します。
どこから始めるか:tiendanimal_get_accountはキーの背後にあるショップを表示します(ID、名前、状態、通貨、チャネル)。日常業務には、order_state_codes=WAITING_ACCEPTANCEを使用してtiendanimal_list_orders、価格と在庫にはtiendanimal_list_offers、メッセージにはtiendanimal_list_threadsを使用します。
製品と競合オファー:tiendanimal_get_productsはEANまたは他の参照によってTiendanimalカタログ内の製品を検索し、マーケットプレイス製品SKUを返します。tiendanimal_list_product_offersは指定された製品の各ショップのオファーをリストし、最良の価格を最初に表示します。約5回の呼び出しが可能です。
注文ワークフロー:新しい注文はWAITING_ACCEPTANCEで待機します。tiendanimal_accept_orderは各行を受け入れ(または拒否)します;顧客が請求されると、注文はSHIPPINGに移動します。その後、tiendanimal_update_trackingは運送業者と追跡番号を保存し(運送業者コードはtiendanimal_list_carriersから取得)、tiendanimal_ship_orderは出荷を確認します(SHIPPED)。その後の状態はTO_COLLECT、RECEIVED、CLOSED、REFUSED、CANCELEDです。日常のTo-Doリストにはorder_state_codes=WAITING_ACCEPTANCEを使用し、オープンインシデントにはhas_incident=trueを使用します;tiendanimal_resolve_incidentは、問題が解決された後に1つの注文行のインシデントを閉じます。注文に添付された文書(納品書、ラベル、顧客請求書)はtiendanimal_list_order_documentsでリストされます。
書き込み:最初に確認してください。 tiendanimal_accept_order、tiendanimal_update_tracking、tiendanimal_ship_order、tiendanimal_resolve_incident、tiendanimal_accept_return、tiendanimal_receive_return、tiendanimal_update_offers、tiendanimal_reply_thread、tiendanimal_create_order_thread、tiendanimal_import_productsはライブマーケットプレイスで動作します。各呼び出しの前に、ユーザーに何が変更されるか(注文IDと行、追跡番号、古い価格と新しい価格または在庫のオファーSKU、メッセージテキストと受取人)を示し、はいを待ちます。注文行を拒否すると、それは永久にキャンセルされます。ここではどのツールも返金、注文のキャンセル、または資金の移動は行いません;それはバックオフィスで行ってください。tiendanimal_import_offersはオファーを削除できます(REPLACEモードはファイルに存在しないすべてのオファーを削除します)、そのため、オフに切り替えた状態でインストールされます。
オファーの更新(価格と在庫):tiendanimal_update_offers(OF24)はオファー全体を置き換えます。省略したすべてのフィールドはリセットされます:quantityが欠けていると0になり、discountやdescriptionが欠けていると削除されます。常に最初にオファーを読み取ります(tiendanimal_get_offerまたはtiendanimal_list_offersを使用してskuを指定)し、意図した変更のみを含む完全な形で返送します:shop_sku、product_id、product_id_type(product_referencesから)、state_code、price、quantity、leadtime_to_ship、logistic_class(そのコード)、min_quantity_alert、description、discount、all_prices、available_started / available_ended(available_start_date / available_end_dateとして読み取る)および任意のoffer_additional_fields。update_deleteは空のままかupdateにします。呼び出しはimport_idを返します;変更は非同期で適用されるため、再度オファーを読み取る前にtiendanimal_get_offer_importで確認してください。state_codeの条件コードはtiendanimal_list_offer_conditionsから、物流クラスコードはtiendanimal_list_logistic_classesから取得します。
ファイルインポート:tiendanimal_import_products(P41)およびtiendanimal_import_offers(OF01)は、Tiendanimalが要求するファイル形式のCSV、XLSX、またはXMLファイルのURLを受け取ります;コネクタはそれをダウンロードし、Tiendanimalにアップロードします。tiendanimal_list_product_imports / tiendanimal_get_product_importおよびtiendanimal_list_offer_imports / tiendanimal_get_offer_importで追跡します。
返品:tiendanimal_list_returns(RT11)は返品リクエストをリストします。Tiendanimalがショップに決定を任せる場合、tiendanimal_accept_returnはWAITING_ACCEPTANCEで1つを受け入れるか拒否し、tiendanimal_receive_returnは商品が到着したことを確認します。返金はバックオフィスに残ります。
メッセージ:tiendanimal_list_threadsは顧客とTiendanimalとの会話をリストします(1つの注文のためにentity_type=MMP_ORDERおよびentity_id=<order id>でフィルタリング;entity_typeなしのentity_idは拒否されます)、tiendanimal_get_threadはそのメッセージを読み取り、tiendanimal_reply_threadは応答します(受取人はCUSTOMERまたはOPERATOR、つまりTiendanimal)し、tiendanimal_create_order_threadは注文に関する新しい会話を開始します。トピックの理由コードはtiendanimal_list_reasonsから取得します;マーケットプレイスがその言語を持っていることがわからない限り、localeは空のままにします(非アクティブなロケールは400で応答します)。
お金:tiendanimal_list_invoices(IV01)はTiendanimalがショップに発行する会計文書をリストし、tiendanimal_list_transactions(TL02)は取引行(売上、手数料、返金、支払い)をリストします。TiendanimalがEnhanced Seller Invoicingを使用している場合、IV01は新しい文書を返しません;その場合はtiendanimal_list_document_requests(DR11)を使用し、その後取引を確認します。
全カタログ:すべてのオファーを読み取るには(カタログ全体の在庫または価格チェック、オファーのカウント)、tiendanimal_export_offersでエクスポートを開始し、tiendanimal_get_offer_export_statusがCOMPLETEDと報告するまで約1分ごとにポーリングし、tiendanimal_get_offer_export_fileでファイルを1つずつ読み取ります;include_fieldsは必要な列のみを保持します。完全なエクスポートは1日1回許可されており、それ以降の変更はlast_request_dateを渡すことで行います(差分エクスポート、最大1分ごと)。tiendanimal_list_offersで各オファーをページングしないでください:これは一度に数件のオファー用に設計されており、大規模なカタログをページングすると429で応答します。
複数のショップ:すべてのツールはオプションのshop_idを受け取ります。このマーケットプレイスで複数のショップを管理しているユーザー(代理店や国ごとのショップ)は、1つのインストールでそれらすべてを操作できます:各呼び出しでショップのIDを渡し、tiendanimal_get_accountと同じshop_idでどのショップかを確認します。shop_idがない場合、呼び出しはTIENDANIMAL_SHOP_IDを使用するか、空の場合はユーザーのデフォルトショップが使用されます。ユーザーにショップのIDを尋ねてください;バックオフィスに表示されます。
参照リスト:tiendanimal_list_channels(国サイト)、tiendanimal_list_carriers、tiendanimal_list_shipping_zones、tiendanimal_list_shipping_methodsおよびtiendanimal_list_logistic_classesはあまり変更されません;会話ごとに1回読み取ります。
ページネーション:注文、オファー、請求書および製品インポートはmax(最大100)およびoffsetでページングします。スレッド、返品、取引、文書リクエストおよびオファーインポートはnext_page_tokenを返します;次のページを取得するにはそれをpage_tokenとして渡します(他のすべてのフィルタはその後無視されます)まで続けます。
日付はISO 8601形式で、例:2026-10-01T00:00:00Z;応答はUTCで行われます。
レート制限:各APIには独自の制限があり、Tiendanimalはそれを厳しくすることがあります。オファーや注文のリストはインタラクティブな使用を目的としており、製品およびオファーのインポートは最大15分ごと、tiendanimal_get_accountおよび参照リストは約1日ごとです。429はRetry-Afterヘッダーに待機する秒数を含みます;ループで再試行しないでください。
エラー:401はキーが間違っているか新しいもので置き換えられたことを意味し、403はユーザーにこのアクションの権限がないことを示し、404はこのショップに対して注文、オファー、またはスレッドが存在しないか、マーケットプレイスがその機能を使用していないことを示します(返品など)、400は不正なパラメータまたは注文が不正な状態にあることを示します(メッセージがそれを示します、例:ORDER_INVALID_STATE)。
ステップ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 をクリックして Add custom MCP server を選びます。
- 名前を入力します(例: Name:
Tiendanimal Marketplace)。 - 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 にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| ツール | 機能 |
|---|---|
tiendanimal_get_account | このマーケットプレイスでAPIキーの背後にあるショップを読み取ります(A01):ショップIDと名前、状態、チャネル、通貨、グレードと承認率、連絡先… |
tiendanimal_list_orders | 注文をリストします(OR11):その行、顧客、配送先住所、価格、状態、インシデント。状態でフィルタリング(例:WAITING_ACCEPTANCE… |
tiendanimal_list_offers | ショップのオファーをリストします(OF21):SKU、製品、価格と割引、すべてのチャネル価格、在庫数量、状態、リードタイム、追跡番号の有無… |
tiendanimal_get_offer | オファーIDによって1つのオファーを完全に読み取ります(OF22):すべての価格フィールド、割引、数量、状態、物流クラス、リードタイム、カスタム… |
tiendanimal_list_offer_conditions | マーケットプレイスが受け入れるオファー条件をリストします(OF61):新品または中古、オファー更新時にstate_codeに入れるコード |
tiendanimal_list_offer_imports | オファーのインポートと更新をリストします(OF04):ファイルからとtiendanimal_update_offersから:ステータス(WAITING、RUNNING、COMPLETE、FAILED)、行… |
tiendanimal_get_offer_import | オファーインポートまたはオファー更新の1つのステータスを読み取ります(OF02):import_idによって、tiendanimal_update_offersまたは… |
tiendanimal_export_offers | ショップのすべてのオファーをファイルとしてエクスポートを開始します(OF52):カタログ全体を読み取る方法(すべてのSKUと価格と在庫)… |
tiendanimal_get_offer_export_status | tiendanimal_export_offersで開始されたオファーエクスポートのステータス(OF53):PENDING、COMPLETEDまたはFAILED(エラーコードとエラー詳細付き)… |
tiendanimal_get_offer_export_file | 完了したオファーエクスポートの1つのファイルを読み取ります(OF54):SKU、製品、数量、価格と他のエクスポートされたフィールドを持つオファー… |
tiendanimal_list_product_imports | 製品インポートをリストします(P51):そのステータス(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、変換カウントと… |
tiendanimal_get_product_import | 1つの製品インポートのステータスを読み取ります(P42):インポートステータス、理由、変換カウントと統合の詳細… |
tiendanimal_get_products | マーケットプレイスカタログ内の製品を識別子(P31)で検索します:例:EAN、マーケットプレイス製品SKU、タイトル、カテゴリを取得します… |
tiendanimal_list_product_offers | 指定された製品の各ショップのオファーをリストします(P11):最良の価格でソートし、競合と価格を比較します。product_idsを指定します… |
tiendanimal_list_threads | 顧客とTiendanimalとのメッセージスレッドをリストします(M11):トピック、リンクされた注文またはオファー、参加者、最終メッセージ日付といつから… |
tiendanimal_get_thread | すべてのメッセージ、送信者、受取人、添付ファイル、リンクされた注文またはオファーを持つ1つのメッセージスレッドを読み取ります(M10) |
tiendanimal_list_returns | 返品リクエストをリストします(RT11):その状態、返品行、理由、RMA、追跡とリンクされた注文。状態、注文または日付でフィルタリング… |
tiendanimal_list_reasons | マーケットプレイスの理由コードをリストします(RE01):インシデント、キャンセル、返金およびメッセージの理由、ラベルとショップが… |
tiendanimal_list_carriers | マーケットプレイスが知っている運送業者をリストします(SH21):そのコード、ラベル、追跡URL。carrier_codeとしてコードを使用します… |
tiendanimal_list_invoices | Tiendanimalがショップに発行する会計文書をリストします(IV01):請求書とクレジットノート、期間、税金ありとなしの合計… |
tiendanimal_list_transactions | ショップの取引行をリストします(TL02):注文金額、配送、手数料、返金、手動クレジットと支払い、金額、タイプ… |
tiendanimal_list_document_requests | 会計文書リクエストをリストします(DR11):TiendanimalがEnhanced Seller Invoicingを実行する際に使用される:請求書とクレジットノート… |
tiendanimal_list_order_documents | 1つまたは複数の注文に添付された文書をリストします(OR72):納品書、配送ラベル、顧客請求書および他のファイル、ID、ファイル… |
tiendanimal_list_channels | マーケットプレイスの販売チャネルをリストします(CH11):通常は国サイトごとに1つ、コードとラベル。channel_codesとしてコードを使用します… |
tiendanimal_list_shipping_zones | マーケットプレイスのアクティブな配送ゾーンをリストします(SH11):コードとラベル、例:本土フランスまたはコルシカ。変更はまれです:呼び出します… |
tiendanimal_list_shipping_methods | マーケットプレイスのアクティブな配送方法をリストします(SH12):例:標準、エクスプレスまたはピックアップ、コード、ラベル、追跡番号の有無… |
tiendanimal_list_logistic_classes | マーケットプレイスの物流クラスをリストします(SH31):配送価格を決定するサイズまたは重量帯、コードとラベル。コードを… |
tiendanimal_accept_order | 受け入れ待ちの注文の行を受け入れるか拒否します(OR21)。注文のすべての行をリストする必要があります。行を拒否するとキャンセルされます… |
tiendanimal_update_tracking | 注文の運送業者と追跡番号を設定します(OR23)。tiendanimal_list_carriersからcarrier_codeを指定するか、carrier_nameとcarrier_urlを使用します… |
tiendanimal_ship_order | SHIPPINGの注文が出荷されたことを確認します(OR24);それはSHIPPEDに移動し、顧客に通知されます。最初に追跡を設定します… |
tiendanimal_update_offers | オファーを作成または更新します。価格と在庫を含みます(OF24)。各オファーを完全に置き換えます:省略されたすべてのフィールドはリセットされます… |
tiendanimal_reply_thread | メッセージスレッド(M12)で顧客またはTiendanimalに返信します。メッセージはすぐに配信され、取り消すことはできません:ユーザーに… |
tiendanimal_create_order_thread | 顧客、Tiendanimal、または両方との注文に関する新しいメッセージスレッドを開始します(OR43)。メッセージはすぐに配信されます:ユーザーに… |
tiendanimal_resolve_incident | 1つの注文行のオープンインシデントを解決済みとしてマークします(OR64)、顧客の問題が解決された後。reason_codeはINCIDENT_CLOSE… |
tiendanimal_accept_return | WAITING_ACCEPTANCEの返品リクエストを受け入れるか拒否します(RT21)。Tiendanimalが販売者バックオフィスで返品を処理し、… |
tiendanimal_receive_return | 受け入れた返品の商品の到着を確認します(RT25)。返品はRECEIVEDに移動します。ライブマーケットプレイスで動作します… |
tiendanimal_import_products | マーケットプレイスに製品ファイルを送信します(P41):カタログに製品を作成または追加します。file_urlはCSV、XLSXまたはXMLのアドレスです… |
tiendanimal_import_offers | オファーファイルをインポートします(OF01):オファーを一括で作成、更新または削除します。REPLACEモードはファイルに存在しないすべてのオファーを削除します… |
例のプロンプト
- "どのTiendanimalの注文が私の受け入れを待っていますか?Tiendanimalは5営業日以内に回答を期待しています。"
- "私のグレインフリーキャットフード2kg SKU TA-CAT-GF2の在庫を90に設定し、価格はそのままにします。"
- "注文6601234-AにCorreosの追跡PQ4F6P0712345670128002Sを追加し、出荷を確認します。"
- "どの返品リクエストが私の決定を待っていますか?"
- "私のTiendanimalカタログをエクスポートし、在庫切れのオファーをリストします。"
FAQ
Tiendanimal APIキーはどこで取得し、複数のショップを運営している場合はどうすればよいですか? Tiendanimalの販売者バックオフィスで:ユーザー名(右上)、My user settings、API key、次にGenerate a new key(または既存のキーをコピーします)。新しいキーを生成すると古いキーが無効になります。キーはあなたのユーザーに属し、1つのショップには属しません:Tiendanimalで複数のショップがある場合、コネクタがデフォルトで使用するショップにTIENDANIMAL_SHOP_IDを設定するか、AIに各呼び出しでshop_idを渡してすべてのショップで1つのインストールで作業するように依頼します。どちらもない場合、デフォルトのショップが使用されます。
Tiendanimalで誰が販売でき、どの国をカバーしていますか? Tiendanimalは各申請を審査し、各販売者と契約を結びます:マーケットプレイスの営業チームに連絡してください。製品は新品でEANを持ち、価格には税金が含まれます。販売者は自社の運送業者を使用し、各注文を5営業日以内に受け入れ、14日以内に返品を受け付けます。コネクタはスペインをカバーしています。マーケットプレイスの注文はスペイン国内で配送され、カナリア諸島、セウタ、メリリャは含まれません。このコネクタの販売者アドレスは、プラットフォームがこの小売業者に割り当てたものです。まだ販売者ガイドには名前が付けられていません。もしあなたの販売者バックオフィスが異なるアドレスで開設されている場合は、チャットでお知らせください。修正します。
カタログ全体をチェックできますか?注文をキャンセルしたり、返金したり、オファーを削除したりできますか? カタログについてははい:すべてのオファーの在庫または価格チェックのために、AIはtiendanimal_export_offersでエクスポートを開始し、tiendanimal_get_offer_export_statusが完了と報告するまで待ち、tiendanimal_get_offer_export_fileでファイルを読み取ります(完全なエクスポートは1日1回、日付以降の変更は1分ごと)。どのツールも返金や注文のキャンセルは行いません;それはTiendanimalのバックオフィスで行ってください。注文を受け入れる際に行を拒否すると、それは永久にキャンセルされるため、AIはすべての書き込みを表示し、はいを待ちます。tiendanimal_import_offersはオフに切り替えた状態でインストールされます。REPLACEモードはファイルに存在しないすべてのオファーを削除するため、AIが使用する必要がある場合のみコネクタページでオンにしてください。
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?