API VEGA

bitget-agent-mcp — официальный MCP Trading Server Bitget

Подключайте Claude Desktop, Cursor, Continue, Windsurf и ChatGPT к Bitget через Model Context Protocol — торгуйте криптовалютой на естественном языке.

Быстрый старт · Возможности · Как это работает · Установка · Настройка · Безопасность · Устранение неполадок · FAQ

Обзор

bitget-agent-mcp — официальный сервер Model Context Protocol (MCP) для Bitget, который позволяет настольным ИИ-агентам, таким как Claude Desktop, Cursor, Continue, Windsurf и ChatGPT Desktop, работать с вашим аккаунтом Bitget с помощью команд на естественном языке.

Он построен на Bitget Unified Trading Account (UTA / v3) API и охватывает 89 торговых операций в области рыночных данных, спотовой торговли, фьючерсов, управления счетами и фондами, субаккаунтов, займов и налогов. Существенно то, что он не засоряет модель одним инструментом на каждый эндпойнт. Вместо этого он предоставляет небольшой, постепенно расширяемый набор намерений из 14 курируемых глаголов намерения (профиль по умолчанию загружает 12 глаголов + discover + raw = 14 инструментов), чтобы AI-хосты имели полный функционал без перегрузки контекстом и ошибок выбора инструментов, которые характерны для серверов с инструментом на каждый эндпойнт.

Часть Bitget Agent Hub — официальной открытой экосистемы AI Bitget, включая CLI, SDK, установщик и навыки рыночного анализа.

Быстрый старт

Требования

  • Node.js ≥ 20 (скачать)

  • Bitget API Key (создайте здесь) — включить разрешения Read + Trade

  • АИ-хост, поддерживающий MCP (Claude Desktop, Cursor, Continue, Windsurf, ChatGPT Desktop или любой MCP-клиент).

Одноразовая установка (рекомендуется)

Вставьте этот промпт в вашего AI-агента (Claude Desktop / Cursor и т. д.):

Please configure the Bitget MCP Server for my AI tool (requires Node.js 20+):
first ask me which AI tool I use (Claude Desktop / Cursor / Windsurf / ChatGPT
Desktop), then add a server that runs `npx -y @bitget-ai/bitget-agent-mcp` to
that tool's MCP config, with BITGET_API_KEY, BITGET_SECRET_KEY, and
BITGET_PASSPHRASE filled in. Confirm once the Bitget tools have loaded.

Агент обнаружит ваш инструмент, добавит запись сервера npx, свяжет учетные данные и проверит соединение.

Руководство по установке

Предпочитаете самим редактировать конфигурационные файлы? Перейдите к Настройке для per-tool JSON-фрагментов. Команда всегда та же:

npx -y @bitget-ai/bitget-agent-mcp

Что вы можете сделать

После настройки ваш ИИ получает нативный доступ к торговому стеку Bitget через естественный язык. Примеры (каждый из них отображает реальную операцию на поверхности):

Спросите у AIЧто происходитДанные доступа
"Какая текущая цена BTC?"Живой тикер через глагол market❌ Нет
"Получить свечи BTC за 4 ч"История OHLCV / K-ламен через market❌ Нет
"Какова ставка финансирования BTC perp?"Финансирование через market❌ Нет
"Покажите баланс USDT по всем счетам"Обзор счетов через account_overview✅ Да
"Купить 0.1 BTC по рынку"Рынок спота через order✅ Да
"Установить рычаг 10x и открыть лонг по BTC"account_config + order / position✅ Да
"Список моих открытых ордеров"order (open)✅ Да
"Перевести 500 USDT со спота на фьючерсы"Внутренний перевод через transfer_funds✅ Да
"Отменить все мои открытые ордера"order (cancelAll) — рискованно, требует подтверждения✅ Да
"Занять USDT под залог"Crypto loan через loan✅ Да

Данные рынка (глагол market) являются общедоступными и не требуют API-ключей; все операции, связанные с вашим аккаунтом, требуют ключей.

