
MCP-сервер БКС: портфель и котировки Мир инвестиций в Claude Code
Подключает агента к брокерскому счёту в БКС Мир инвестиций через BCS Trade API: портфель, лимиты, котировки, стакан, свечи и сделки. По умолчанию только чтение, торговля включается отдельно.
Пакет npm: 15 инструментов чтения, slash-команды для обзора портфеля и ребалансировки, выгрузка в JSON и CSV; заявки только при BCS_ALLOW_TRADING=true и с подтверждением.
Как подключить
Что сделать до подключения
Node.js 22 или новее
Брокерский счёт в БКС и токен API «Только для чтения»
BCS_REFRESH_TOKENlk.bcs.ru → «Профиль» → «Управление счетами» → брокерский счёт → «Токены API» → «Выпустить токен», тип «Только для чтения»; показывается один раз, живёт 90 дней
BCS_ALLOW_TRADINGнеобязательно: true включает place_order, edit_order и cancel_order, нужен токен «для торговли и чтения»
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.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.bks]
command = "npx"
args = ["-y", "bcs-mcp"]
[mcp_servers.bks.env]
BCS_REFRESH_TOKEN = "<токен БКС>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"bks": {
"command": "npx",
"args": ["-y", "bcs-mcp"],
"env": {
"BCS_REFRESH_TOKEN": "<токен БКС>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"bks": {
"type": "stdio",
"command": "npx",
"args": ["-y", "bcs-mcp"],
"env": {
"BCS_REFRESH_TOKEN": "<токен БКС>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"bks": {
"command": "npx",
"args": ["-y", "bcs-mcp"],
"env": {
"BCS_REFRESH_TOKEN": "<токен БКС>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"bks": {
"command": "npx",
"args": ["-y", "bcs-mcp"],
"env": {
"BCS_REFRESH_TOKEN": "<токен БКС>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"bks": {
"type": "local",
"command": ["npx", "-y", "bcs-mcp"],
"environment": {
"BCS_REFRESH_TOKEN": "<токен БКС>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"bks": {
"command": "npx",
"args": ["-y", "bcs-mcp"],
"env": {
"BCS_REFRESH_TOKEN": "<токен БКС>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"bks": {
"command": "npx",
"args": ["-y", "bcs-mcp"],
"env": {
"BCS_REFRESH_TOKEN": "<токен БКС>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
get_portfolioпоказывает позиции с P&L и долямиget_limitsпоказывает свободные деньги по валютамget_quotesполучает котировки пачкойget_order_bookпоказывает стакан глубиной 20get_recent_tradesпоказывает ленту обезличенных сделокget_candlesполучает свечи от минуты до месяцаfind_instrumentищет бумагу по тикеру или ISINget_instruments_by_typeвыводит каталог акций, облигаций, ETFget_trading_scheduleпоказывает торговые сессииget_trading_statusпроверяет, открыты ли торгиget_discountsпоказывает маржинальные дисконтыget_ordersвыводит список заявокget_order_statusпроверяет статус заявкиget_tradesвыводит ваши сделкиget_server_infoпоказывает диагностику сервераplace_orderвыставляет заявкуedit_orderменяет заявкуcancel_orderотменяет заявкуЧто попросить агента
Для каких задач
Ограничения
Проект маленький: 2 звезды на GitHub, последнее обновление в июле 2026 года
BCS Trade API не отдаёт историю денежных операций, дивиденды и купоны: XIRR и налоговые отчёты не посчитать
Песочницы у БКС нет: с BCS_ALLOW_TRADING=true каждая заявка реальная, количество в заявках задаётся в штуках
Один токен привязан к одному счёту и живёт 90 дней; списки заявок и сделок доступны только с 26.01.2026