インストール不要。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 + Cursor
サウジアラビアの宅配便 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 — Cursor にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう。エージェントが
Aymakanのツールを呼び出せるようになりました。
利用可能なツール
| 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
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?