Расширенные режимы

  • --read-only — блокирует все операции записи для сессии. Глаголы остаются видимыми, но любые ордера, переводы, отмены или выводы отвергнутся до обращения к Bitget. Идеально для безопасного изучения. (Взаимно исключает --paper-trading.)

  • --paper-trading — маршрутизирует подписанные запросы в демо-среду Bitget (добавляет заголовок paptrading: 1). Требуется отдельный Demo API Key. Подходит для безопасной отработки стратегий.

  • --modules <list> — загружает только нужные модули. По умолчанию: account,trade,market. По требованию: strategy, cryptoloans, tax.

  • --surface <intent|full> — intent (по умолчанию) выводит курируемые глаголы. full дополнительно выводит по инструменту на каждое подлежащие endpoint.

Как агент использует это

Поверхность намерений постепенно обнаруживается. Вместо того чтобы читать всю схему сразу, агент следует схеме: обнаружение → развёртывание → выполнение:

discover({})                                   → перечислить бизнес-домены + мета-инструменты
discover({ domain: "trade" })                  → глаголы того домена, по одному на строку
discover({ tool: "order" })                    → полную схему одного глагола (+ его действия)
discover({ tool: "order", action: "place" })   → точное требование/опционал одного действия
order({ action: "place", ... })                → выполнить

Если подсказка уже подразумевает глагол и аргументы, агент может пропустить обнаружение и вызвать напрямую. discover({ search: "funding" }) выполняет строковый поиск по всей поверхности, когда домен не ясен. Две мета-инструмента остаются всегда:

  • discover — пошаговая интроспекция поверхности.

  • raw — запасной ход, который обращается к любой операции v3 через operationId для редкой "длинной хвост". (На практике каждая операция также охвачена глаголом, поэтому raw редко нужен.)

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

  • Обычные записи выполняются немедленно.

  • Высокий риск / необратимые операции (например, cancelAll, withdraw) возвращают { confirmationRequired: true }, если не передать confirm: true.

  • Любая запись поддерживает dryRun: true для предварительного просмотра отправляемого запроса без фактической отправки.

Аннотации инструментов MCP выводятся из уровня риска в SDK (read / write / high), чтобы хосты могли пометить рискные операции до того, как модель их вызовет.

Архитектура

graph TD
    A[AI Host<br/>Claude Desktop / Cursor / …] -->|MCP over stdio| B[bitget-agent-mcp<br/>thin protocol adapter]
    B --> S[@bitget-ai/bitget-agent-sdk<br/>intent verbs · discover · raw<br/>write-safety gate · HMAC signing · retry]
    S -->|HMAC-SHA256 signed| C[Bitget UTA v3 REST API<br/>api.bitget.com]
    D[Environment Variables<br/>BITGET_API_KEY etc.] --> B
    style B fill:#f9f,stroke:#333,stroke-width:2px
    style C fill:#bbf,stroke:#333,stroke-width:2px

Как это работает:

  • Ваш AI-хост запускает MCP-сервер локально через npx по stdio — без сетевого слушателя, без прокси.

  • Учетные данные передаются как переменные окружения из конфигурации хоста; сервер никогда не хранит, не логирует и не проксирует их.

  • Все аутентифицированные запросы подписываются в процессе с помощью HMAC-SHA256 и отправляются напрямую в официальный API Bitget.

  • Ответы возвращаются через MCP к вашему разговору с ИИ.

Все «умности» — обнаружение, маршрутизация намерений, воротник безопасной записи, подписание и формирование ответов — находятся в @bitget-ai/bitget-agent-sdk. Этот пакет — тонкий stdio-адаптер поверх него.

Установка

Поддерживаемые ИИ-хосты

ИИ-хостСтатусПримечания
Claude Desktop✅Первоклассный доступ через claude_desktop_config.json
Cursor✅По умолчанию профиль укладывается в лимит в 40 инструментов
Continue✅Расширение VS Code / JetBrains
ChatGPT Desktop✅Десктоп-клиент от OpenAI
Windsurf✅AI-IDE Codeium
Любой MCP-клиент✅Любой, кто поддерживает MCP по stdio

Пошаговая настройка

1. Получите ключ API

  • Войдите на bitget.com

  • Перейдите в Profile → API Management

  • Нажмите Create API Key

  • Включите разрешения Read и Trade

  • Скопируйте три значения: API Key, Secret Key, Passphrase

