Большие языковые модели уже научились анализировать данные, писать код и управлять инфраструктурой. До брокерского счёта оставался один шаг — и Т-Инвестиции его сделали. MCP-сервер T-Invest соединяет ИИ-агента с вашим портфелем: агент понимает команды на обычном языке и исполняет их через API брокера. Эта статья — разбор инструмента: что умеет, как подключать, какие ограничения учитывать.
Что это
T-Invest MCP — сервер от Т-Инвестиций, который работает по протоколу Model Context Protocol. Он выступает мостом между большой языковой моделью и брокерской инфраструктурой: агент получает текстовую команду, переводит её в вызов методов API, получает данные обратно и интерпретирует результат. Написание кода для торгового робота не требуется — достаточно установить ИИ-агент.
Сервер работает по адресу invest-public-api.tbank.ru/mcp и принимает HTTP-подключения с аутентификацией по токену API. Токен выпускается в личном кабинете Т-Инвестиций с выбором уровня доступа: только чтение, полный доступ (торговля) или переводы (пополнение и переводы между счетами).
Ключевое правило: T-Invest MCP — посредник между ИИ и брокерским счётом. Агент отправляет текст, сервер превращает его в метод API, брокер выполняет операцию. Цепочка полностью прозрачна: агент не действует «вслепую», сервер не делает ничего без токена.
Зачем нужно
- Аналитика и мониторинг — поиск бумаг по параметрам, сбор котировок и стаканов, сводки новостей по эмитентам с оценкой рыночного сентимента.
- Управление портфелем — проверка баланса и состава, расчёт доходности, ребалансировка по текстовой команде, пополнение при отрицательном балансе.
- Торговые операции — рыночные и лимитные заявки, стоп-заявки, отмена ордеров.
- Анализ сделок — учёт налогов, оценка прибыльности по конкретным инструментам.
- Поиск идей — анализ прогнозов инвестдомов, суммаризация аналитики, поиск рыночных аномалий.
Как устроено
| Компонент | Назначение |
|---|---|
| MCP-протокол | Стандарт взаимодействия ИИ с внешними инструментами: агент запрашивает список методов, сервер возвращает схему, агент вызывает метод по имени. |
| HTTP-транспорт | Подключение по https://invest-public-api.tbank.ru/mcp. Не требует установки — работает через любой MCP-совместимый клиент. |
| Токен API | Bearer-токен в заголовке Authorization. Три уровня доступа. Банк не хранит токены — сохранить сразу после выпуска. |
| Инструменты | Набор методов для работы с брокерским счётом: котировки, портфель, заявки, операции, новости. |
Сервер совместим с любыми MCP-клиентами: Claude Desktop, Claude Code, Cursor, Qwen Code, Gemini CLI, плагины для VS Code и другие. Полный список доступен на странице документации.
Подключение
Шаг 1 — выпустить токен. Личный кабинет Т-Инвестиций → Настройки → Токены API → создать новый. Выбор уровня: только чтение, полный доступ или переводы.
Шаг 2 — добавить сервер в конфигурацию ИИ-приложения. Для Qwen Code:
qwen mcp add --scope user --transport http t-invest https://invest-public-api.tbank.ru/mcp --header "Authorization: Bearer <token>"
Или вручную в ~/.qwen/settings.json:
{
"mcpServers": {
"t-invest": {
"url": "https://invest-public-api.tbank.ru/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}Для VS Code — MCP: Add Server или файл .vscode/mcp.json:
{
"servers": {
"t-invest": {
"url": "https://invest-public-api.tbank.ru/mcp",
"type": "http",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}Для Claude Code — claude mcp add --scope user --transport http t-invest https://invest-public-api.tbank.ru/mcp --header "Authorization: Bearer <token>". Для Claude Desktop — claude\_desktop\_config.json с тем же блоком mcpServers.
Шаг 3 — перезапустить клиент и проверить: команда /mcp, переход в t-invest. Инструменты будут видны в интерфейсе.
Важно: если подключение выдаёт ошибку SSL или сертификата — нужна инструкция по установке сертификатов от брокера.
Когда использовать
| Ситуация | Подходит | Почему |
|---|---|---|
| Нужно быстро проверить портфель без кода | да | Текстовые команды заменяют скрипты |
| Нужна ребалансировка с расчётом | да | Агент посчитает объём и выставит заявку |
| Нужен торговый робот со сложной логикой | нет | MCP не заменяет программную стратегию |
| Нужна аналитика по нескольким брокерам | нет | Инструмент привязан к T-Invest API |
| Нужно отслеживать налоги и операции | да | Учёт и анализ доступны через агента |
Ограничения
Ограничения
Что учитывать
Короткое вводное предложение.
Привязка к брокеру — инструмент работает только с Т-Инвестициями.
Для других площадок нужно иное решение. Это ограничивает диверсификацию: анализировать портфели на разных брокера через один MCP нельзя.
Уровень доступа токена — токен только для чтения не позволит торговать, а токен полного доступа — открывает управление счётом.
Нельзя получить исторический токен — если токен потерян, придётся выпускать новый. Банк не хранит токены, поэтому восстановление невозможно.
Поддержка клиентов — MCP работает только с совместимыми ИИ-приложениями.
Не каждый чат-бот поддерживает протокол. Проверка совместимости необходима до начала работы.
Антипаттерны
Антипаттерны
Чего не делать
Короткое вводное предложение.
Давать полный доступ без крайней необходимости — начинать стоит с токена только для чтения, чтобы сначала понять логику работы инструмента.
Торговый доступ расширяется позже, когда появляется уверенность в корректности команд. Если что-то пойдёт не так — ущерб минимален.
Доверять агенту крупные суммы — ИИ ошибается, а брокер не несёт ответственности за решения ИИ.
Проверка каждой команды на тестовом счёте обязательна. Крупные сделки руками — надёжнее.
Игнорировать уровень доступа — торговый токен позволяет выставлять заявки без подтверждения.
Если агент получит некорректную команду не от вас — ущерб будет реальным. Хранить токен в безопасности.
Чеклист
Чеклист
Проверка перед запуском
Короткое вводное предложение.
Токен выпущен и сохранён — токен выпущен в личном кабинете, сохранён в надёжном месте.
После выпуска банк токен не хранит. Повторного получения не будет — только новый выпуск.
Уровень доступа выбран осознанно — для аналитики достаточно чтения, для торговли — полный доступ минимально необходимый.
Никаких «на вырост» токенов: утечка торгового токена опаснее утечки токена для чтения.
MCP-клиент совместим — проверено, что агент поддерживает протокол MCP и корректно читает список инструментов.
Перед реальным использованием выполнен тестовый запрос о балансе.
Ограничения протестированы — проведена пробная торговая операция на минимальный объём.
Понимание того, как агент интерпретирует команды, — до реального счёта, не на боевых деньгах.
Ссылки
Ссылки
- Документация: T-Invest MCP
- Документация: T-Invest API — обзор