↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. AI-агенти, MCP і API

    Як підключити AI-агента до Elbuz: OpenClaw, Hermes, Grok Bot, Muse, dots, Duet, Kimi Claw, Cue

    7 хв читанняОновлено

      AI-агент працює сам: виконує задачі за розкладом і доводить їх до кінця, а не лише відповідає в чаті. Щоб він працював із каталогом, замовленнями й клієнтами Elbuz, йому дають адресу підключення й ключ співробітника.

      Коли це знадобиться:

      • Агент має щоранку перевіряти замовлення — він сам читає дані за ключем.
      • Не знаєте, чи підключиться ваш агент — таблиця показує спосіб для кожного.
      • Агент не має нічого змінювати без вас — ключ лише читає або чекає вашого «Прийняти».

      З чого почати: знайдіть свого агента в таблиці.

      Що вміє агент в Elbuz

      Де це і хто має доступ

      Адреса MCP
      ваша адреса Elbuz і /api/mcp, наприклад https://123456789.elbuz.com/api/mcp
      Ключ
      Кабінет → Налаштування системи → «Інші налаштування» → «API та токени доступу»
      Заявки агента
      Контакти → Пульс, вкладка «Пропозиції»
      Право доступу
      агент отримує права співробітника ключа
      Підготувати
      окремого співробітника з потрібними правами

      Як підключити вашого агента

      Станом на листопад 2026 року, за довідкою виробників. Продукти швидко змінюються: якщо екран у вас інший, звіряйтеся з довідкою агента.

      АгентЯк підключитиЩо робити далі
      OpenClaw у файлі налаштуваньблок налаштувань
      Hermes (Nous Research)MCP-сервер у файлі налаштуваньблок налаштувань
      Grok BotMCP-сервер за адресоюкроки й обмеження
      Meta MuseMCP не описаний; власний конектор на API v2як попросити Muse
      OpenAI dotsdot використовує підтримувані плагіни, встановлені й увімкнені у вашому акаунті; про власний MCP-сервер довідка не пишеперевірте в довідці OpenAI про dots
      Claude Duetбере підключені застосунки з акаунта Claude; про власні конектори довідка не пишеперевірте наявність конектора Elbuz у Duet після підключення в claude.ai
      Kimi Clawплагіни, через які Kimi підключає MCP, у Kimi Claw не підтримуютьсяякщо потрібен такий агент — OpenClaw на власному комп'ютері
      Cue (Manus)виробник не описує власні сервери для Cueу самому Manus є Settings → Integrations → Custom MCP Servers; для Cue перевірте в довідці Manus
      Gemini CLI, AntigravityMCP-сервер командою чи у файлі налаштуванькоманда, блок налаштувань
      Claude, ChatGPT, Codex, CursorMCP-сервер за адресою й ключем чи конекторомпідключити AI-асистента

      Агент уміє сам виконувати команди й читати сторінки? Дайте йому фразу: він прочитає інструкцію й допоможе підключитися.

      Що написати агентуЩо він зробить
      «Прочитай інструкцію: https://elbuz.com/guide-connect-ai-assistant-mcp#dlia-asystenta — допоможи мені підключити Elbuz через MCP і працюй з ним за цими правилами.»спитає адресу вашого Elbuz і підкаже кроки або підключиться сам

      Що підготувати перед підключенням

      Автономний агент працює, коли вас немає поруч. Тому видайте йому окремий обмежений доступ, а не свій.

      1. Заведіть окремого співробітника для агента й дайте його відділу лише потрібні права.
      2. Створіть від його імені : кроки.
      3. Для початку залиште «Тільки для читання». Коли агент має щось виправляти, зніміть позначку й поставте в «Зміни даних» режим «Питати»: кожна зміна чекатиме вашого «Прийняти» в «Пульсі».
      4. Поле «IP-адреси для доступу» залиште порожнім, якщо агент працює у хмарі: він ходить зі своїх серверів, і список адрес його заблокує.
      5. Ключ вписуйте в налаштування агента самі, а не в чат: чат зберігається в історії агента.
      6. Вхід без ключа через сторінку «Дозволити» виконуйте під співробітником агента: ключ створюється від імені того, хто ввійшов у браузері, і без позначки «Тільки для читання».
      Картка ключа API v2: зміни даних, IP-адреси для доступу, тільки для читання
      1Зміни даних
      2IP-адреси для доступу
      3Тільки для читання
      1. Зміни даних — режим «Питати» чекає вашого «Прийняти» в «Пульсі».
      2. IP-адреси для доступу — для хмарного агента залиште порожнім.
      3. Тільки для читання — для початку залиште її.

      Як підключити агента файлом налаштувань

      У прикладах <ваш-домен> — адреса вашого Elbuz, наприклад 123456789.elbuz.com. Ключ передає Authorization.

      Ключ створюється від імені того, хто ввійшов у браузері, без позначки «Тільки для читання», а співробітнику з «Управління» на екрані згоди доступний режим «Робити самому». Входьте під співробітником агента й обирайте «Питати».

      OpenClaw

      OpenClaw — відкритий агент, який працює на вашому комп'ютері чи сервері. Додайте в ~/.openclaw/openclaw.json:

      {
        mcp: {
          servers: {
            elbuz: {
              url: "https://<ваш-домен>/api/mcp",
              transport: "streamable-http",
              headers: {
                Authorization: "Bearer ${ELBUZ_API_KEY}",
              },
            },
          },
        },
      }

      Ключ покладіть у змінну середовища ELBUZ_API_KEY (налаштування системи, звідки програма бере значення: так ключ не лежить у файлі). Вхід без ключа: замість headers вкажіть auth: "oauth" і виконайте openclaw mcp login elbuz. У браузері OpenClaw виконує JavaScript за замовчуванням (browser.evaluateEnabled), тому може користуватися й elbuz_tools. Довідка: налаштування MCP в OpenClaw.

      Hermes

      Hermes Agent від Nous Research працює на вашому комп'ютері чи сервері. Додайте в ~/.hermes/config.yaml:

      mcp_servers:
        elbuz:
          url: "https://<ваш-домен>/api/mcp"
          headers:
            Authorization: "Bearer ${ELBUZ_API_KEY}"

      Ключ запишіть у ~/.hermes/.env рядком ELBUZ_API_KEY=elbz_xxxxxxxx_… і виконайте в сесії /reload-mcp. Вхід без ключа: замість headers вкажіть auth: oauth і виконайте hermes mcp login elbuz. Інструменти з'являться під назвами mcp_elbuz_*. Довідка: MCP у Hermes.

      Користуватися elbuz_tools Hermes може лише за умов із довідки: browser_exec доступний сесії з набором інструментів terminal, а browser_cdp — коли налаштовано підключення до браузера через CDP.

      Gemini CLI

      gemini mcp add --transport http --header "Authorization: Bearer elbz_xxxxxxxx_…" elbuz https://<ваш-домен>/api/mcp

      За замовчуванням сервер додається для поточного проєкту. Для безплатного тарифу й Google One Gemini CLI замінено на Antigravity CLI (довідка).

      Antigravity

      Додайте в ~/.gemini/config/mcp_config.json:

      {
        "mcpServers": {
          "elbuz": {
            "serverUrl": "https://<ваш-домен>/api/mcp",
            "headers": {
              "Authorization": "Bearer elbz_xxxxxxxx_…"
            }
          }
        }
      }

      Без headers Antigravity пропонує вхід сам, якщо сервер це підтримує (довідка).

      Як підключити Grok Bot

      Бот сам додає MCP-сервер за адресою. Напишіть йому:

      Що написати агентуЩо він зробить
      «Додай MCP-сервер Elbuz за моєю адресою /api/mcp. Ключ доступу я введу сам у захищеній формі, у чат його не проси.»додасть сервер і спитає адресу; якщо ввести ключ у формі не вдається, скаже про це

      Офіційна довідка не описує, як передати боту заголовок із ключем, і забороняє вставляти паролі в чат. Спосіб входу уточніть у довідці Grok Bot. У Grok.com інший шлях: grok.com/connectors → New Connector → Custom, сервер має бути доступний з інтернету (довідка).

      Як підключити Muse

      Meta не описує підключення MCP-серверів у Muse, а браузерний Muse не виконує JavaScript на сторінці, тому elbuz_tools тут не підходить. Залишається власний конектор: Muse будує його сам, якщо в сервісу є API.

      Що написати агентуЩо він зробить
      «Створи власний конектор до API v2 Elbuz за документацією https://elbuz.com/guide-api-v2. Ключ я передам через сховище облікових даних, у чат його не проси.»проведе вас кроками створення конектора

      Власні конектори Meta не перевіряє. Керувати готовими конекторами можна в Settings → Connectors (довідка Meta). Опис API — у статті API v2: ключі, права, формат.

      Як запускати агента за розкладом чи подією

      За розкладом — найпростіше. агента сама запитує зміни, наприклад раз на годину: search із фільтром updated_since. Відбір і приклад — у статті про API v2.

      За подією — через проміжний обробник. Вебхук Elbuz надсилає власний формат із підписом, без заголовка Authorization. Напряму він не запускає:

      • OpenClaw — POST /hooks/agent, коли ввімкнено hooks.enabled; потрібні заголовок Authorization: Bearer і поле message у тілі;
      • рутини Grok Bot — потрібен заголовок Authorization: Bearer;
      • автоматизації Grok — підпис того самого формату Standard Webhooks, але секрет видає Grok, а Elbuz підписує своїм.

      Потрібна невелика ваша програма, яка перевірить підпис Elbuz і викличе агента.

      Сценарії

      Щоранковий звіт про замовлення

      OpenClaw із ключем, створеним у вікні, з позначкою «Тільки для читання»: вхід без ключа такої позначки не дає. Рутина щоранку рахує нові замовлення за допомогою query і надсилає вам підсумок. Змінити він нічого не може.

      Агент дописує описи товарів

      Hermes із ключем у режимі «Питати». Агент готує описи, кожна правка приходить у «Пульс», а ви приймаєте всі разом.

      Хмарний агент не підключається

      Хмарний агент отримує відмову через ваш ключ, бо в ньому заповнено «IP-адреси для доступу». Очистіть поле й обмежте агента правами співробітника.

      Що робити, коли агент не підключається

      Розбір частих проблем
      Що ви бачитеЧому такЩо зробити
      «IP … is not allowed for this key»агент ходить з адреси поза списком ключаочистіть поле (підготовка)
      «Authorization: Bearer <Elbuz API v2 key> is required»ключ не передано або він недійснийперевірте заголовок (приклад)
      «read-only key»у ключа стоїть «Тільки для читання»зніміть позначку (підготовка)
      Агент «зробив», а дані не змінилисязміна чекає в «Пульсі»прийміть її (перевірка змін)
      «rate limit exceeded»понад 120 запитів на хвилину на ключзменште частоту рутини (розклад)

      Часті запитання

      Який спосіб підключення агента обрати?

      Там, де агент підтримує MCP, — MCP-сервер Elbuz: він дає дані й дії без браузера. Якщо MCP немає, а API агент викликати може, — API v2 за ключем.

      Чи можна дати агенту ключ у чаті?

      Не варто: чат зберігається в історії агента. Вписуйте ключ у налаштування агента самі.

      Чи зможе агент змінити дані без мене?

      Ключ, створений у вікні, спершу має позначку «Тільки для читання», а в режимі «Питати» кожна зміна чекає вашого «Прийняти» в «Пульсі». Вхід без ключа через сторінку «Дозволити» створює ключ без цієї позначки, тому входьте під співробітником агента й обирайте «Питати».

      Чи може Elbuz сам запустити агента?

      Не напряму: вебхук Elbuz не передає заголовок Authorization і має власний формат тіла. Потрібен ваш проміжний обробник. Простіший шлях — рутина агента за розкладом, яка сама запитує зміни.

      Хто платить за роботу агента?

      Роботу агента ви оплачуєте його виробнику за вашою підпискою, якщо він платний. За дії агента через ключ Elbuz нічого не бере.

      Що робити, коли агента немає в таблиці?

      Пошукайте в довідці агента, чи підтримує він віддалений MCP-сервер за адресою з ключем. Якщо так, він підключається так само, як OpenClaw чи Hermes.

      Суміжні теми

      Чи була стаття корисною?

      Зміст статті

      Спробувати безкоштовно