跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Etsy，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
从任意 AI 代理经营 Etsy 店铺：创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号，并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。
试试这样问
Etsy 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Etsy、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
Etsy + Gemini
从任意 AI 代理经营 Etsy 店铺：创建商品草稿、编辑并发布、添加图片、设置价格和库存、为订单添加物流单号，并读取商品、订单、收据和评价。OAuth2 自动轮换 refresh token + x-api-key 双重认证。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
ETSY_CLIENT_ID, ETSY_CLIENT_SECRET
步骤 1 — 获取凭证
You authorize it once, in AnythingMCP; from then on the short-lived access token (1 hour) is renewed automatically, and the refresh token Etsy replaces on every renewal is stored for you.
Setup:
- Register an app at https://www.etsy.com/developers/your-apps → Create New App.
- In the app's settings, add this callback URL:
https://cloud.anythingmcp.com/api/mcp-oauth/callbackon AnythingMCP Cloud, or<your AnythingMCP server URL>/api/mcp-oauth/callbackwhen you host AnythingMCP yourself. Etsy compares it character for character (https, upper/lower case, no trailing slash).
…(continued in the in-app connector instructions)
步骤 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 — 在 Gemini 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json (Windows: %APPDATA%\gemini\settings.json) 读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 从 AnythingMCP 获取你的 MCP API key。
- 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp—Etsy应显示为可用。 - Vertex AI Studio: 将
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID传入请求的tools数组,使用相同的 Bearer 头。
可用工具
| 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 |
FAQ
Gemini 1.5 Pro 或 2.x 支持 MCP 吗? 支持 — Gemini CLI ≥ 0.4 与 Vertex AI tools API 均接受带 Bearer 头的 MCP httpUrl 连接器。
下一步
这份指南对你有帮助吗?
