T-Invest MCP Server

MCP сервер для работы с API Т-Инвестиций (Тинькофф Инвестиции) из Claude и других LLM-клиентов.

Порт t-invest-mcp-server на Node.js.

Инструменты (30)

Управление счетами

Аналитика и инструменты

История операций

Торговые операции

* — обязательный параметр, ? — опциональный

Рабочий процесс: агент сначала вызывает get_accounts, запоминает accountId и использует его в последующих запросах.

Переменные окружения

URL для прода: https://invest-public-api.tinkoff.ru/rest/ URL для песочницы: https://sandbox-invest-public-api.tinkoff.ru/rest/

Безопасность

Сервер работает с реальными деньгами через API. Несколько правил, которые сильно снижают риск:

1. По умолчанию используйте APP_T_INVEST_READONLY=true. В этом режиме регистрируются только инструменты на чтение, а 6 операций, которые могут двигать ваши деньги (post_order, cancel_order, post_stop_order, cancel_stop_order, pay_in, currency_transfer), вообще не доступны LLM. Этого достаточно для аналитики, отчётов, мониторинга портфеля.

2. Снимайте READONLY только осознанно. Любая торговая операция, которую вызовет LLM, необратима. Подтверждение сделок делегировано MCP-клиенту (Claude Desktop спросит вас перед вызовом инструмента) — но это последняя линия защиты, а не первая. Если вы не собираетесь сегодня торговать через ассистента, не давайте ему такую возможность.

3. Создайте отдельный токен с минимальными правами на developer.tbank.ru. Если торговля не нужна — read-only токен. Не используйте основной токен с полными правами «на всякий случай».

4. Храните токен только в переменных окружения или секрет-менеджере. Не копируйте его в claude_desktop_config.json напрямую, если файл попадает в облачный бэкап / git / shared-машину. На macOS токен из конфига видят все процессы вашего пользователя.

5. Используйте только HTTPS-URL для APP_T_INVEST_BASE_URL. Сервер откажется стартовать с http:// — это намеренно.

6. Никогда не коммитьте .env и не вставляйте токен в issue/PR/чат. Проверьте, что .gitignore покрывает .env и *.log.

Сервер сам не логирует токен и не включает его в ответы MCP, но любая утечка через окружение, конфиг или историю shell остаётся на стороне пользователя.

Настройка в Claude Desktop

Файл конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json

Через npx

{
  "mcpServers": {
    "t-invest": {
      "command": "npx",
      "args": ["t-invest-mcp-server"],
      "env": {
        "APP_T_INVEST_BASE_URL": "https://invest-public-api.tinkoff.ru/rest/",
        "APP_T_INVEST_TOKEN": "your_token",
        "APP_T_INVEST_READONLY": "true"
      }
    }
  }
}

Уберите APP_T_INVEST_READONLY (или поставьте false) только если осознанно хотите дать LLM возможность размещать ордера и переводить деньги.

Через Docker

{
  "mcpServers": {
    "t-invest": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "APP_T_INVEST_BASE_URL=https://invest-public-api.tinkoff.ru/rest/",
        "-e", "APP_T_INVEST_TOKEN=your_token",
        "-e", "APP_T_INVEST_READONLY=true",
        "t-invest-mcp-server"
      ]
    }
  }
}

Запуск

npx

APP_T_INVEST_BASE_URL=https://invest-public-api.tinkoff.ru/rest/ \
APP_T_INVEST_TOKEN=your_token \
npx t-invest-mcp-server

Docker

docker build -t t-invest-mcp-server .

docker run -i --rm \
  -e APP_T_INVEST_BASE_URL=https://invest-public-api.tinkoff.ru/rest/ \
  -e APP_T_INVEST_TOKEN=your_token \
  t-invest-mcp-server

Из исходников

npm install
npm run build
npm start

Дисклеймер

Этот проект — неофициальный инструмент, не связанный с Т-Банком (Тинькофф). Сервер взаимодействует с финансовыми данными и торговыми операциями через публичный API Т-Инвестиций. Пользователи несут полную ответственность за свои действия. Торговля на бирже сопряжена с риском потери средств.

Лицензия

MIT