连接器指南阅读约 6 分钟42 个 MCP 工具7 种语言

Etsy MCP:连接 ChatGPT 管理商品和订单

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

HC作者:HelpCode 团队更新于 6 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Etsy

Etsy

Run an Etsy shop from any AI agent: create draft listings, edit and publish them, add photos, videos and digital files, set price, stock, attributes and translations, add tracking to orders, and read listings, orders, receipts and reviews. OAuth2 with automatic refresh-token rotation + x-api-key dual auth.

个工具

42

区域

INTL

类别

电子商务

身份验证

OAuth 2.0

所需环境变量

ETSY_CLIENT_IDETSY_CLIENT_SECRET
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

引导式设置

2 分钟将 Etsy 连接到 ChatGPT

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Etsy,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。

试试这样问

Etsy 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Etsy · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Etsy、粘贴凭证、生成 MCP API key — 完成。无 Docker、无 git clone、无本地服务器。

Etsy + ChatGPT

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

ETSY_CLIENT_ID, ETSY_CLIENT_SECRET

步骤 1 — 获取凭证

Etsy 会在每个新应用可用前进行审核,通常在一天内完成。你可以马上开始:等待期间 AnythingMCP 会保存你的密钥。在 AnythingMCP Cloud 上,Etsy 设置页面 会带你完成这些步骤,并在 Etsy 批准你的应用后提醒你。

  1. 创建 Etsy 应用。 打开 Etsy 的应用注册表单,用拥有店铺的账号登录,创建一个个人应用(personal app)。Etsy 会在 Personal Apps 中列出它,状态为 Pending Personal Approval:这是正常的。
  2. 复制两个密钥。 在 你的 Etsy 应用页面 的 Personal Apps 同一行中,把 Keystring 和 Shared Secret 复制到 AnythingMCP 并保存。应用仍在审核中时也可以这样做。
  3. 等待 Etsy 批准。 应用获批后 Etsy 会给你发邮件;大多数在一天内获批。在此之前,点击应用名称不会有任何反应。
  4. 添加回调 URL。 应用生效后,点击它的名称打开应用页面,在 Callback URLs 中添加 https://cloud.anythingmcp.com/api/mcp-oauth/callback(自托管:<你的 AnythingMCP 服务器 URL>/api/mcp-oauth/callback)。Etsy 会逐字符比对。
  5. 用 Etsy 登录。 点击 Authorize with Provider(在设置页面上是 Sign in with Etsy),用拥有店铺的账号授权。回来后工具即可使用。 Etsy 还会请求删除商品的权限(listings_d),只有默认关闭的删除工具会用到它。

商品详情、媒体和搜索:AI 还可以读取和设置商品属性(颜色、材质、尺寸),添加或替换商品翻译(标题、描述、标签),列出商品图片并将其关联到变体值,添加商品视频,上传买家从数字商品下载的文件,列出你的生产合作伙伴,以及搜索 Etsy 上所有在售商品和店铺。三个会永久删除内容的工具安装后默认关闭: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 — 安装 adapter

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 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。

  1. 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
  2. 填写名称,例如 Name: Etsy。
  3. 在 Connection 下的 Server URL 中填入 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。
  4. 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
  5. 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。

可用工具

ToolWhat it does
etsy_get_authenticated_userReturn the user the OAuth token belongs to
etsy_get_user_shopsList shops owned by the user
etsy_get_shopFetch one shop by shop_id with full details (announcement, sale message, etc.)
etsy_get_shop_listings_activeList active listings in a shop
etsy_get_listingFetch one listing by listing_id with full details
etsy_get_shop_receiptsList orders (receipts) for the shop
etsy_get_shop_receiptFetch one receipt with buyer info, transactions[], shipping address
etsy_get_shop_reviewsList reviews (transactions with feedback) for the shop
etsy_get_listings_by_shop_sectionList listings filtered by a shop section
etsy_get_listings_by_shopListings of your own shop by state (active, inactive, sold_out, draft, removed, expired), as the shop owner sees them
etsy_list_seller_taxonomyThe full tree of Etsy seller categories (id, name, children)
etsy_list_taxonomy_propertiesProperties (size, colour, material…) and their allowed values for one seller category
etsy_list_shipping_profilesThe shop's shipping profiles
etsy_list_processing_profilesThe shop's processing profiles (Etsy calls them readiness states: ready to ship or made to order, with processing times)
etsy_list_return_policiesThe shop's return policies
etsy_list_shop_sectionsThe shop's sections, to file a listing under one with shop_section_id
etsy_read_listing_inventoryProducts, prices, quantities and SKUs of a listing, per variation
etsy_create_listing_draftCreate a listing as a draft (not visible to buyers)
etsy_edit_listingChange a listing: title, description, tags, category, shipping, section, or state. state=active publishes a draft (it needs at least one…
etsy_set_listing_inventorySet price, quantity and SKU of a listing, per variation
etsy_add_listing_imageAdd 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_trackingMark an order (receipt) as shipped with its tracking code
etsy_get_listings_by_idsFetch 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_transactionsList 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_propertiesRead the attribute values set on a listing (colour, material, size, occasion, ...): one entry per property with property_id, property_name…
etsy_set_listing_propertySet one attribute of a listing (e.g. primary colour, material, occasion), replacing its current values. property_id, the allowed value_ids…
etsy_delete_listing_propertyRemove one attribute (property) and its values from a listing
etsy_read_listing_translationRead a listing's translation into one language: translated title, description and tags
etsy_add_listing_translationAdd a translation of a listing for buyers browsing Etsy in another language: title, description and optional tags in that language
etsy_replace_listing_translationReplace a listing's existing translation into one language: send the full translated title and description (and tags, which are cleared…
etsy_list_listing_imagesList 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_imageRemove a photo from a listing
etsy_list_listing_variation_imagesList 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_imagesLink listing photos to variation values, so buyers see the right photo when they pick an option
etsy_list_listing_filesList the downloadable files of a digital listing: listing_file_id, filename, filesize, filetype, rank and creation time
etsy_upload_listing_fileAttach a file buyers download after purchase to a digital listing (type download or both), from a public URL
etsy_list_listing_videosList the videos of a listing: video_id, height, width, thumbnail_url, video_url and video_state (active or still processing)
etsy_add_listing_videoUpload an existing video file to a listing from a public URL
etsy_delete_listing_permanentlyDelete a listing for good, in any state (active, inactive, draft, expired, sold out)
etsy_search_active_listingsSearch 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_shopsFind Etsy shops by name
etsy_list_production_partnersList 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 套餐不在其列。

下一步

这份指南对你有帮助吗?

2 分钟将 Etsy 连接到 ChatGPT

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Etsy,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。

相关指南

连接器

Etsy MCP:连接 Microsoft Copilot 管理店铺

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

连接器

Etsy MCP:连接 Meta Muse 管理商品和订单

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

连接器

Etsy MCP:连接 Claude 管理商品和订单

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

连接器

Etsy MCP:连接 Cursor 管理商品和订单

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

连接器

Etsy MCP:连接 Gemini CLI 管理店铺

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。

连接器

Etsy MCP 服务器:商品、订单与评价

从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。