gainium-mcp — MCP-сервер для Claude Code: боты и сделки Gainium
MCP-сервер, через который ИИ-ассистент управляет торговыми ботами, сделками и балансами Gainium. Пригодится, если боты крутятся сами, а команды удобнее отдавать из чата.
claude mcp add --transport http gainium-mcp https://mcp.gainium.io/mcpЧто делает gainium-mcp
Сервер даёт ассистенту 17 инструментов: список и настройка ботов типов dca, combo, grid, работа со сделками dca, combo, terminal, запуск бэктестов. Операции чтения помечены readOnlyHint, записи — destructiveHint, так что клиент видит, где он меняет состояние.
Есть три режима развёртывания. Локальный stdio берёт ключи из переменных окружения. Хостинговый OAuth 2.1 — тот, что работает на публичном https://mcp.gainium.io/mcp и нужен для коннектора Anthropic: клиент получает токен у сервера авторизации Gainium и шлёт его в заголовке Authorization: Bearer. Третий, устаревший, передаёт X-API-Key и X-API-Secret в каждом запросе. В режиме OAuth заголовки с ключами игнорируются.
Для локального запуска нужна пара ключей из настроек API Gainium: GAINIUM_API_KEY и GAINIUM_API_SECRET. Без них сервер в stdio-режиме не аутентифицируется. Ограничения ключа — только чтение, только бумажная торговля, один бот — проверяются на стороне сервера, поэтому узкий ключ остаётся узким и после подключения.
Какие задачи решает
- посмотреть список ботов и их настройки из чата
- запустить или остановить конкретного бота
- закрыть сделку или долить в неё средства
- прогнать бэктест стратегии перед запуском
- клонировать бота с другими параметрами
Примеры запросов агенту
- Покажи все мои боты типа
gridи их текущие настройки - Запусти бота
dcaс идентификатором, который я назову - Прогони бэктест этой стратегии и покажи результат
Как установить gainium-mcp
1Командой платформы: удалённый сервер
claude mcp add --transport http gainium-mcp https://mcp.gainium.io/mcp2Командой платформы
claude mcp add --env GAINIUM_API_KEY=<GAINIUM_API_KEY> --env GAINIUM_API_SECRET=<GAINIUM_API_SECRET> --env GAINIUM_PAPER_ONLY=<GAINIUM_PAPER_ONLY> --env GAINIUM_ALLOWED_BOT_ID=<GAINIUM_ALLOWED_BOT_ID> --transport stdio gainium-mcp -- npx -y gainium-mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add gainium-mcp --url https://mcp.gainium.io/mcp2Командой платформы
codex mcp add gainium-mcp --env GAINIUM_API_KEY=<GAINIUM_API_KEY> --env GAINIUM_API_SECRET=<GAINIUM_API_SECRET> --env GAINIUM_PAPER_ONLY=<GAINIUM_PAPER_ONLY> --env GAINIUM_ALLOWED_BOT_ID=<GAINIUM_ALLOWED_BOT_ID> -- npx -y gainium-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"gainium-mcp": {
"url": "https://mcp.gainium.io/mcp"
}
}
}{
"mcpServers": {
"gainium-mcp": {
"command": "npx",
"args": [
"-y",
"gainium-mcp"
],
"env": {
"GAINIUM_API_KEY": "<GAINIUM_API_KEY>",
"GAINIUM_API_SECRET": "<GAINIUM_API_SECRET>",
"GAINIUM_PAPER_ONLY": "<GAINIUM_PAPER_ONLY>",
"GAINIUM_ALLOWED_BOT_ID": "<GAINIUM_ALLOWED_BOT_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"gainium-mcp": {
"type": "http",
"url": "https://mcp.gainium.io/mcp"
}
}
}{
"servers": {
"gainium-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gainium-mcp"
],
"env": {
"GAINIUM_API_KEY": "<GAINIUM_API_KEY>",
"GAINIUM_API_SECRET": "<GAINIUM_API_SECRET>",
"GAINIUM_PAPER_ONLY": "<GAINIUM_PAPER_ONLY>",
"GAINIUM_ALLOWED_BOT_ID": "<GAINIUM_ALLOWED_BOT_ID>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http gainium-mcp https://mcp.gainium.io/mcp2Командой платформы
gemini mcp add -e GAINIUM_API_KEY=<GAINIUM_API_KEY> -e GAINIUM_API_SECRET=<GAINIUM_API_SECRET> -e GAINIUM_PAPER_ONLY=<GAINIUM_PAPER_ONLY> -e GAINIUM_ALLOWED_BOT_ID=<GAINIUM_ALLOWED_BOT_ID> gainium-mcp npx -y gainium-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gainium-mcp
Как установить gainium-mcp в Claude Code?
Через хостинговый эндпоинт: claude mcp add --transport http gainium-mcp https://mcp.gainium.io/mcp. Либо локально со своими ключами: `claude mcp add --env GAINIUM_API_KEY=<GAINIUM_API_KEY> --env GAINIUM_API_SECRET=<GAINIUM_API_SECRET> --env GAINIUM_PAPER_ONLY=<GAINIUM_PAPER_ONLY> --env GAINIUM_ALLOWED_BOT_ID=<GAINIUM_ALLOWED_BOT_ID> --transport stdio gainium-mcp -- npx -y gainium-mcp`.
Что делает gainium-mcp?
Даёт ИИ-ассистенту доступ к аккаунту Gainium: список и создание ботов, правка настроек, запуск и остановка, работа со сделками и запуск бэктестов. Всё идёт через стандартный интерфейс MCP.
Какие ключи нужны для локального запуска?
Пара из настроек API Gainium — GAINIUM_API_KEY и GAINIUM_API_SECRET. Если ключ ограничен бумажной торговлей или одним ботом, эти ограничения продолжат действовать.