⚠️ Примечание по безопасности: храните их надёжно. Никогда не делитесь ими и не добавляйте в версионный контроль.

2. Настройте ваш хост

Используйте одноступенчатый промпт, или добавьте сервер в конфигурацию MCP вашего хоста вручную (см. [Настройка]).

3. Подтвердите

Спросите у ИИ: «Какие инструменты Bitget доступны?» Вы должны увидеть глаголы вроде market, order, position, account_overview, плюс discover и raw.

Настройка

Claude Desktop

Редактируйте claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "@bitget-ai/bitget-agent-mcp"],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

Перезапустите Claude Desktop после сохранения.

Cursor

Settings → MCP → Add New Server:

ПолеЗначение
Commandnpx
Args-y @bitget-ai/bitget-agent-mcp
EnvBITGET_API_KEY, BITGET_SECRET_KEY, BITGET_PASSPHRASE

⚠️ Лимит инструмтов Cursor: Cursor ограничивает общее количество MCP-инструментов до 40 на всех серверах. По умолчанию Bitget-профиль загружает 14 инструментов (12 глаголов намерения + discover + raw), оставляя 26 слотов для других серверов. --modules all даёт 16 инструментов.

Continue / Windsurf / ChatGPT Desktop / другие MCP-хосты

Используйте ту же команду npx -y @bitget-ai/bitget-agent-mcp и передавайте учетные данные через переменные окружения, следуя документации по настройке MCP вашего хоста. Если хост поддерживает MCP по stdio, это работает.

Примеры пользовательской конфигурации

Режим чтения-only (безопасный режим для исследования):

{ "args": ["-y", "@bitget-ai/bitget-agent-mcp", "--read-only"] }

Папер-трейдинг (Demo среда — используйте Demo API Keys):

{
  "args": ["-y", "@bitget-ai/bitget-agent-mcp", "--paper-trading"],
  "env": {
    "BITGET_API_KEY": "your-demo-api-key",
    "BITGET_SECRET_KEY": "your-demo-secret-key",
    "BITGET_PASSPHRASE": "your-demo-passphrase"
  }
}

Загрузка доп. модулей:

{ "args": ["-y", "@bitget-ai/bitget-agent-mcp", "--modules", "account,trade,market,cryptoloans,tax"] }

Опции CLI и переменные окружения

intent  curated verbs + discover + raw (default)
                       full    ALSO emit one tool per underlying v3 endpoint

  --read-only          Expose only read/query operations; block all writes.
  --paper-trading      Enable Demo Trading mode (requires a Demo API Key).
                       Mutually exclusive with --read-only.
  --help               Show help and exit
  --version            Show version and exit

bitget-agent-mcp [options]

  --modules <list>     account, trade, market, strategy,
                       cryptoloans, tax
                       "all" loads every module.
                       Default: account,trade,market

  --surface <mode>     intent  curated verbs + discover + raw (default)
                       full    ALSO emit one tool per underlying v3 endpoint

  --read-only          Expose only read/query operations; block all writes.
  --paper-trading      Enable Demo Trading mode (requires a Demo API Key).
                       Mutually exclusive with --read-only.
  --help               Show help and exit
  --version            Show version and exit
