摘要
从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。
引导式设置
2 分钟将 Etsy 连接到 Claude
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Etsy,再把你的 MCP URL 添加到 Claude。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
试试这样问
Etsy 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Etsy、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
Etsy + Claude
从任意 AI 代理经营 Etsy 店铺:创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号,并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
ETSY_CLIENT_ID, ETSY_CLIENT_SECRET
步骤 1 — 获取凭证
Etsy 会在每个新应用可用前进行审核,通常在一天内完成。你可以马上开始:等待期间 AnythingMCP 会保存你的密钥。在 AnythingMCP Cloud 上,Etsy 设置页面 会带你完成这些步骤,并在 Etsy 批准你的应用后提醒你。
- 创建 Etsy 应用。 打开 Etsy 的应用注册表单,用拥有店铺的账号登录,创建一个个人应用(personal app)。Etsy 会在 Personal Apps 中列出它,状态为 Pending Personal Approval:这是正常的。
- 复制两个密钥。 在 你的 Etsy 应用页面 的 Personal Apps 同一行中,把 Keystring 和 Shared Secret 复制到 AnythingMCP 并保存。应用仍在审核中时也可以这样做。
- 等待 Etsy 批准。 应用获批后 Etsy 会给你发邮件;大多数在一天内获批。在此之前,点击应用名称不会有任何反应。
- 添加回调 URL。 应用生效后,点击它的名称打开应用页面,在 Callback URLs 中添加
https://cloud.anythingmcp.com/api/mcp-oauth/callback(自托管:<你的 AnythingMCP 服务器 URL>/api/mcp-oauth/callback)。Etsy 会逐字符比对。 - 用 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 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
推荐路径 — 在 claude.ai web 上工作,无需触碰任何配置文件。
- 在 Claude 中打开 Customize → Connectors。
- 点击 +,然后点击 Add custom connector。
- 输入名称(例如
Etsy)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。 - 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。
下面所有工具都会出现在你的聊天中 — 开始输入提示。
可用工具
| 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
Claude Code 和 Claude Desktop 一样工作吗? 是的 — 两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
下一步
这份指南对你有帮助吗?