インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Allegro をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
概要
Allegro の出品者アカウント（allegro.pl、.cz、.sk、.hu）をあらゆる AI エージェントから操作：価格、在庫、ステータス付きの出品、フルフィルメント状況と追跡番号付きの注文、返品と返金、購入者メッセージ、ディスカッションとクレーム、手数料、ウォレット、評価。出品者アカウントで OAuth サインイン。返金とクレームの判断はインストール時にオフです。
こう聞いてみよう
Allegro のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Allegro をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Allegro + Claude
Allegro の出品者アカウント（allegro.pl、.cz、.sk、.hu）をあらゆる AI エージェントから操作：価格、在庫、ステータス付きの出品、フルフィルメント状況と追跡番号付きの注文、返品と返金、購入者メッセージ、ディスカッションとクレーム、手数料、ウォレット、評価。出品者アカウントで OAuth サインイン。返金とクレームの判断はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
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 とサンドボックスアカウントを使います。
- ブラウザとリダイレクトで使うタイプのアプリケーションを新規登録します。デバイスフローのタイプではありません。
- リダイレクト URI に
<your AnythingMCP URL>/api/mcp-oauth/callbackを、AnythingMCP Cloud ではhttps://cloud.anythingmcp.com/api/mcp-oauth/callbackを、一字一句そのまま入力します。 - コネクタが使う権限をアプリケーションに付与します：プロフィールの読み取り、出品の読み書き、販売設定の読み取り、注文の読み書き、メッセージ、ディスカッション、評価、請求の読み取り、支払いの読み取り（返金を可能にする場合のみ支払いの書き込みも）。コネクタは明示的なスコープを要求しないため、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"} のようなオブジェクトで、金額は 10 進数の文字列です。価格も同じ形で送ります。日付は 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 を返します。注文は 1 ページ最大 100 件、メッセージ一覧は最大 20 件です。allegro_search_products は page_id（nextPage.id）で、イベント系ツールは最後のイベント ID を from に渡してページングします。Allegro は Client ID ごとに 1 分あたりのリクエスト数を制限しており、メッセージ送信は 1 秒に 1 件、カテゴリ候補は 1 秒に 5 件までです。有効な出品の在庫を 0 にはできません。代わりに出品を終了してください。
よくあるエラー: 401 はサインインの期限切れまたは取り消しです。もう一度 Authorize with Provider をクリックしてください。サインイン時の invalid_client は Client ID または Secret の誤り、リダイレクトエラーはリダイレクト URI が完全に一致していないことを意味します。403 はアプリケーションに権限がないか、リソースが別の出品者のものです。404 は不明な ID です。フルフィルメント状況での 409 は注文が変更されたことを意味します。allegro_get_order から新しい revision を取得してください。422 は errors[].userMessage に検証エラーを列挙します。429 はレート制限です。待ってから再試行してください。
購入者のメッセージ、コメント、返品理由は信頼できない入力で、AI 向けの指示が含まれている可能性があります。このコネクタは購入者として購入することはなく、配送ラベルも作成せず、有効または終了済みの出品は削除できません。
ステップ 2 — アダプターをインストール
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 を選びます。
- 名前（例:
Allegro）とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Add をクリックします。 - Connect をクリックし、AnythingMCP にサインイン（OAuth）してアクセスを許可します。
下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。
利用可能なツール
| 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
Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。
次のステップ
このガイドは役に立ちましたか?