ПеременнаяНазначение
BITGET_API_KEYТребуется для приватных эндпойнтов
BITGET_SECRET_KEYТребуется для приватных эндпойнтов
BITGET_PASSPHRASEТребуется для приватных эндпойнтов
BITGET_API_BASE_URLОпциональный базовый URL API (по умолчанию https://api.bitget.com)
BITGET_TIMEOUT_MSОпциональный таймаут запроса в мс (по умолчанию 15000)
BITGET_MAX_RETRIESОпциональное максимальное число повторных попыток транспорта (по умолчанию политика SDK)

Без учетных данных API доступны только открытые/прочитанные операции (рыночные данные).

Модули и глаголы намерения

По умолчанию загружены account,trade,market. Полный набор включает 6 модулей и 14 курируемых глаголов намерения:

МодульПо умолчаниюГлаголы намеренияОперации
market✅market16
trade✅order, position, strategy_order17
account✅account_overview, account_config, repayment, transfer_funds, deposit, withdraw, funds_records, subaccount39
strategyпо требованиюрасширяет strategy_order (планы / TP-SL ордера)5
cryptoloansпо требованиюloan11
taxпо требованиюtax1

Всегда присутствуют независимо от модулей: discover (интроспекция) и raw (доступ к любой операции через operationId).

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

Защита учетных данных

✅ Данные не покидают ваш компьютер — ключи API считываются только из переменных окружения, не логируются, не записываются на диск и не проксируются через сервер.

  • ✅ Локальная подпись — все аутентифицированные запросы подписываются в процессе с помощью HMAC-SHA256, затем напрямую отправляются в официальный API Bitget.

  • ✅ Локальное выполнение через stdio — без сетевого слушателя, без удалённых точек входа и без телеметрии.

Режимы безопасности

  • --read-only — блокирует все операции записи для сессии; ИИ может запрашивать данные, но не может размещать ордера, переводить средства, отменять или выводить.

  • --paper-trading — маршрутизирует подписанные запросы в Demo-среду Bitget. Нет реальных средств. Требуется отдельный Demo API Key.

  • Ворота записи — рискованные/необратимые операции требуют явного confirm: true, а любая запись поддерживает dryRun: true для предпросмотра без сетевых запросов.

Ограничение скорости

SDK применяет политику повторной отправки и контроля скорости на стороне клиента, чтобы защититься от скриптов AI-циклов, посылающих множество запросов. Если Bitget возвращает 429, происходит автоматное замедление и повторная отправка.

Устранение неполадок

«Команда не найдена: npx»

Причина: Node.js не установлен или не добавлен в PATH.

Исправление: установите Node.js ≥ 20 с nodejs.org и перезапустите терминал/хост.

«Аутентификация не удалась» или «Неверный API-ключ»

Возможные причины и исправления:

  • Ключ API не имеет нужных прав → включите Read + Trade в [API Management].

  • Неверная Passphrase → скопируйте все три значения точно так, как указано.

  • Использование активных ключей в режиме --paper-trading (или наоборот) → используйте Demo API Key для paper trading.

«Инструмент не распознан AI»

Причина: сервер MCP настроен неверно или хост не перезапущен.

Исправление: убедитесь, что конфигурационный файл валиден JSON, перезапустите хост полностью, затем попробуйте: «List available MCP tools.»

Cursor показывает меньше инструментов Bitget, чем ожидалось

Причина: другие MCP-серверы занимают лимит Cursor на 40 инструментов. По умолчанию Bitget-профиль — 14 инструментов.

Исправление: удалите неиспользуемые MCP-серверы или используйте --modules, чтобы load-ить только нужное.

«Rate limit exceeded»

Причина: слишком частые вызовы.

Исправление: SDK автоматически ограничивает частоты, но если вы достигли лимита сервера Bitget, подождите около 60 секунд и попробуйте снова. Не просите ИИ размещать сотни ордеров подряд.

MCP-сервер не запускается

Проверьте: версию Node.js (node --version ≥ 20), доступность к api.bitget.com и что исходящие HTTPS-соединения не блокируются файерволом.

Обновления

Поскольку установка выполняется через npx -y, последняя версия подтягивается автоматически каждый запуск вашего AI-хоста — обновления вручную не требуются.

Чтобы принудительно обновить кэш npm:

npx @bitget-ai/bitget-agent-mcp@latest --version

Чтобы обновить весь Bitget AI toolkit сразу, используйте установщик в agent_hub.

Связанные проекты

ПакетНазначениеЛучше подходит для
agent-cliТерминальный инструмент ИИ для торговли (bgc)Claude Code, Codex CLI, shell-native агентов
agent-skillРуководство по рассуждениям для CLIОбучение агентов правильному использованию bgc
agent-sdkБазовый SDK на TypeScriptРазработчики кастомных интеграций
bitget-signalНавыки рыночного анализа (без API-ключа)Макро-, on-chain, сентимент, технические, новости
agent_hubЦентральная экосистема входа + установщикОбзор всех инструментов Bitget AI

FAQ

Что такое bitget-agent-mcp?

Это официальный MCP (Model Context Protocol) сервер для Bitget. Он предоставляет доступ к 89 операций Bitget UTA v3 настольным AI-клиентам (Claude Desktop, Cursor, Windsurf, ChatGPT Desktop и др.) через 14 курируемых глаголов намерения плюс инструмент discover для интроспекции и raw — запасной путь к операциям через operationId — в рамках MCP.

Чем это отличается от agent-cli?

  • bitget-agent-mcp — для настольных AI-хостов, которые поддерживают MCP (Claude Desktop, Cursor и т. д.).

  • agent-cli (bgc) — для терминального AI (Claude Code, Codex CLI), работающего в вашем shell.

Оба работают на одном и том же SDK и предлагают одну и ту же поверхность намерений — выберите тот, который соответствует вашему инструменту ИИ.

Зачем глаголы намерения вместо одного инструмента на эндпойнт?

Серверы с одним инструментом на эндпойнт объявляют по одному инструменту на каждый эндпойнт, что увеличивает размер контекста модели и ухудшает точность выбора инструментов. Поверхность намерений держит дефолт из 14 инструментов (12 глаголов + discover + raw), обеспечивая доступ ко всем 89 операциям напрямую — и raw позволяет обратиться к любой операции через operationId, если нужен длинный хвост. Агент использует discover, чтобы углубиться в детали только по мере необходимости.

Какие модули загружены по умолчанию?

По умолчанию загружены account (39 операций), trade (17 операций), market (16 операций) = 72 операции, через 12 глаголов намерения плюс discover и raw (всего 14 инструментов). Дополнительные модули можно загрузить с помощью --modules strategy,cryptoloans,tax или --modules all (который охватывает 14 глаголов на 89 эндпойнтах).

Есть ли ограничение инструментов у Cursor?

Да — Cursor ограничивает общее количество MCP-инструментов до 40. По умолчанию Bitget-профиль загружает 14 инструментов, что оставляет 26 слотов для других серверов. --modules all даёт 16 инструментов.

Как предотвратить случайные заказы?

Добавьте "--read-only" в ваши аргументы конфигурации. Любая запись будет отклонена для сессии — ИИ может запрашивать балансы и рынки, но не может размещать ордера, переводить средства, отменять или выводить.

Можно ли тестировать без риска для реальных средств?

Да — используйте paper trading: создайте [Demo API Key], установите демонстрационные учетные данные в переменные окружения и добавьте "--paper-trading" в ваши аргументы. Подписанные запросы направляются в демо-среду Bitget.

Надёжны ли мои ключи API?

Да. Учётные данные существуют только в конфигурации MCP на вашем хосте, не передаются через сервер, подписываются локально через HMAC-SHA256, и не логируются/не записываются на диск этим сервером.

Это бесплатно?

Да — лицензия MIT, бесплатна для личного и коммерческого использования. MCP-сервер поддерживается Bitget без оплаты.

Какие AI-инструменты поддерживаются?

Claude Desktop, Cursor, Continue, ChatGPT Desktop, Windsurf и любой MCP-клиент, который общается через stdio-транспорт.

Вклад

Внесение исправлений и предложение улучшений приветствуются.

  • Сообщайте об ошибках / запрашивайте фичи: GitHub Issues

  • Проблемы с безопасностью: пожалуйста, сообщайте приватно через функцию безопасных уведомлений GitHub на репозиторий — не открывайте публичную тему.

Лицензия

MIT License — бесплатна для личного и коммерческого использования.

⚠️ Предупреждение о риске: торговля криптовалютой несет существенные риски. Вы несете ответственность за любые ордера, которые ваш AI-агент разместит от вашего имени. Используйте --read-only и --paper-trading, чтобы безопасно репетировать перед запуском вживую. Прошлые результаты не гарантируют будущие.

Официальный инструмент Bitget Agent Hub · часть открытой экосистемы Bitget AI · Основание: agent-sdk · Другие поверхности: agent-cli · agent-skill · Рыночные сигналы: bitget-signal