Коротко (TL;DR)
- Що це. Зв’язка Claude Code Binance працює через офіційний MCP-сервер біржі. Агент читає ринок, бачить баланс і може торгувати всередині окремого субрахунку.
- Чого немає. Права на виведення на зовнішню адресу сервер не має. API-ключ не потрібен: ви входите через акаунт Binance.
- Головна пастка. З версії 2.1.283 термінал Claude Code за замовчуванням стартує в режимі auto. Щоб перед кожним викликом питали саме вас, потрібне власне правило
ask. - Порядок. Спершу лише читання. Потім один ордер на мінімальну суму з вашим «так». Плече (у скільки разів біржа збільшує угоду) у перших сесіях не потрібне.
- Головний ризик. Субрахунок обмежує доступ, а не збиток. Модель помиляється, а за її угоди відповідаєте ви.
- Сама біржа. Binance зламали 29 жовтня 2026 року, на 7 листопада виведення відкрите не для всіх монет. Статус розібрано наприкінці статті: враховуйте його, коли вирішуєте, скільки класти на субрахунок.
Binance MCP у Claude Code: що агент зможе, а що ні
MCP (Model Context Protocol) — відкритий стандарт, через який ШІ-агент підключається до зовнішніх сервісів і діє в них. Біржа має власний офіційний сервер: він вийшов 20 серпня 2026 року разом із Binance Agent OS, а правила описані в документації Binance MCP Server. Agent OS — ширший набір для розробників. Тут розбираємо лише підключення сервера до Claude Code.
- Коротко (TL;DR)
- Binance MCP у Claude Code: що агент зможе, а що ні
- Субрахунок Agentic: як відкрити і скільки на нього покласти
- Підключення Binance MCP до Claude Code: команда і вхід
- Замок на боці Claude Code: запит перед кожним викликом
- Перша сесія: спершу читання ціни, потім один ордер від 5 USDT
- Плече: скільки днів на рік 10× і 20× спалювали б маржу
- Ризики субрахунку Agentic: помилки моделі, ін’єкції і сам Binance
- Вимкнення: Emergency stop, Disconnect agents і claude mcp remove
- Binance після зламу 29 жовтня: що з виведенням на 7 листопада
- FAQ
Рахунок до сервера ми не підключали: акаунта Binance у цій роботі не було. Вхід, субрахунок і ордери описані за документацією. Сторінка Binance датована 30 жовтня 2026 року, документацію Claude Code ми відкрили 7 листопада 2026 року. Самі ми запустили лише те, що не потребує рахунку: claude mcp add у порожньому профілі без входу, запит до адреси сервера без токена, публічний API біржі та власний розрахунок.
Під час підключення ви обираєте права. Їх усього чотири, а п’ятого, на виведення, не існує:Право Що дає агенту Межа Market data Ціни, стакани (списки заявок), свічки (ціни за період), ставки фінансування (плата за утримання ф’ючерса) Баланс не чіпає Account Баланс, позиції та виписки субрахунку Головний рахунок — лише перегляд і лише за вашим вибором Trade Spot (купівля без плеча), Margin (торгівля в борг), Convert (обмін), ф’ючерси USDⓈ-M і COIN-M (контракти на ціну) Лише те, що ви видали і що дозволено вашому акаунту Transfer Перекази між гаманцями всередині субрахунку З головного рахунку гроші не забирає Виведення Такого права немає На зовнішню адресу агент гроші не надішле
Binance радить починати з мінімуму. Змінити набір пізніше можна лише так: відключити агента й підключити знову.
На кадрі верх сторінки Binance, знято 7 листопада 2026 року. Рамки стоять на двох обіцянках біржі: права на виведення немає, а кожну угоду й переказ підтверджуєте ви.
Офіційного кроку «створити API-ключ із мінімальними правами» немає. Ви підтверджуєте доступ на сайті біржі, і API-ключа на комп’ютері немає. Замість нього Claude Code зберігає токен входу (тимчасову перепустку до біржі). Відповідь сервера вказує на стандарт входу OAuth, хоча сторінка Binance цього слова не називає. Якщо гайд про Claude MCP Binance просить вставити API-ключ, ідеться про сторонній сервер.
Порядок налаштування: від читання до першого ордера
- Акаунт Binance і браузер на комп’ютері.
- Правило
askу налаштуваннях Claude Code, ще до входу. - Команда підключення і вхід із правами Market data та Account.
- Поповнення субрахунку і кілька запитів лише на читання.
- Нове підключення з правом Trade і один ордер від 5 USDT.
Субрахунок Agentic: як відкрити і скільки на нього покласти
Субрахунок Agentic — окремий рахунок усередині вашого акаунта, у якому торгує агент. Для початку потрібен сам акаунт на Binance і браузер на комп’ютері: за документацією функцію зроблено для десктопа, а не для телефона. Списку регіонів на сторінці сервера немає, в анонсі сказано лише «regional availability».
Створювати субрахунок заздалегідь не треба. Він з’явиться під час першого входу, тож поповнювати його ви будете вже після команди з наступного розділу:
- Створення. Під час першого входу через MCP система сама запропонує його відкрити. У списку субрахунків він позначений як Agentic virtual sub.
- Поповнення. Субрахунок стартує порожнім. Гроші переказуєте лише ви, на сайті біржі: Profile → Dashboard → Sub-account → Asset Management → Transfer. За документацією переказ миттєвий і без комісії.
- Сума. Binance радить класти лише те, що ви готові віддати агенту під торгівлю. Для першої перевірки вистачить суми трохи вище за мінімум.
Для пари BNBUSDT мінімальний ринковий ордер — 5 USDT (публічний API біржі, запит 7 листопада 2026 року). В інших пар поріг свій. Першого разу 10 USDT покривають ордер і комісію.
Якщо головний рахунок порожній, урахуйте: з 28 вересня 2026 року Binance закрила поповнення гривнею через Fiat Trade UAH. Звичайний шлях тепер — P2P (купівля в інших користувачів).
Підключення Binance MCP до Claude Code: команда і вхід
Підключення займає одну команду. Ось вона, дослівно з документації Binance на 30 жовтня 2026 року:
claude mcp add binance-mcp-server --transport http https://agent.binance.com/mcp/agentic

