概要
ウクライナのマーケットプレイス店舗向けの Prom.ua 販売者 API です。購入者と配送の詳細を含む注文、注文ステータスの変更、商品と商品グループ、顧客、購入者からのメッセージを扱います。販売者キャビネットで発行したベアラートークンを使用します。
ガイド付きセットアップ
Prom.ua を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Prom.ua を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Prom.ua のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Prom.ua をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。
Prom.ua + Microsoft Copilot
ウクライナのマーケットプレイス店舗向けの Prom.ua 販売者 API です。購入者と配送の詳細を含む注文、注文ステータスの変更、商品と商品グループ、顧客、購入者からのメッセージを扱います。販売者キャビネットで発行したベアラートークンを使用します。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
PROM_UA_API_TOKEN
ステップ 1 — 認証情報を取得
- Prom.ua の販売者キャビネットで Settings → API token management（Налаштування → Управління API-токенами）を開き、トークンを作成します。
- アシスタントに使わせるセクション（注文、商品、顧客、メッセージ）へのアクセス権を付与し、トークンを
PROM_UA_API_TOKENに貼り付けます。トークンは作成元の会社のデータしか参照できません。誤ったトークンや失効したトークンには HTTP 401 が返ります。 - まず
prom_ua_list_orders（ステータスまたは日付で絞り込み）を実行し、次にprom_ua_get_orderで購入者、配送、商品の詳細を確認します。prom_ua_list_order_statusesは、カスタムステータスを含むこの会社のステータスを表示します。
prom_ua_set_order_status は実際の注文を変更し、その変更は購入者にも表示されます。そのためアシスタントは注文 ID と新しいステータスを提示し、承認を待ちます。キャンセルには cancellation_reason が必要です。日付は UTC です（2026-10-01T12:00:00）。一覧は新しい順に並び、limit と last_id でページングします。次のページを取得するには、受け取った中で最も小さい ID を last_id として渡します。
ステップ 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 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Prom.uaのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
prom_ua_list_orders | List Prom.ua orders of the company, newest first, with buyer, contact, delivery and payment details and the ordered products |
prom_ua_get_order | Get one Prom.ua order by its numeric id: buyer and contact data, delivery method and address, payment, status and the products with… |
prom_ua_list_order_statuses | List the order statuses available to this Prom.ua company, including custom statuses and their ids |
prom_ua_set_order_status | Change the status of one or more Prom.ua orders (received, delivered, canceled, paid) or set a custom status |
prom_ua_list_products | List products of the Prom.ua store with name, SKU, price, availability, group and images |
prom_ua_get_product | Get one Prom.ua product by its numeric Prom id, with description, prices, stock state, group and images |
prom_ua_get_product_by_external_id | Get one Prom.ua product by the id it has in the seller's own accounting or ERP system (external_id) |
prom_ua_list_groups | List the product groups (store categories) of the Prom.ua company with ids, names and parent groups |
prom_ua_list_clients | List the store's Prom.ua clients (buyers) with contact data, or search them by name, phone number or e-mail |
prom_ua_get_client | Get one Prom.ua client by numeric id, with contact details and order statistics |
prom_ua_list_messages | List messages that buyers sent to the store through Prom.ua (questions about products and orders), filtered by read status or date |
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?