Как подключить Billbee к Meta Muse через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Billbee Order Management, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Billbee + Meta Muse

Дайте ИИ работать с управлением заказами в Billbee: находить заказы со всех ваших маркетплейсов и магазинов по дате или номеру заказа маркетплейса, искать товары по SKU или EAN с ценой и остатком, смотреть историю заказов клиента и список ваших служб доставки. Только чтение, с API-ключом Billbee, email для входа и паролем API.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

BILLBEE_API_KEY, BILLBEE_LOGIN_EMAIL, BILLBEE_API_PASSWORD

Шаг 1 — Получите учётные данные

1. Войдите в Billbee и откройте Einstellungen (Settings) → Billbee API. В общих настройках на этой странице включите доступ к API и задайте пароль API. Это отдельный пароль только для API, а не тот, с которым вы входите.
2. Запросите API-ключ у Billbee: через их форму запроса API или письмом на [email protected], коротко описав, что вы хотите подключить (здесь: ваш ИИ, который читает заказы через AnythingMCP). Ключ Billbee пришлёт вам.
3. Вставьте ключ в BILLBEE_API_KEY, email, с которым вы входите в Billbee, в BILLBEE_LOGIN_EMAIL, а пароль API из шага 1 в BILLBEE_API_PASSWORD.
4. Установите коннектор. Шага Authorize with Provider нет: каждый вызов передаёт API-ключ в заголовке X-Billbee-Api-Key, а email и пароль API через HTTP Basic auth.
5. Начните с billbee_list_shipping_providers: ему не нужны параметры, он показывает службы доставки, настроенные в вашем аккаунте. Если пришёл ответ, все три значения работают.

Три значения, все обязательны: Billbee отклоняет вызов, в котором есть только API-ключ или только email и пароль API. В коннекторе должны быть заданы все три.

Как не потерять авторизацию: обновлять токены не нужно, коннектор передаёт три значения при каждом вызове. Если вы смените пароль API в Billbee или получите новый API-ключ, обновите BILLBEE_API_PASSWORD или BILLBEE_API_KEY на странице коннектора.

Только чтение: все 8 инструментов только читают заказы, товары, клиентов и службы доставки. Коннектор ничего не может создать или изменить в Billbee, поэтому для режима только для чтения ничего отключать не нужно. При этом отдельные инструменты можно отключить на странице коннектора, например billbee_list_customers и billbee_get_customer_orders, если ИИ не должен видеть данные клиентов.

Заказы: billbee_list_orders фильтрует по дате заказа (minOrderDate, maxOrderDate) и по последнему изменению (modifiedAtMin, modifiedAtMax), даты в формате ISO 8601, например 2026-01-01. billbee_get_order возвращает полный заказ с позициями, адресами, данными об оплате и доставке по ID заказа в Billbee. billbee_get_order_by_extref находит заказ по номеру заказа маркетплейса или магазина, например по номеру заказа Amazon или eBay. Статусы заказов приходят в виде чисел.

Товары и клиенты: billbee_get_product ищет товар по его ID в Billbee или по SKU либо EAN, если lookupBy равен sku или ean, и возвращает цены и остаток. billbee_list_products можно ограничить товарами, созданными после указанной даты (minCreatedAt). У billbee_list_customers нет поиска, поэтому найти клиента по имени можно только листая список; по ID клиента billbee_get_customer_orders показывает его заказы.

Страницы и лимиты запросов: инструменты списков возвращают до 250 строк на страницу (pageSize), в ответе есть Page, TotalPages и TotalRows, и ИИ запрашивает следующую page, пока не дойдёт до последней. Billbee допускает 2 запроса в секунду на API-ключ и пользователя и при превышении отвечает 429: подождите немного и повторите попытку. Использование API сверх бесплатного объёма Billbee оплачивается, поэтому узкие диапазоны дат и modifiedAtMin лучше, чем раз за разом выгружать всё.

Частые ошибки: если Billbee отклоняет учётные данные, проверьте, что заданы все три переменные, что доступ к API включён в Einstellungen → Billbee API и что в BILLBEE_API_PASSWORD указан пароль API, а не пароль для входа. 429 означает, что превышен лимит в 2 запроса в секунду.

Коннектор не создаёт и не редактирует заказы, не меняет их статусы, не обновляет остатки, не создаёт отправления и этикетки и не создаёт счета и другие документы.

Шаг 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 — Добавьте коннектор в Muse

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси Muse о том, для чего нужны инструменты Billbee.

Настроить коннектор можно и из чата: в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Какие заказы пришли за последние 7 дней и какие из них ещё не отправлены?»
• «Найди заказ с номером заказа маркетплейса 302-1234567-1234567 и покажи позиции, адрес доставки и данные об оплате.»
• «Сколько единиц SKU ABC-123 у нас на складе и какая у него цена продажи?»
• «Покажи все заказы клиента Billbee 4567 с датой и суммой, сначала самые новые.»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini