Servidor MCP de T-Invest

Servidor MCP para trabajar con la API de T-Invest (Tinkoff Investments) desde Claude y otros clientes LLM.

Puerto t-invest-mcp-server en Node.js.

Herramientas (30)

Gestión de cuentas

Análisis y herramientas

Historial de operaciones

Operaciones comerciales

* — parámetro obligatorio, ? — opcional

Flujo de trabajo: el agente primero llama a get_accounts, memoriza el accountId y lo utiliza en las solicitudes posteriores.

Related MCP server: IBKR TWS MCP Server

Variables de entorno

URL para producción: https://invest-public-api.tinkoff.ru/rest/ URL para sandbox: https://sandbox-invest-public-api.tinkoff.ru/rest/

Seguridad

El servidor opera con dinero real a través de la API. Algunas reglas que reducen significativamente el riesgo:

1. Por defecto, utilice APP_T_INVEST_READONLY=true. En este modo, solo se registran las herramientas de lectura, y las 6 operaciones que pueden mover su dinero (post_order, cancel_order, post_stop_order, cancel_stop_order, pay_in, currency_transfer) no están disponibles para la LLM. Esto es suficiente para análisis, informes y monitoreo de cartera.

2. Desactive READONLY solo de forma consciente. Cualquier operación comercial que invoque la LLM es irreversible. La confirmación de las transacciones está delegada al cliente MCP (Claude Desktop le preguntará antes de llamar a la herramienta), pero esta es la última línea de defensa, no la primera. Si no planea operar a través del asistente hoy, no le dé esa posibilidad.

3. Cree un token separado con privilegios mínimos en developer.tbank.ru. Si no necesita operar, use un token de solo lectura. No utilice el token principal con todos los privilegios "por si acaso".

4. Almacene el token solo en variables de entorno o en un gestor de secretos. No lo copie directamente en claude_desktop_config.json si el archivo se guarda en una copia de seguridad en la nube, git o una máquina compartida. En macOS, el token del archivo de configuración es visible para todos los procesos de su usuario.

5. Utilice solo HTTPS-URL para APP_T_INVEST_BASE_URL. El servidor se negará a iniciarse con http://, esto es intencional.

6. Nunca suba el archivo .env ni pegue el token en issues, PRs o chats. Verifique que .gitignore cubra .env y *.log.

El servidor no registra el token ni lo incluye en las respuestas de MCP, pero cualquier fuga a través del entorno, la configuración o el historial de la shell queda del lado del usuario.

Configuración en Claude Desktop

Archivo de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json

A través de 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"
      }
    }
  }
}

Elimine APP_T_INVEST_READONLY (o establézcalo en false) solo si desea conscientemente dar a la LLM la capacidad de colocar órdenes y transferir dinero.

A través de 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"
      ]
    }
  }
}

Ejecución

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

Desde el código fuente

npm install
npm run build
npm start

Descargo de responsabilidad

Este proyecto es una herramienta no oficial, no relacionada con T-Bank (Tinkoff). El servidor interactúa con datos financieros y operaciones comerciales a través de la API pública de T-Invest. Los usuarios son totalmente responsables de sus acciones. Operar en bolsa conlleva el riesgo de pérdida de capital.

Licencia

MIT