MCP-сервер БКС: портфель и котировки Мир инвестиций в Claude Code

human-turn/bcs-mcp· Проверено 12.11.2026· 2на GitHub

Подключает агента к брокерскому счёту в БКС Мир инвестиций через BCS Trade API: портфель, лимиты, котировки, стакан, свечи и сделки. По умолчанию только чтение, торговля включается отдельно.

Пакет npm: 15 инструментов чтения, slash-команды для обзора портфеля и ребалансировки, выгрузка в JSON и CSV; заявки только при BCS_ALLOW_TRADING=true и с подтверждением.

Как подключить

Что сделать до подключения

1

Node.js 22 или новее

2

Брокерский счёт в БКС и токен API «Только для чтения»

3
BCS_REFRESH_TOKEN

lk.bcs.ru → «Профиль» → «Управление счетами» → брокерский счёт → «Токены API» → «Выпустить токен», тип «Только для чтения»; показывается один раз, живёт 90 дней

4
BCS_ALLOW_TRADING

необязательно: true включает place_order, edit_order и cancel_order, нужен токен «для торговли и чтения»

5
BCS_OUTPUT_DIR

необязательно: папка для выгрузок в файл, по умолчанию текущая папка сервера

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'BCS_REFRESH_TOKEN=<токен БКС>' --transport stdio bks \
  -- npx -y bcs-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

get_portfolioпоказывает позиции с P&L и долями
get_limitsпоказывает свободные деньги по валютам
get_quotesполучает котировки пачкой
get_order_bookпоказывает стакан глубиной 20
get_recent_tradesпоказывает ленту обезличенных сделок
get_candlesполучает свечи от минуты до месяца
find_instrumentищет бумагу по тикеру или ISIN
get_instruments_by_typeвыводит каталог акций, облигаций, ETF
get_trading_scheduleпоказывает торговые сессии
get_trading_statusпроверяет, открыты ли торги
get_discountsпоказывает маржинальные дисконты
get_ordersвыводит список заявок
get_order_statusпроверяет статус заявки
get_tradesвыводит ваши сделки
get_server_infoпоказывает диагностику сервера
place_orderвыставляет заявку
edit_orderменяет заявку
cancel_orderотменяет заявку

Что попросить агента

«Покажи мой портфель БКС»Агент вызовет get_portfolio
«/bcs:invest_cash 50000 — пришла зарплата, куда докупить?»Команда invest_cash сравнит портфель с целевыми долями из portfolio-target.json и предложит докупки, сделок не совершая
«Подбери облигации на 300 000 ₽ с горизонтом 2 года»Команда bond_picker отберёт облигации из каталога по рейтингу, купону и доходности и соберёт лесенку
«Выгрузи дневные свечи <тикер> за 2025 год в CSV»Агент вызовет get_candles с outputPath и outputFormat csv
«Купи 10 акций <тикер> по рынку»При включённой торговле агент вызовет place_order, сервер спросит подтверждение

Для каких задач

Показать портфель с прибылью, долями и стоимостью в рублях, долларах и евро
Посмотреть котировки, стакан и свечи по бумаге
Подобрать облигации по рейтингу, купону и доходности
Сравнить портфель с целевыми долями и получить план докупок в лотах
Разобрать свои сделки за период: обороты, средние цены, комиссии
Выставить заявку с подтверждением, если торговля включена

Ограничения

!

Проект маленький: 2 звезды на GitHub, последнее обновление в июле 2026 года

!

BCS Trade API не отдаёт историю денежных операций, дивиденды и купоны: XIRR и налоговые отчёты не посчитать

!

Песочницы у БКС нет: с BCS_ALLOW_TRADING=true каждая заявка реальная, количество в заявках задаётся в штуках

!

Один токен привязан к одному счёту и живёт 90 дней; списки заявок и сделок доступны только с 26.01.2026

Частые вопросы

Может ли агент купить бумаги без меня?
В базовой настройке нет: торговые инструменты даже не регистрируются. С BCS_ALLOW_TRADING=true перед каждой заявкой сервер спрашивает «Купить N шт. X?», и без вашего «да» заявка не уходит. Отключает подтверждение BCS_CONFIRM=off.
Как выгрузить свечи за весь период в файл?
Передайте в запросе outputPath и outputFormat json или csv. Сервер скачает период чанками, запишет файл внутри BCS_OUTPUT_DIR и вернёт в диалог краткую сводку.
Что за команды /bcs: в Claude Code?
Это готовые сценарии: portfolio_review, rebalance_check, invest_cash, bond_picker, fire_progress, trades_review и другие. Они анализируют и предлагают, сами сделок не совершают.
Как подключить несколько счетов?
Один токен открывает только один счёт, поэтому для каждого счёта запустите отдельный экземпляр сервера со своим BCS_REFRESH_TOKEN.
Где взять дивиденды и купоны?
BCS Trade API их не отдаёт. Рядом можно подключить публичный moex-mcp на данных MOEX ISS, команды сервера это учитывают.
Как подключить MCP-сервер БКС к Claude Code?
Выполните claude mcp add bcs -e BCS_REFRESH_TOKEN=<токен> -- npx -y bcs-mcp. Тот же JSON подходит для Claude Desktop, Cursor и VS Code, он есть во вкладках блока «Как подключить».
Чей это MCP-сервер БКС?
bcs-mcp ведёт сторонний разработчик human-turn, собран по образцу его же t-invest-mcp для Т-Инвестиций. Работает через BCS Trade API с токеном из личного кабинета.
Работает ли сервер из России?
Нужен брокерский счёт в БКС; сервер запускается на вашем компьютере и обращается к BCS Trade API с вашим токеном.

Похожие серверы