Подключить Billbee MCP к Gemini CLI

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

Billbee + Gemini

Дайте ИИ работать с управлением заказами в Billbee: находить заказы со всех ваших маркетплейсов и магазинов, искать товары по SKU или EAN с ценой и остатком, смотреть историю заказов клиента и обрабатывать заказы: менять статус, добавлять трек-номера, оформлять этикетки через подключённые в Billbee службы доставки, обновлять остатки, ставить теги, менять поля заказов и товаров и создавать счета. С 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 на странице коннектора.

Чтение и запись: 9 из 17 инструментов только читают заказы, товары, клиентов, службы доставки и склады. Остальные 8 меняют ваш рабочий аккаунт Billbee, и Billbee передаёт большинство изменений в подключённые магазины и маркетплейсы. После установки включены все 17. Для режима только для чтения отключите инструменты записи на странице коннектора; отдельные инструменты чтения тоже можно отключить, например billbee_list_customers и billbee_get_customer_orders, если ИИ не должен видеть данные клиентов.

Инструменты записи:

• billbee_set_order_state задаёт статус заказа, например 3 оплачен, 4 отправлен, 8 отменён или 13 упакован. Магазин или маркетплейс может отправить покупателю письмо.
• billbee_add_shipment_to_order сохраняет трек-номер, созданный в другом месте; он не создаёт этикетку и не меняет статус. billbee_ship_order_with_label оформляет настоящую платную этикетку у службы доставки, подключённой в Billbee (DHL, DPD, GLS, Deutsche Post и другие), по вашему собственному договору; providerId и productId берутся из billbee_list_shipping_providers, и ИИ спрашивает вас перед оформлением.
• billbee_update_stock задаёт абсолютный остаток товара по SKU, а не изменение; при нескольких складах нужен stockId из billbee_list_stocks. Billbee передаёт новый остаток в ваши магазины и маркетплейсы.
• billbee_add_order_tags добавляет теги к заказу. billbee_update_order и billbee_update_product меняют только переданные поля, с теми именами полей, которые возвращают billbee_get_order и billbee_get_product, например SellerComment или Price.
• billbee_create_invoice создаёт счёт к заказу по вашему шаблону счёта, не чаще одного раза в 5 минут на заказ, и может вернуть PDF.

Инструментам записи нужен внутренний ID заказа в Billbee, а не номер заказа магазина: billbee_get_order_by_extref находит ID по номеру заказа маркетплейса.

Заказы: 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 — Добавьте коннектор в Gemini

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

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Billbee.

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

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

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

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

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