Финам MCP: как подключить Finam Trade API к Claude, Cursor и Codex

tikhonov-aleksei/finam-mcp· Проверено 12.11.2026· 0на GitHub

Подключает агента к Finam Trade API: читать счёт, сделки и транзакции, котировки, свечи и стакан, выставлять и отменять заявки.

2 реализации:

Запускается через uvx по токену и номеру счёта, 18 инструментов; токен сам меняет на короткий JWT и обновляет его.

Как подключить

Что сделать до подключения

Python 3.12 или новее и uv

API-токен и ID торгового счёта из личного кабинета Финама

FINAM_API_TOKEN

Личный кабинет Финама → раздел API → создать токен

FINAM_ACCOUNT_ID

ID вашего торгового счёта в том же личном кабинете

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'FINAM_API_TOKEN=<ваш API-токен Finam>' --env 'FINAM_ACCOUNT_ID=<ID торгового счёта>' --transport stdio finam \
  -- uvx finam_mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.finam]
command = "uvx"
args = ["finam_mcp"]

[mcp_servers.finam.env]
FINAM_API_TOKEN = "<ваш API-токен Finam>"
FINAM_ACCOUNT_ID = "<ID торгового счёта>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "finam": {
      "command": "uvx",
      "args": ["finam_mcp"],
      "env": {
        "FINAM_API_TOKEN": "<ваш API-токен Finam>",
        "FINAM_ACCOUNT_ID": "<ID торгового счёта>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "finam": {
      "type": "stdio",
      "command": "uvx",
      "args": ["finam_mcp"],
      "env": {
        "FINAM_API_TOKEN": "<ваш API-токен Finam>",
        "FINAM_ACCOUNT_ID": "<ID торгового счёта>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "finam": {
      "command": "uvx",
      "args": ["finam_mcp"],
      "env": {
        "FINAM_API_TOKEN": "<ваш API-токен Finam>",
        "FINAM_ACCOUNT_ID": "<ID торгового счёта>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "finam": {
      "command": "uvx",
      "args": ["finam_mcp"],
      "env": {
        "FINAM_API_TOKEN": "<ваш API-токен Finam>",
        "FINAM_ACCOUNT_ID": "<ID торгового счёта>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "finam": {
        "type": "local",
        "command": ["uvx", "finam_mcp"],
        "environment": {
          "FINAM_API_TOKEN": "<ваш API-токен Finam>",
          "FINAM_ACCOUNT_ID": "<ID торгового счёта>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "finam": {
      "command": "uvx",
      "args": ["finam_mcp"],
      "env": {
        "FINAM_API_TOKEN": "<ваш API-токен Finam>",
        "FINAM_ACCOUNT_ID": "<ID торгового счёта>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "finam": {
      "command": "uvx",
      "args": ["finam_mcp"],
      "env": {
        "FINAM_API_TOKEN": "<ваш API-токен Finam>",
        "FINAM_ACCOUNT_ID": "<ID торгового счёта>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_accountчитает сведения о счёте

tradesпоказывает сделки за период

transactionsпоказывает транзакции

assetsвыводит доступные инструменты

get_assetчитает данные инструмента

get_asset_paramsчитает торговые параметры инструмента

exchangesвыводит список бирж

options_chainстроит цепочку опционов

scheduleпоказывает расписание торгов

clockпоказывает время сервера

barsвыгружает исторические свечи

last_quoteпоказывает последнюю котировку

latest_tradesпоказывает последние сделки

order_bookчитает стакан заявок

get_ordersвыводит заявки счёта

get_orderчитает заявку по ID

place_orderвыставляет заявку

cancel_orderотменяет заявку

Учебный сервер к статье на Хабре: запускается вручную через uvicorn как HTTP на localhost:3000, ключ и счёт передаются заголовками.

Как подключить

Что сделать до подключения

Python 3.12 и uv: склонировать репозиторий и выполнить uv sync

Запустить сервер командой uvicorn src.main:finam_mcp --port 3000 и держать его открытым

finam-api-key

API-ключ из личного кабинета Finam Trade

finam-account-id

ID торгового счёта из того же кабинета

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http finam-mcp http://localhost:3000/mcp \
  --header 'finam-api-key: <API-ключ Finam>' \
  --header 'finam-account-id: <ID торгового счёта>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.finam-mcp]
url = "http://localhost:3000/mcp"
http_headers = { "finam-api-key" = "<API-ключ Finam>", "finam-account-id" = "<ID торгового счёта>" }

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "finam-mcp": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "finam-api-key": "<API-ключ Finam>",
        "finam-account-id": "<ID торгового счёта>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "finam-mcp": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "finam-api-key": "<API-ключ Finam>",
        "finam-account-id": "<ID торгового счёта>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "finam-mcp": {
      "httpUrl": "http://localhost:3000/mcp",
      "headers": {
        "finam-api-key": "<API-ключ Finam>",
        "finam-account-id": "<ID торгового счёта>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "finam-mcp": {
      "httpUrl": "http://localhost:3000/mcp",
      "headers": {
        "finam-api-key": "<API-ключ Finam>",
        "finam-account-id": "<ID торгового счёта>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "finam-mcp": {
        "type": "remote",
        "url": "http://localhost:3000/mcp",
        "headers": {
          "finam-api-key": "<API-ключ Finam>",
          "finam-account-id": "<ID торгового счёта>"
        }
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://localhost:3000/mcp
Request headers: finam-api-key: <API-ключ Finam>; finam-account-id: <ID торгового счёта>

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "finam-mcp": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "finam-api-key": "<API-ключ Finam>",
        "finam-account-id": "<ID торгового счёта>"
      }
    }
  }
}

Что попросить агента

«Покажи информацию о моём счёте»Агент вызовет get_account и выведет средства, позиции и прибыль

«Купи 10 акций Сбербанка по рыночной цене»Агент уточнит инструмент через get_asset и выставит заявку через place_order

«Какая сейчас цена на GAZP?»Агент вызовет last_quote по GAZP@MOEX

«Покажи мои сделки за <месяц> и сравни с часовыми свечами по <тикер>»Агент выгрузит сделки через trades и свечи через bars и сопоставит их

Для каких задач

Показать состояние счёта: свободные средства, открытые позиции и их прибыль

Выгрузить сделки и транзакции за период

Узнать котировку, последние сделки и стакан по тикеру

Выгрузить свечи от минуты до недели для анализа

Выставить или отменить биржевую заявку

Ограничения

Оба сервера сторонние, у каждого 0 звёзд на GitHub и последнее обновление в октябре 2025 года

Сервер Ildarjan сделан для демонстрации и обучения и запускается только вручную из склонированного репозитория

place_order выставляет реальную заявку на вашем счёте: держите подтверждение вызовов включённым

Инструменты задаются в формате ТИКЕР@MIC, например SBER@MOEX; по умолчанию биржи MOEX и SPBE

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Finam MCP Server	tikhonov-aleksei (mdmeldon)	0	локально	токен	18	6 октября 2025
Finam MCP Server (Ildarjan)	Ildarjan	0	HTTP	токен	17	27 октября 2025

Частые вопросы

Есть ли у Финама свой MCP-сервер?

Оба сервера на странице написали частные разработчики, Финам их не ведёт. Сервер Ildarjan автор называет учебным: он сделан к статье на Хабре. Работают оба через Finam Trade API по вашему токену.

Где взять токен и номер счёта?

Войдите в личный кабинет Финама, откройте раздел API и создайте токен. Там же найдите ID торгового счёта и передайте его в FINAM_ACCOUNT_ID.

Как часто нужно обновлять токен?

Не нужно: сервер tikhonov-aleksei получает по API-токену короткоживущий JWT примерно на 15 минут и обновляет его сам.

Какие таймфреймы свечей доступны?

M1, M5, M15, M30, H1, H4, D1 и W1. Даты и время передаются в формате ISO 8601, например 2024-01-15T10:30:00+03:00.

Как подключить Finam MCP к Cursor?

Добавьте в ~/.cursor/mcp.json сервер finam: command uvx, args finam_mcp и переменные FINAM_API_TOKEN и FINAM_ACCOUNT_ID. Конфиги для других клиентов — во вкладках блока «Как подключить».

Работает ли сервер из России?

Серверы работают на вашем компьютере и ходят в Finam Trade API по вашему токену: нужен брокерский счёт в Финаме и доступ к API в личном кабинете.

Финам MCP: как подключить Finam Trade API к Claude, Cursor и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

Частые вопросы

Похожие серверы