Connector guide2-minute read9 MCP toolsEnglish · Deutsch · Italiano

如何将 Etsy 连接到 Gemini — 通过 MCP

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

Etsy

MCP connector

Etsy

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

Tools

9

Region

INTL

Category

e-commerce

Authentication

API Key

Required env vars

ETSY_API_KEYETSY_ACCESS_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Etsy in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

TL;DR

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

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

Etsy + Gemini

Read Etsy shop data (listings, transactions, receipts, reviews) from any AI agent. 9 tools, OAuth2 + x-api-key dual auth.

前提条件

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

ETSY_API_KEY, ETSY_ACCESS_TOKEN

步骤 1 — 获取凭证

etsy.com).

Setup:

  1. Register an app at https://www.etsy.com/developers/your-appsCreate New App.
  2. Note the Keystring (this is your x-api-key) and Shared secret.
  3. Run OAuth2 PKCE flow with scopes transactions_r listings_r email_r shops_r (or write-scopes if needed).
  4. Get the access token (1 hour expiry) + refresh token (long-lived).
  5. Set:
    • ETSY_API_KEY = the Keystring (a.k.a. x-api-key)
    • ETSY_ACCESS_TOKEN = the OAuth2 access token

…(continued in the in-app connector instructions)

步骤 2 — 安装 adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

Gemini CLI 从 ~/.gemini/settings.json (Windows: %APPDATA%\gemini\settings.json) 读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. 从 AnythingMCP 获取你的 MCP API key
  2. 保存文件并重启 gemini
  3. 在 Gemini CLI 中运行 /mcpEtsy 应显示为可用。
  4. Vertex AI Studio: 将 https://cloud.anythingmcp.com/mcp 传入请求的 tools 数组,使用相同的 Bearer 头。

可用工具

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

FAQ

Gemini 1.5 Pro 或 2.x 支持 MCP 吗? 支持 — Gemini CLI ≥ 0.4 与 Vertex AI tools API 均接受带 Bearer 头的 MCP httpUrl 连接器。

下一步

这份指南对您有帮助吗?

Ready to ship

Your Etsy agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

相关指南