На кадрі вкладка Claude Code тієї самої сторінки: рамки стоять на команді та на кроці з меню /mcp. Далі кроки такі:
- Відкрийте термінал у теці, де працюватимете з агентом, і виконайте команду.
- Запустіть
claude, відкрийте меню/mcpі виберітьbinance-mcp-server. - Натисніть Authenticate і увійдіть на сайті Binance. Першого разу видайте лише Market data та Account.
- У звичайному терміналі виконайте
claude mcp list. За документацією поруч із сервером буде статус✔ Connectedабо! Needs authentication. - Перевірте запитом із документації: «Use the Binance MCP Server to show the current BTCUSDT price and 24-hour change.»
Екрана входу ми не бачили, тому не описуємо, який вигляд там має вибір прав. Загальний розбір команд і областей видимості є у статті MCP у Claude Code.
Ось що ми перевірили самі 7 листопада 2026 року на Claude Code 2.1.316. claude mcp add --help підтверджує прапорець --transport http і область local за замовчуванням. Отже, сервер буде видно лише в проєкті, де ви його додали, і це зручно: Binance не з’явиться в інших ваших теках.
POST-запит на підключення до адреси сервера без токена повернув таку відповідь (звичайний GET дає 404):
HTTP/2 401
www-authenticate: Bearer resource_metadata="https://agent.binance.com/.well-known/oauth-protected-resource/gateway-mcp"
Сервер відмовив і показав, де взяти токен. Це збігається з описаним входом без ключів. claude mcp get одразу після додавання теж показав ! Needs authentication. Розраховуйте, що в Claude Code вхід знадобиться вже для читання ціни, хоча саме право Market data документація називає публічним.
Binance окремо застерігає від двох помилок. Не вставляйте адресу сервера в чат із проханням «встанови». Не відкривайте її в браузері. Команду запускаєте ви самі, а адресу звіряєте посимвольно.
Замок на боці Claude Code: запит перед кожним викликом
Binance описує підтвердження так: агент переказує ордер (символ, сторона, тип, сума) і чекає вашого «так». Де це виконується, на сервері чи в поведінці моделі, документація не каже. Тому потрібен другий замок, який тримає сама програма на вашому комп’ютері.
Тут і є пастка. З версії 2.1.283 документація Claude Code називає auto стартовим режимом термінала й VS Code. У цьому режимі дії замість вас перевіряє друга модель, класифікатор. Журнал змін уточнює, що на всі тарифи й провайдери це поширилося у 2.1.284. Якщо в налаштуваннях заданий інший режим, сесія стартує в ньому. Якщо auto вам недоступний, наприклад через модель, буде Manual.
Правило ask змушує питати вас. Додайте його в ~/.claude/settings.json (файл налаштувань для всіх ваших проєктів). Якщо файл уже є, допишіть блок до наявного:
{
"permissions": {
"ask": ["mcp__binance-mcp-server__*"]
}
}
Зірочка означає всі інструменти сервера. Ім’я між подвійними підкресленнями — те, що ви вказали в claude mcp add. Команда /permissions покаже правило і файл, з якого його взято.
Прохання в промпті такого не дає. Як сказано в документації Claude Code про дозволи, правила виконує сама програма, а не модель. Текст промпта або CLAUDE.md впливає лише на те, що модель спробує зробити.
На кадрі документація Claude Code на 7 листопада 2026 року: рамка стоїть на пункті про явне правило ask у списку того, що не схвалюється автоматично в жодному режимі. На сервері Binance ми цього не перевіряли, висновок зроблено за документацією.
Ось що це означає в основних режимах:Режим Що йде без запиту Виклик Binance за правила askdefault (Manual)Лише читання файлів Спитає вас acceptEditsЧитання й редагування файлів, прості команди Спитає вас autoУсе, з фоновими перевірками Спитає вас bypassPermissionsУсе Спитає вас dontAskЗаздалегідь схвалене Відмовить без запиту
Правило має ціну: запит буде й на кожне читання ціни. Правило allow цього не скасує, бо порядок перевірки такий: deny, потім ask, потім allow. Прибрати запит на читання можна, лише замінивши зірочку іменами інструментів запису. Імена видно в /mcp після входу, ми їх не бачили й не наводимо. Мінус такої заміни: новий інструмент Binance під правило не потрапить. На старті залиште зірочку.
Правило стосується лише цього сервера. Щоб у сесії питали і про файли та команди, запускайте claude --permission-mode manual. Усі режими розібрано у статті про режими доступу Claude Code.
Журнал викликів: хук PreToolUse для Binance MCP
Хук — команда, яку Claude Code сам запускає на подію. PreToolUse спрацьовує до виклику інструмента. Такий хук записує кожну спробу у файл, навіть якщо ви потім відповісте «ні». У файлі будуть спроби, а не виконані угоди: вашої відповіді журнал не показує. У ~/.claude/settings.json він додається поруч із permissions, потрібна утиліта jq:
{
"hooks": {
"PreToolUse": [
{
"matcher": "mcp__binance-mcp-server__.*",
"hooks": [
{
"type": "command",
"command": "jq -c '{time: now | todate, tool: .tool_name, input: .tool_input}' >> ~/claude-binance-audit.log"
}
]
}
]
}
}
Конфіг зібрано нами за прикладами документації. Рядок jq ми перевірили 7 листопада 2026 року на тестовому JSON, на справжніх викликах Binance — ні. Сторінка про дозволи описує і жорстку заборону: хук із кодом виходу 2 зупиняє виклик ще до перевірки правил.
Перша сесія: спершу читання ціни, потім один ордер від 5 USDT
Сценарій нижче взято з документації Binance, суму зменшено нами. Ми його не проходили, тому формату запитів на екрані не показуємо.
- Ціна. Спитайте: «What’s BTCUSDT trading at, and how’s it moved over 24h?» Відповідь звірте з біржею. Наш запит до публічного API дав 76 053,5 USDT і −0,176% за 24 години (7 листопада 2026 року, близько 10:00 UTC). Запит працює без ключа:
curl -s "https://api.binance.com/api/v3/ticker/24hr?symbol=BTCUSDT". - Баланс. Спитайте: «What do I have in my Agentic account?» Сума має збігатися з тим, що ви переказали.
- Право Trade. Відключіть агента, підключіть знову й видайте Trade. Документація каже, що агент отримує лише видане, тож якщо на екрані входу можна вибрати ринки, залиште один спот (купівля без плеча).
- Ордер. У документації приклад «Buy $100 of BNB at market on spot.» Замініть суму на $6. BNB тут лише приклад Binance, а не порада щось купувати.
- Перевірка перед «так». Звірте символ, сторону, тип і суму. Щось не збіглося — відповідайте «ні». Це той самий крок, який витрачає справжні гроші.
- Результат. Спитайте: «Did that fill? What’s my BNB balance now?» Потім відкрийте субрахунок на сайті й звірте очима.
Такий вигляд має Claude Binance trading на старті: один запит, одне запитання, одне «так». Нудно, і так задумано. Ціна може піти проти вас, і частину цих грошей ви втратите. Демо-рахунок на сторінці сервера не згаданий, тому перша угода тут справжня.
Плече: скільки днів на рік 10× і 20× спалювали б маржу
Плече показує, у скільки разів біржа збільшує вашу угоду. Маржа — це застава під неї. Ліквідація — біржа сама закриває угоду, коли застава закінчилася. Докладніше про механіку у статті про кредитне плече на Binance.
Ми порахували це на цифрах. Узяли 364 закриті денні свічки BTCUSDT із публічного API Binance, з 8 листопада 2025 по 6 листопада 2026 року. Вхід — за ціною відкриття дня. Маржа згоряє, якщо за день ціна йде проти позиції на 100/плече відсотків. Лонг тут означає ставку на зростання, шорт — на падіння.Плече Рух, що з’їдає маржу Лонг: днів із 364 Шорт: днів із 364 5× 20% 0 0 10× 10% 2 (0,5%) 1 (0,3%) 20× 5% 15 (4,1%) 17 (4,7%)
Найсильніше падіння від відкриття дня за цей період — 14,79%, найсильніше зростання — 14,05%. Типове (медіанне) падіння — 1,23%. Ми перевірили розрахунок на свічках Coinbase BTC-USD за спільні 299 днів: максимум 14,82% проти 14,79%, лічильники днів збіглися повністю.
Розрахунок спрощений. Підтримувальна маржа (мінімум застави, якого вимагає біржа) і комісії в ньому не враховані, тому справжня ліквідація настає раніше. Це спотові свічки, а не ф’ючерсний контракт, і вікно всього один день: позиція, яку тримають довше, має більше шансів згоріти. Нуль у 5× не означає, що таке плече нешкідливе.
Сума на субрахунку не обмежує розмір позиції, вона обмежує заставу. Окремого ліміту збитку Binance не запроваджує: за висновками AI Stack Current і Mezha, межу задає лише те, що ви переказали. У документації про такий ліміт нічого немає. Тому перші сесії краще проводити без плеча.
Ризики субрахунку Agentic: помилки моделі, ін’єкції і сам Binance
Claude Code залишається інструментом. Він виконує запит, але за результат не відповідає. Ось чого схема не закриває:
- Помилки моделі. Binance прямо пише, що ШІ може помилятися, спиратися на застарілі або вигадані дані й надсилати неправильні параметри. Збитків від рішень агента біржа на себе не бере, нагляд і перевірка лежать на вас.
- Звичка натискати «так». Правило
askпитає, але читати запитання за вас не буде. Після десятка однакових запитань око замилюється. Закінчили торгувати — заберіть право Trade новим підключенням. - Ін’єкції. Це прихована команда в тексті, який читає агент. Документація Claude Code застерігає: сервери, що отримують зовнішній контент, відкривають такий ризик. У сесії з правом Trade не тримайте браузер, пошту й інші сервери. Приклади розібрано у статті про атаки через MCP.
- Сторонні сервери. У реєстрах пакетів повно «Binance MCP», яким потрібен ваш API-ключ. Це інший шлях: чужий код отримує ключ на вашому комп’ютері. Офіційний маршрут такого не вимагає.
- Сам Binance і ваш комп’ютер. 29 жовтня 2026 року Binance зламали, статус виведення розібрано нижче. За переказом звіту біржі в SecurityWeek, кампанія почалася в червні з підробленого інсталятора Homebrew: інженер завантажив його, коли шукав у пошуковику ШІ-інструмент для коду. Служба безпеки це виявила й замінила пристрій. У вересні інший інженер запустив «тестове завдання» з фальшивої співбесіди. З його машини й за допомогою внутрішнього ШІ-інструмента зловмисники захопили ще два комп’ютери. Зв’язку з публічним MCP-сервером у відкритих джерелах ми не знайшли. Висновок загальний: ставте агента лише з офіційних сторінок, а комп’ютер з агентом і токеном входу вважайте ціллю.
Водночас сильні сторони схема має. Права на виведення немає, субрахунок поповнює лише людина, API-ключ не потрібен, а правила дозволів виконує не модель. Токен входу при цьому лежить на вашому комп’ютері, тому розділ про вимкнення не пропускайте. Сусідні питання ми розбираємо окремо: права Agent OS загалом, Codex CLI та автоматичний торговий аналіз через API.
Заявлено й перевірено: де закінчується документація
| Заява | Хто каже | Що перевірили ми |
|---|---|---|
| Вхід без API-ключів | Binance, 30.10 | POST без токена отримує 401 (07.11). Сам вхід не проходили |
| Підтвердження кожного запису | Binance, 30.10 | Не перевіряли, потрібен рахунок. Mezha 20.08 описувала це як вибір користувача |
| Виведення немає | Binance, 30.10; анонс 20.08 | Не перевіряли, потрібен рахунок |
Правило ask не схвалюється автоматично | Anthropic, на 07.11 | На сервері Binance не перевіряли. Винятків для MCP у журналі змін не знайшли |
| Режим auto стартовий | Anthropic, на 07.11 | Звірили документацію з журналом змін. Режим на цьому сервері не запускали |
| Мінімум BNBUSDT 5 USDT | Публічний API | Перевірили запитом 07.11 |
Вимкнення: Emergency stop, Disconnect agents і claude mcp remove
Відключати доступ доведеться на двох боках. Видалити сервер із Claude Code недостатньо. Рівні такі, від термінового до звичайного:
- Emergency stop. На сайті біржі: Profile → Dashboard → Sub-account → Account Management. За документацією кнопка одним кроком відключає всіх агентів і скасовує позиції та ордери спота, маржі й ф’ючерсів у цьому субрахунку. Натискайте першою, якщо щось пішло не так.
- Disconnect agents. Там само. Відключає вибраних агентів, це і є офіційний спосіб відкликати доступ.
- Claude Code. У терміналі дві команди, порядок важливий:
claude mcp logout binance-mcp-server
claude mcp remove binance-mcp-server
Порядок пояснює документація Claude Code про MCP. Команда remove стирає токени лише у вас на комп’ютері й не відкликає їх на сервері. Відкликання робить logout, і лише там, де сервер входу це підтримує. Чи підтримує це Binance, документація не каже. Тому Disconnect agents на сайті біржі обов’язковий у будь-якому разі.
Гроші після відключення залишаються на субрахунку. Повернути їх можна через Asset Management. Для швидкої паузи без відкликання доступу підійде правило deny з тим самим іменем: воно блокує виклик у будь-якому режимі.
Binance після зламу 29 жовтня: що з виведенням на 7 листопада
Гроші на субрахунку лежать на тій самій біржі, тому її стан важливий для рішення, скільки туди класти. Окремо ми розібрали, як зламали Binance. Тут лише статус на 7 листопада 2026 року:
- Збитки. Binance оцінювала їх приблизно в $6,3 млрд, у першому звіті від 3 листопада, за SecurityWeek, названо $6,34 млрд. ФБР приписує атаку групі TraderTraitor із КНДР, Північна Корея це заперечує.
- Виведення. Воно відкривається поетапно з 1 листопада. Найсвіжіше у стрічці оголошень на 7 листопада — Recovery Update №9 від 6 листопада: з 04:00 UTC ще 58 пар мережа-токен на 9 мережах, і не всі одразу.
- Що ще закрито. 6 листопада Binance написала, що намагається відкрити виведення HYPE, INJ, APT, PLASMA, NEAR і LTC «до кінця наступного тижня» (The Block). The Coin Republic вважає це 13 листопада, точного дня біржа не називала. Це ціль, а не факт.
- Депозити. За тим самим оновленням №9 вони відкриті.
- Покриття. Binance заявляла, що на 4 листопада відновила близько 98% зачеплених активів. Це заява самої біржі.
Першим у цій статті застаріє саме цей розділ: статус змінюється майже щодня. Перед виведенням дивіться сторінку статусу мереж і оголошення Binance. Одразу за ним можуть застаріти команди й налаштування, тому в разі розбіжності вірте свіжій документації.
FAQ
Чи потрібен API-ключ Binance для підключення MCP до Claude Code?
Ні, в офіційному маршруті ключ не потрібен. На 30 жовтня 2026 року документація Binance описує вхід через акаунт на сайті біржі. Вона прямо каже, що ключів на пристрої немає. Якщо інструкція просить створити й вставити API-ключ, вона описує сторонній сервер, а не офіційний.
Чи може Claude Code вивести гроші з Binance через MCP?
За документацією Binance ні: права на виведення на зовнішню адресу сервер не має. Агент може рухати гроші лише між гаманцями всередині субрахунку. Втратити їх при цьому можна звичайною угодою, тож заборона виведення захищає від крадіжки агентом, але не від збитку. На власному рахунку ми цього не перевіряли.
Чи спитає Claude Code підтвердження перед ордером за замовчуванням?
Не обов’язково. З версії 2.1.283 термінал за замовчуванням стартує в режимі auto, де дії перевіряє друга модель. Binance описує своє підтвердження, але не каже, де воно виконується. Щоб запитання ставила сама програма, додайте правило ask на mcp__binance-mcp-server__*. Його не скасовує жоден режим. Лише в dontAsk виклик просто відхиляється.
Що буде, якщо на субрахунку Agentic закінчаться гроші?
Нова угода не пройде: за документацією Binance вона завершиться помилкою браку балансу. Сам агент поповнити субрахунок не може, бо переказ із головного рахунку робите лише ви на сайті біржі. Тому сума на субрахунку обмежує заставу, з якою працює агент, і це ваш основний ручний запобіжник.
Чи бачить агент мій основний рахунок Binance?
Лише якщо ви це дозволили. Право Account охоплює баланс, позиції та виписки субрахунку, а перегляд головного рахунку йде опцією і лише на читання. Рухати гроші з головного рахунку агент не може. Перевірити видані права можна на сайті біржі, у розділі Account Management, пункт View permissions.
Чи працює те саме в Codex CLI і Claude Desktop?
Сервер той самий: документація Binance на 30 жовтня 2026 року називає Claude Code, Claude Desktop, Codex CLI, ChatGPT, VS Code і Grok Bot. Команди підключення й замки в клієнтів різні. Правило ask і хук із цієї статті працюють лише в Claude Code. В інших клієнтах такі налаштування влаштовані по-своєму.
