Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Aymakan одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.
Кратко
Курьерская служба Aymakan (Саудовская Аравия) в AI-агенте: отслеживание отправлений по трек-номеру или номеру заказа, список ваших отправлений, ссылки на этикетки AWB, заявки на забор и временные окна, города, пункты PUDO, склады и сохранённые адреса. Создание и отмена отправлений и заборов включены, но при установке отключены.
Попробуй спросить
Примеры промптов для Aymakan
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Aymakan, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Aymakan + Claude
Курьерская служба Aymakan (Саудовская Аравия) в AI-агенте: отслеживание отправлений по трек-номеру или номеру заказа, список ваших отправлений, ссылки на этикетки AWB, заявки на забор и временные окна, города, пункты PUDO, склады и сохранённые адреса. Создание и отмена отправлений и заборов включены, но при установке отключены.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
AYMAKAN_API_KEY
Шаг 1 — Получите учётные данные
Настройка занимает около 2 минут. Нужен клиентский аккаунт Aymakan, саудовской курьерской службы.
- Войдите в клиентский кабинет Aymakan.
- Откройте Technical → AyMakan API и скопируйте API-ключ (security code).
- Вставьте его как есть в
AYMAKAN_API_KEY, без слова Bearer. - Установите коннектор и запустите
aymakan_ping: вlogged_inдолжно бытьYes.
Используйте рабочий ключ: ключ из тестовой среды Aymakan здесь отвечает Invalid Credentials. После перевыпуска ключа в кабинете старый перестаёт работать, поэтому обновите и другие интеграции, которые его используют.
Что он читает: ваши отправления по трек-номеру или по вашему номеру заказа с данными доставки и забора, суммой наложенного платежа, весом, количеством мест, текущим статусом и полной историей статусов на английском и арабском; список всех отправлений аккаунта с попытками доставки и основными датами; ссылки на этикетки (AWB); ваши заявки на забор, города, где возможен забор, и свободные окна на дату; города, куда доставляет Aymakan; пункты PUDO, такие как постаматы и партнёрские магазины; склады Aymakan; и адреса забора, сохранённые в аккаунте.
Этикетки только до забора: Aymakan отдаёт ссылку на PDF-этикетку, только пока отправление в статусе AY-0001 (создано, ещё не забрано). После забора API отвечает 422, поэтому печатайте этикетки до приезда курьера. Для нескольких отправлений ИИ может получить один PDF со всеми этикетками.
Поиск по номеру заказа: работает только для отправлений, созданных с номером заказа, и находит только отправления вашего аккаунта. Несуществующий номер отвечает No Shipments Found.
Отключено при установке: aymakan_create_shipment, aymakan_cancel_shipment, aymakan_create_pickup_request и aymakan_cancel_pickup_request. Они заказывают или отменяют реальную работу курьера, поэтому администратор включает их осознанно. Даже тогда ИИ сначала показывает отправление (получатель, город, сумма наложенного платежа, места), трек-номер или заявку на забор и ждёт вашего согласия. Отменить отправление можно только в статусе AY-0001, заявку на забор только пока она ожидает или в обработке.
Ограничения: список отправлений приходит фиксированными страницами по 100 (около 110 КБ каждая), поэтому для одного отправления ИИ использует отслеживание. Aymakan ограничивает число заявок на забор на клиента в день.
Частые ошибки: 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 — Добавьте коннектор в Claude
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.
- Открой в Claude Customize → Connectors.
- Нажми +, затем Add custom connector.
- Введи название, например
Aymakan, и URL удалённого MCP-сервераhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add. - Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.
Все инструменты ниже появятся в чате: начинайте писать промпты.
Доступные инструменты
| 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 и покажи всю историю статусов.»
- «Какие мои отправления на этой неделе потребовали больше одной попытки доставки и в каких городах?»
- «Сделай один PDF с этикетками всех отправлений, созданных сегодня и ещё не забранных курьером.»
- «Какие окна для забора свободны завтра и какие мои заявки на забор ещё ожидают?»
FAQ
Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Следующие шаги
- Страница коннектора
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?
