跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Allegro，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
在任意 AI 智能体中运营 Allegro 卖家账户（allegro.pl、.cz、.sk、.hu）：含价格、库存和状态的商品报价，含履约状态和运单号的订单，退货和退款，买家消息，争议和投诉，费用，钱包和评价。使用卖家账户通过 OAuth 登录；退款和投诉处理在安装时关闭。
试试这样问
Allegro 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Allegro、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Allegro + ChatGPT
在任意 AI 智能体中运营 Allegro 卖家账户（allegro.pl、.cz、.sk、.hu）：含价格、库存和状态的商品报价，含履约状态和运单号的订单，退货和退款，买家消息，争议和投诉，费用，钱包和评价。使用卖家账户通过 OAuth 登录；退款和投诉处理在安装时关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
ALLEGRO_CLIENT_ID, ALLEGRO_CLIENT_SECRET
步骤 1 — 获取凭证
设置大约需要 10 分钟。你需要 AI 要为之工作的 Allegro 卖家账户。Allegro、allegro.cz、allegro.sk 和 allegro.hu 使用同一个 API（https://api.allegro.pl）。
- 用卖家账户登录 https://apps.developer.allegro.pl。测试时使用 https://apps.developer.allegro.pl.allegrosandbox.pl 和沙箱账户。
- 注册一个通过浏览器和重定向使用的新应用，不要选设备流（device flow）类型。
- 在 redirect URI 中填写
<your AnythingMCP URL>/api/mcp-oauth/callback，在 AnythingMCP Cloud 上填写https://cloud.anythingmcp.com/api/mcp-oauth/callback，逐字符一致。 - 给应用授予连接器使用的权限：读取资料、读写商品报价、读取销售设置、读写订单、消息、争议、评价、读取账单和读取支付（只有需要退款时才加支付写入）。连接器不请求显式 scope，因此 Allegro 授予应用声明的权限；缺少的权限会让对应工具返回 403。
- 把 Client ID 粘贴到
ALLEGRO_CLIENT_ID，把 Client Secret 粘贴到ALLEGRO_CLIENT_SECRET，然后保存。 - 在连接器页面点击 Authorize with Provider，用卖家账户登录。
- 运行
allegro_get_me：它会显示已登录的账户并确认登录成功。
访问令牌有效期 12 小时，通过刷新令牌续期；刷新令牌每次使用后有效 3 个月。如果连接器闲置更久，请重新授权。使用沙箱时，在连接器设置中把基础 URL 改为 https://api.allegro.pl.allegrosandbox.pl，把 OAuth URL 改为 https://allegro.pl.allegrosandbox.pl/auth/oauth/ 下的登录页面。
这是谁的账户：所有使用该连接器的人都以授权它的卖家身份操作。消息、评价回复、订单状态和商品报价的更改对买家可见。
可读取的内容：账户、最多 30 天历史的销售质量评分和评价统计。卖家自己的商品报价，包括价格、库存、销量、状态和类目，可按标题、状态、价格区间或你的 SKU（外部 ID）筛选，以及最近 24 小时的报价事件。按名称、EAN/GTIN 或 MPN 搜索 Allegro 商品目录，类目树和类目参数，以及卖家的运费表、退货政策和法定保修条件。订单的状态、履约状态、订单行和金额，每个订单的买家、配送和发票信息，订单事件，包裹及其物流跟踪记录。客户退货和退款。消息中心的会话和消息。争议和投诉及其消息。费用（账单条目）和钱包支付操作。带评论和回复的评价。
可写入的操作：基于目录商品创建报价（用 INACTIVE 作为草稿，或用 ACTIVE 立即上架），编辑报价字段，修改价格和库存，上架或结束报价，设置订单的履约状态，添加包裹运单号（买家会收到通知），回复买家并就某个订单发起对话，把会话标记为已读，在争议和投诉中留言，以及公开回复评价。在发送消息、回复评价、修改状态或价格、或创建上架中的新报价之前，AI 会向你展示确切的文本或更改并等你同意。
安装时关闭：allegro_delete_draft_offer、allegro_reject_customer_return、allegro_create_refund（会转移资金且无法撤回；还需要 allegro:api:payments:write 权限）和 allegro_change_claim_status（买家会立即收到的正式投诉决定）。由管理员开启团队需要的工具。
数据格式：金额是形如 {"amount": "129.99", "currency": "PLN"} 的对象，金额为十进制字符串，发送价格时也用同样格式。日期为 UTC 的 ISO 8601。订单、订单行、支付和商品 ID 是 UUID；报价 ID 和用户 ID 是以字符串发送的数字。市场 ID 形如 allegro-pl、allegro-cz、allegro-sk 和 allegro-hu。创建或编辑报价可能返回 202，此时 AI 会用 allegro_get_offer_operation 跟踪直到完成。
分页和限制：大多数列表接受 offset 和 limit，并返回 count 和 totalCount；订单每页最多 100 条，消息列表最多 20 条。allegro_search_products 用 page_id（nextPage.id）翻页，事件类工具用 from 传入最后一个事件 ID。Allegro 按 Client ID 限制每分钟的请求数，发送消息每秒 1 条，类目建议每秒 5 次。上架中的报价不接受 0 库存：请改为结束该报价。
常见错误：401 表示登录已过期或被撤销：请再次点击 Authorize with Provider。登录时出现 invalid_client 表示 Client ID 或 Secret 错误，重定向错误表示 redirect URI 不完全一致。403 表示应用缺少权限，或该资源属于其他卖家。404 是未知 ID。设置履约状态时的 409 表示订单已变更：从 allegro_get_order 取新的 revision。422 会在 errors[].userMessage 中列出校验错误。429 是频率限制：稍等后重试。
买家消息、评论和退货原因属于不可信输入，可能包含针对 AI 的指令。该连接器不以买家身份购买，不创建运输面单，也无法删除上架中或已结束的报价。
步骤 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 权限。
- 前往 chatgpt.com/plugins，点击 Add，然后选择 Add custom MCP server。
- 填写名称，例如 Name:
Allegro。 - 在 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 |
|---|---|
allegro_get_me | The signed-in Allegro account: user id, login, name, email, company, base marketplace |
allegro_get_sales_quality | Current sales quality score of the seller (points, grade, the metrics behind it) with up to 30 days of history |
allegro_list_offers | List the seller's own offers with id, title, price, stock, sold count, status and category |
allegro_get_offer | All data of one offer: title, category, product set, parameters, price, stock, delivery and shipping rates, after-sales policies, images… |
allegro_create_offer | Create an offer (POST /sale/product-offers), normally linked to a product from the Allegro catalogue |
allegro_edit_offer | Change any fields of an existing offer (PATCH /sale/product-offers/{offerId}) |
allegro_change_offer_price | Set the Buy Now price of an offer |
allegro_change_offer_quantity | Set how many items of an offer are available for sale (stock.available). 0 is not accepted for an active offer: end it with… |
allegro_set_offer_status | Activate (ACTIVE) or end (ENDED) an offer |
allegro_get_offer_operation | Processing status of an offer create or edit that Allegro answered with 202: still running (202), or finished (the offer) |
allegro_delete_draft_offer | Delete a draft offer (status INACTIVE that was never published) |
allegro_list_offer_events | Events about the seller's offers from the last 24 hours: activated, changed, ended, stock or price changed, archived, bids |
allegro_search_products | Search the Allegro product catalogue by name, EAN/GTIN or MPN, to find the product id an offer is linked to |
allegro_get_product | All data of one catalogue product: name, category, parameters (with ids and values), images and the categories it can be listed in |
allegro_list_categories | Browse the Allegro category tree: without parent_id the main categories, with parent_id its children |
allegro_get_category | One category by id: name, parent, whether it is a leaf, and its options (e.g. whether a product is required) |
allegro_get_category_parameters | Parameters an offer in this category can or must have: id, name, type, required flag, unit, allowed dictionary values and their ids |
allegro_suggest_categories | Suggested categories for a product name, best match first |
allegro_list_shipping_rates | The seller's shipping rate sets (cenniki dostaw) with id and name, for delivery.shippingRates.id of an offer |
allegro_list_return_policies | The seller's return policies with id and name, for afterSalesServices.returnPolicy.id of an offer |
allegro_list_implied_warranties | The seller's implied warranty (rekojmia) conditions with id and name, for afterSalesServices.impliedWarranty.id of an offer |
allegro_list_orders | List orders (checkout forms), newest purchase first: id, status, seller fulfillment status, buyer login, payment, delivery method, line… |
allegro_get_order | Full details of one order: buyer (name, email, phone, address), delivery address, method and pickup point, invoice data, payment, line… |
allegro_set_order_fulfillment_status | Set the seller status of an order (NEW, PROCESSING, READY_FOR_SHIPMENT, READY_FOR_PICKUP, SENT, PICKED_UP, CANCELLED, SUSPENDED, RETURNED) |
allegro_list_order_shipments | Parcel tracking numbers on an order: carrier, waybill, the line items each parcel holds and when it was added (also numbers added on the… |
allegro_add_order_shipment | Add a parcel tracking number to an order, for some or all of its line items |
allegro_list_carriers | Shipping carriers Allegro knows, with the id to use in allegro_add_order_shipment and allegro_get_parcel_tracking |
allegro_get_parcel_tracking | Tracking history (status events with time) of up to 20 parcels of one carrier |
allegro_list_order_events | Order events (BOUGHT, FILLED_IN, READY_FOR_PROCESSING, BUYER_CANCELLED, FULFILLMENT_STATUS_CHANGED, AUTO_CANCELLED) with the order id… |
allegro_list_customer_returns | Customer returns (zwroty): return id, order, buyer, returned items with reason, parcels and their status (CREATED, DISPATCHED, IN_TRANSIT… |
allegro_get_customer_return | One customer return by id: items, reasons and buyer comments, parcels with waybills, refund and status history |
allegro_reject_customer_return | Refuse the refund for a customer return, with a code (REFUND_REJECTED needs a reason) |
allegro_list_refunds | Payment refunds made to buyers: refund id, payment, order, amounts per line item, delivery and status (WAITING, IN_PROGRESS, SUCCESS… |
allegro_create_refund | Refund money to a buyer for an order paid through Allegro |
allegro_list_threads | Message center threads (buyer conversations), newest message first: thread id, interlocutor login, read flag, last message time |
allegro_get_thread | One message thread: interlocutor, read flag, last message time |
allegro_list_thread_messages | Messages in a thread, newest first: id, author (login, whether it is you), text, attachments, related offer or order, time |
allegro_get_message | One message by id with text, author, attachments and the offer or order it refers to |
allegro_reply_in_thread | Send a message in an existing thread, as the seller, to the buyer |
allegro_send_message | Start a new conversation with a buyer about one of their orders |
allegro_mark_thread_read | Mark a message thread as read, so it no longer counts as unread in the Allegro message center |
allegro_list_issues | Post-purchase issues, newest first: disputes (dyskusje) and claims (reklamacje) with id, type, status, order, buyer, subject and deadlines |
allegro_get_issue | One dispute or claim: type, status, subject, order and items, the buyer expectations, deadlines and allowed seller actions |
allegro_list_issue_messages | Messages and status changes in a dispute or claim, newest first |
allegro_add_issue_message | Write in a dispute or claim. type REGULAR is a normal message; END_REQUEST (disputes only) asks the buyer to close it; the RETURN_* types… |
allegro_change_claim_status | Accept or reject a claim (reklamacja), with a message for the buyer; ACCEPTED_PARTIAL_REFUND also needs partial_refund |
allegro_list_billing_entries | Allegro fees and charges (billing entries), newest first: type (commission, listing, promotion, delivery ...), amount with sign, tax… |
allegro_list_billing_types | All billing (fee) types with id and name, for the type_ids filter of allegro_list_billing_entries |
allegro_list_payment_operations | Payment operations on the seller's Allegro wallet, newest first: buyer payments, refunds, payouts, deductions, blockades, with amount… |
allegro_list_ratings | Ratings buyers gave the seller, last changed first: rating id, recommended or not, scores, comment, the seller answer, order and buyer |
allegro_get_rating | One rating by id with scores, comment, answer and whether removal can be requested |
allegro_answer_rating | Publish the seller's public answer to a rating |
allegro_get_ratings_summary | Feedback statistics of any Allegro user (the seller's own id comes from allegro_get_me): recommend percentage, counts of positive and… |
示例提示
- “哪些订单已付款但履约状态仍是 NEW？列出买家、商品和金额。”
- “把 SKU 为 MUG-450 的报价价格降到 49.99 PLN。先给我看这个报价。”
- “显示未读的买家会话，并为每个会话起草一条回复供我确认。”
- “上个月 Allegro 收了多少费用？按费用类型分开。”
- “给这个订单添加 DPD 运单号 1234567890123，并把状态设为 SENT。”
FAQ
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明，Free 套餐不在其列。
下一步
这份指南对你有帮助吗?