T-Invest MCP Server

MCP-Server für die Arbeit mit der T-Invest API (Tinkoff Investments) aus Claude und anderen LLM-Clients.

Port des t-invest-mcp-server auf Node.js.

Tools (30)

Kontoverwaltung

Analytik und Tools

Transaktionshistorie

Handelsoperationen

* — Pflichtparameter, ? — optional

Arbeitsablauf: Der Agent ruft zuerst get_accounts auf, merkt sich die accountId und verwendet diese in nachfolgenden Anfragen.

Related MCP server: IBKR TWS MCP Server

Umgebungsvariablen

URL für Produktion: https://invest-public-api.tinkoff.ru/rest/ URL für Sandbox: https://sandbox-invest-public-api.tinkoff.ru/rest/

Sicherheit

Der Server arbeitet über die API mit echtem Geld. Einige Regeln, die das Risiko erheblich senken:

1. Verwenden Sie standardmäßig APP_T_INVEST_READONLY=true. In diesem Modus werden nur Lese-Tools registriert, und die 6 Operationen, die Ihr Geld bewegen könnten (post_order, cancel_order, post_stop_order, cancel_stop_order, pay_in, currency_transfer), sind für das LLM überhaupt nicht zugänglich. Dies reicht für Analysen, Berichte und Portfolio-Monitoring aus.

2. Deaktivieren Sie READONLY nur bewusst. Jede Handelsoperation, die das LLM auslöst, ist unumkehrbar. Die Bestätigung von Trades wird an den MCP-Client delegiert (Claude Desktop fragt Sie vor dem Aufruf des Tools) — aber dies ist die letzte Verteidigungslinie, nicht die erste. Wenn Sie heute nicht über den Assistenten handeln möchten, geben Sie ihm diese Möglichkeit nicht.

3. Erstellen Sie ein separates Token mit minimalen Rechten auf developer.tbank.ru. Wenn kein Handel erforderlich ist, verwenden Sie ein Read-only-Token. Verwenden Sie nicht das Haupt-Token mit vollen Rechten „für alle Fälle“.

4. Speichern Sie das Token nur in Umgebungsvariablen oder einem Secret-Manager. Kopieren Sie es nicht direkt in die claude_desktop_config.json, wenn die Datei in ein Cloud-Backup / Git / Shared-Machine gelangt. Unter macOS können alle Prozesse Ihres Benutzers das Token aus der Konfigurationsdatei sehen.

5. Verwenden Sie nur HTTPS-URLs für APP_T_INVEST_BASE_URL. Der Server verweigert den Start mit http:// — dies ist beabsichtigt.

6. Committen Sie niemals .env und fügen Sie das Token nicht in Issues/PRs/Chats ein. Überprüfen Sie, ob .gitignore die Dateien .env und *.log abdeckt.

Der Server selbst protokolliert das Token nicht und fügt es nicht in MCP-Antworten ein, aber jedes Leck über die Umgebung, Konfiguration oder Shell-Historie bleibt auf der Seite des Benutzers.

Einrichtung in Claude Desktop

Konfigurationsdatei: ~/Library/Application Support/Claude/claude_desktop_config.json

Über 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"
      }
    }
  }
}

Entfernen Sie APP_T_INVEST_READONLY (oder setzen Sie es auf false) nur, wenn Sie dem LLM bewusst die Möglichkeit geben möchten, Aufträge zu platzieren und Geld zu überweisen.

Über 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"
      ]
    }
  }
}

Start

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

Aus dem Quellcode

npm install
npm run build
npm start

Haftungsausschluss

Dieses Projekt ist ein inoffizielles Tool, das nicht mit der T-Bank (Tinkoff) verbunden ist. Der Server interagiert mit Finanzdaten und Handelsoperationen über die öffentliche API von T-Invest. Die Benutzer tragen die volle Verantwortung für ihre Handlungen. Der Handel an der Börse ist mit dem Risiko des Kapitalverlusts verbunden.

Lizenz

MIT