インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Aymakan をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
サウジアラビアの宅配便 Aymakan を AI エージェントから利用します。追跡番号や注文参照番号による配送追跡、配送一覧、AWB ラベルのリンク、集荷依頼と時間帯、都市、PUDO 拠点、倉庫、保存済み住所を扱えます。配送と集荷の作成・取り消しも含まれますが、インストール時はオフです。
こう聞いてみよう
Aymakan のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Aymakan をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Aymakan + Microsoft Copilot
サウジアラビアの宅配便 Aymakan を AI エージェントから利用します。追跡番号や注文参照番号による配送追跡、配送一覧、AWB ラベルのリンク、集荷依頼と時間帯、都市、PUDO 拠点、倉庫、保存済み住所を扱えます。配送と集荷の作成・取り消しも含まれますが、インストール時はオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
AYMAKAN_API_KEY
ステップ 1 — 認証情報を取得
セットアップは約 2 分です。サウジアラビアの宅配便 Aymakan の顧客アカウントが必要です。
- Aymakan の顧客ダッシュボードにサインインします。
- Technical → AyMakan API を開き、API キー（セキュリティコード）をコピーします。
- そのまま
AYMAKAN_API_KEYに貼り付けます。Bearer という語は付けません。 - コネクターをインストールして
aymakan_pingを実行します。logged_inがYesになっていれば成功です。
本番用のキーを使ってください: Aymakan の開発環境のキーでは Invalid Credentials が返ります。ダッシュボードでキーを再発行すると古いキーは使えなくなるため、同じキーを使っている他の連携も更新してください。
読み取れるデータ: 追跡番号または自社の注文参照番号による配送情報（配達先と集荷元、代金引換額、重量、個数、現在のステータス、英語とアラビア語のステータス履歴）、配達試行回数と主な日付を含むアカウントの全配送一覧、ラベル（AWB）のリンク、集荷依頼、集荷可能な都市、指定日の空き時間帯、Aymakan の配達対象都市、ロッカーや提携店舗などの PUDO 拠点、Aymakan の倉庫、そしてアカウントに保存された集荷先住所です。
ラベルは集荷前のみ: Aymakan がラベル PDF のリンクを返すのは、配送がまだ AY-0001（作成済み、未集荷）の間だけです。集荷後は API が 422 を返すため、ドライバーが来る前にラベルを印刷してください。複数の配送については、AI がすべてのラベルをまとめた PDF を 1 つ取得できます。
注文番号での検索: 参照番号付きで作成された配送のみ対象で、見つかるのは自社アカウントの配送だけです。存在しない参照番号には No Shipments Found が返ります。
インストール時はオフ: aymakan_create_shipment、aymakan_cancel_shipment、aymakan_create_pickup_request、aymakan_cancel_pickup_request。実際の配送業務を予約または取り消すため、管理者が意図して有効にします。その場合でも AI はまず配送（受取人、都市、代金引換額、個数）、追跡番号、または集荷依頼を示し、あなたの承認を待ちます。配送を取り消せるのは AY-0001 の間だけ、集荷依頼は保留中または処理中の間だけです。
制限: 配送一覧は 100 件固定のページ（1 ページ約 110 KB）で返るため、1 件だけ調べるときは AI が追跡を使います。Aymakan は顧客ごと・1 日あたりの集荷依頼の数を制限しています。
よくあるエラー: 401 Invalid Credentials は、キーの誤り、再発行前の古いキー、または開発用キーを示します。422 はメッセージに理由が入っており、たとえば No Shipments Found、項目ごとの検証エラー、すでに AY-0001 を過ぎた配送へのラベル要求などです。
このコネクターは代金引換の精算や請求書を扱わず、管理者がツールを有効にしない限り配送や集荷の予約・取り消しも行いません。
ステップ 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 ウィンドウで試します。
Aymakanのツールが必要になる依頼をしてみましょう。 - 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 |
|---|---|
aymakan_ping | Check the Aymakan API status and the API key: returns status, environment (production) and logged_in Yes or No |
aymakan_get_tracking | Track one or more Aymakan shipments by tracking number: full shipment data with delivery and collection details, COD amount, weight and… |
aymakan_get_shipments_by_reference | Get Aymakan shipments by your own order reference (the reference given when the shipment was created): full shipment data, tracking_info… |
aymakan_list_shipments | List every shipment of the account, 100 per page (fixed by Aymakan): tracking number, reference, service type, COD flag and amount, pieces… |
aymakan_get_awb_label | Get the link to the PDF AWB label of one shipment by tracking number |
aymakan_get_bulk_awb_labels | Get one PDF link with the AWB labels of several shipments |
aymakan_list_pickup_requests | List the pickup requests of the account with id, pickup code, type, contact, city and address, number of shipments and picked shipments… |
aymakan_list_pickup_cities | List the cities where Aymakan accepts pickup requests, in English and Arabic |
aymakan_get_time_slots | Get the pickup time slots available to the account on a date (e.g. morning, afternoon, evening with their hours) |
aymakan_list_cities | List the cities Aymakan delivers to, in English (city_en) and Arabic (city_ar) |
aymakan_list_pudo_locations | List PUDO (pickup and drop-off) points such as lockers and partner shops with id, name in English and Arabic, address, city, coordinates… |
aymakan_list_dropoff_locations | List Aymakan's warehouses where shipments can be dropped off: name, city, address, manager, phone, e-mail and coordinates |
aymakan_list_addresses | List the collection addresses saved on the Aymakan account: id, title, name, e-mail, city, address, postcode, neighbourhood, phone, country… |
aymakan_create_shipment | Create a new Aymakan shipment |
aymakan_cancel_shipment | Cancel an Aymakan shipment by tracking number |
aymakan_create_pickup_request | Book a courier pickup: date (today or later), time slot from aymakan_get_time_slots, city from aymakan_list_pickup_cities, contact name and… |
aymakan_cancel_pickup_request | Cancel a pickup request by its id (from aymakan_list_pickup_requests) |
プロンプトの例
- 「配送 AY2866494373 と AY2866494374 は今どこにありますか。」
- 「注文参照番号 10045 の配送を探して、ステータス履歴をすべて見せてください。」
- 「今週の配送のうち、配達が 1 回で済まなかったものはどれですか。都市も教えてください。」
- 「今日作成してまだ集荷されていない配送のラベルを、1 つの PDF にまとめてください。」
- 「明日空いている集荷の時間帯はどれですか。まだ保留中の集荷依頼も教えてください。」
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" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?