概要
あらゆる AI エージェントから Etsy ショップを運営:出品の下書きを作成し、編集して公開、写真の追加、価格と在庫の設定、注文への追跡番号の追加、さらに出品・注文・領収書・レビューの読み取り。リフレッシュトークンの自動ローテーション付き OAuth2 + x-api-key による二重認証。
ガイド付きセットアップ
Etsy を ChatGPT に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Etsy を接続して、MCP URL を ChatGPT に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
ChatGPT のプラグインディレクトリにある AnythingMCP プラグインは、AnythingMCP Cloud 上で社内データベース(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB、読み取り専用)への質問に答えます。掲載ページを開き (新しいタブで開きます)、Install plugin をクリックしてください。それ以外のコネクタは、AnythingMCP の MCP URL を使ってカスタム MCP サーバーとして ChatGPT に追加します。
こう聞いてみよう
Etsy のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Etsy をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。
Etsy + ChatGPT
あらゆる AI エージェントから Etsy ショップを運営:出品の下書きを作成し、編集して公開、写真の追加、価格と在庫の設定、注文への追跡番号の追加、さらに出品・注文・領収書・レビューの読み取り。リフレッシュトークンの自動ローテーション付き OAuth2 + x-api-key による二重認証。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
ETSY_CLIENT_ID, ETSY_CLIENT_SECRET
ステップ 1 — 認証情報を取得
Etsy は新しいアプリを使えるようにする前に審査します。通常は 1 日以内です。待っている間もすぐに始められます。AnythingMCP がキーを保存しておきます。AnythingMCP Cloud では Etsy のセットアップページ がこの手順を案内し、Etsy がアプリを承認したらお知らせします。
- Etsy アプリを作成する。 Etsy のアプリ登録フォーム を開き、ショップを所有するアカウントでサインインして、個人用アプリ(personal app)を作成します。Etsy はそれを Personal Apps にステータス Pending Personal Approval で表示します。これは正常です。
- 2 つのキーをコピーする。 Etsy のアプリページ の Personal Apps の同じ行から、Keystring と Shared Secret を AnythingMCP にコピーして保存します。アプリが審査中でもできます。
- Etsy の承認を待つ。 承認されると Etsy からメールが届きます。ほとんどは 1 日以内です。それまではアプリ名をクリックしても何も起きません。
- コールバック URL を追加する。 アプリが有効になったら、アプリ名をクリックしてページを開き、Callback URLs に
https://cloud.anythingmcp.com/api/mcp-oauth/callbackを追加します(セルフホストの場合:<AnythingMCP サーバーの URL>/api/mcp-oauth/callback)。Etsy は 1 文字ずつ照合します。 - Etsy でサインインする。 Authorize with Provider(セットアップページでは Sign in with Etsy)をクリックし、ショップを所有するアカウントで承認します。戻った時点でツールが使えます。 このとき Etsy は出品の削除(
listings_d)の許可も求めます。これを使うのはオフになっている削除ツールだけです。
出品の詳細・メディア・検索: AI は出品の属性(色、素材、サイズ)の読み取りと設定、翻訳(タイトル、説明、タグ)の追加と置き換え、写真の一覧表示とバリエーションの値へのひも付け、出品動画の追加、デジタル出品で購入者がダウンロードするファイルのアップロード、制作パートナーの一覧表示、Etsy 全体の公開中の出品とショップの検索もできます。完全に削除する 3 つのツールはインストール時はオフです: etsy_delete_listing_permanently(出品を非表示にするだけなら inactive に設定します)、etsy_delete_listing_image、etsy_delete_listing_property。必要なときにコネクタページで意図的にオンにしてください。AI は変更のたびに確認します。
すでにインストール済みですか? 以前にインストールしたコネクタにも、カタログ更新で新しいツールが届きます。AnythingMCP でコネクタを開き、Catalog update available の下で新しいツールの一覧を確認して Apply update をクリックしてください。認証情報や自分で追加したツールはそのまま残り、削除ツールは新規インストール時と同じくオフの状態で追加されます。使う前に Authorize with Provider をもう一度クリックして、Etsy に listings_d を許可してください。それまでは Etsy が "Access token lacks scope" と返します。
ステップ 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:
Etsy)。 - 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 |
|---|---|
etsy_get_authenticated_user | Return the user the OAuth token belongs to |
etsy_get_user_shops | List shops owned by the user |
etsy_get_shop | Fetch one shop by shop_id with full details (announcement, sale message, etc.) |
etsy_get_shop_listings_active | List active listings in a shop |
etsy_get_listing | Fetch one listing by listing_id with full details |
etsy_get_shop_receipts | List orders (receipts) for the shop |
etsy_get_shop_receipt | Fetch one receipt with buyer info, transactions[], shipping address |
etsy_get_shop_reviews | List reviews (transactions with feedback) for the shop |
etsy_get_listings_by_shop_section | List listings filtered by a shop section |
etsy_get_listings_by_shop | Listings of your own shop by state (active, inactive, sold_out, draft, removed, expired), as the shop owner sees them |
etsy_list_seller_taxonomy | The full tree of Etsy seller categories (id, name, children) |
etsy_list_taxonomy_properties | Properties (size, colour, material…) and their allowed values for one seller category |
etsy_list_shipping_profiles | The shop's shipping profiles |
etsy_list_processing_profiles | The shop's processing profiles (Etsy calls them readiness states: ready to ship or made to order, with processing times) |
etsy_list_return_policies | The shop's return policies |
etsy_list_shop_sections | The shop's sections, to file a listing under one with shop_section_id |
etsy_read_listing_inventory | Products, prices, quantities and SKUs of a listing, per variation |
etsy_create_listing_draft | Create a listing as a draft (not visible to buyers) |
etsy_edit_listing | Change a listing: title, description, tags, category, shipping, section, or state. state=active publishes a draft (it needs at least one… |
etsy_set_listing_inventory | Set price, quantity and SKU of a listing, per variation |
etsy_add_listing_image | Add a photo to a listing from a public image URL (JPG, PNG or GIF, up to 10 MB). rank 1 is the main photo |
etsy_add_order_tracking | Mark an order (receipt) as shipped with its tracking code |
etsy_get_listings_by_ids | Fetch up to 100 listings in one call by their listing ids, with the same details as etsy_get_listing (title, description, state, price… |
etsy_get_shop_transactions | List the shop's sold items (transactions, one per listing line of an order): transaction_id, receipt_id, listing_id, title, sku, quantity… |
etsy_get_listing_properties | Read the attribute values set on a listing (colour, material, size, occasion, ...): one entry per property with property_id, property_name… |
etsy_set_listing_property | Set one attribute of a listing (e.g. primary colour, material, occasion), replacing its current values. property_id, the allowed value_ids… |
etsy_delete_listing_property | Remove one attribute (property) and its values from a listing |
etsy_read_listing_translation | Read a listing's translation into one language: translated title, description and tags |
etsy_add_listing_translation | Add a translation of a listing for buyers browsing Etsy in another language: title, description and optional tags in that language |
etsy_replace_listing_translation | Replace a listing's existing translation into one language: send the full translated title and description (and tags, which are cleared… |
etsy_list_listing_images | List the photos of a listing in display order: listing_image_id, rank, url_fullxfull and smaller sizes, dimensions, alt_text and the… |
etsy_delete_listing_image | Remove a photo from a listing |
etsy_list_listing_variation_images | List which photo is shown for which variation value of a listing (e.g. the red mug photo for Colour = Red): entries with property_id… |
etsy_assign_variation_images | Link listing photos to variation values, so buyers see the right photo when they pick an option |
etsy_list_listing_files | List the downloadable files of a digital listing: listing_file_id, filename, filesize, filetype, rank and creation time |
etsy_upload_listing_file | Attach a file buyers download after purchase to a digital listing (type download or both), from a public URL |
etsy_list_listing_videos | List the videos of a listing: video_id, height, width, thumbnail_url, video_url and video_state (active or still processing) |
etsy_add_listing_video | Upload an existing video file to a listing from a public URL |
etsy_delete_listing_permanently | Delete a listing for good, in any state (active, inactive, draft, expired, sold out) |
etsy_search_active_listings | Search all active listings on Etsy, not only your shop's, by keywords, category, price range or shop location: e.g. to see what similar… |
etsy_search_shops | Find Etsy shops by name |
etsy_list_production_partners | List the shop's production partners (people or companies who help make the items): production_partner_id, partner_name and location |
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?