CopyTrader · MCP

Как подключить ИИ-ассистента к CopyTrader через MCP

Подготовьте совместимый ИИ-клиент, выполните вход CopyTrader и проверьте доступ к своим проектам. Эта инструкция объясняет каждый этап подключения и отзыв доступа.

Что понадобится

Аккаунт CopyTrader

Используйте существующий аккаунт или завершите регистрацию через штатные формы. Ваши проекты и права определяет CopyTrader.

Совместимый ИИ-клиент

Нужны удалённый MCP через Streamable HTTP по HTTPS и OAuth Authorization Code с PKCE S256. Приложение должно принимать ответ после браузерного входа и безопасно хранить учётные данные подключения.

Идентификатор OAuth-клиента и точный адрес возврата должны быть зарегистрированы у оператора CopyTrader для вашего приложения. Одного адреса сервера может быть недостаточно. Если профиль не настроен, сначала согласуйте его с оператором.

Подключение по шагам

  1. Подготовьте аккаунт

    Войдите в существующий аккаунт CopyTrader. Новому пользователю нужно завершить регистрацию и штатные подтверждения. Регистрация и подключение MCP — отдельные этапы.

  2. Настройте подключение в ИИ-клиенте

    Откройте настройки интеграций клиента. Выберите зарегистрированный для него OAuth-профиль и укажите адрес MCP-сервера ниже. Названия полей зависят от приложения.

  3. Начните авторизацию

    Начните подключение средствами клиента и откройте сформированную им ссылку CopyTrader. Введите данные и выполните штатные проверки только на предназначенной для этого странице входа.

  4. Подтвердите доступ

    Ознакомьтесь с областью доступа и подтвердите подключение в действующем процессе согласия, включая Telegram. После подтверждения страница продолжит авторизацию. Дождитесь завершения подключения в клиенте.

  5. Проверьте подключение

    Попросите ассистента проверить доступ и показать ваши проекты. Успешный вход в веб-кабинет или открытая страница возврата сами по себе ещё не подтверждают работу MCP.

  6. Начните с чтения

    Выберите проект и запросите его состояние или статистику. Для изменения настроек дайте отдельное поручение с конкретными параметрами. Сохраняются предусмотренные продуктом подтверждения.

Адрес MCP-сервераhttps://api.copytrader.pw/mcp

Как убедиться, что MCP работает

Начните с запроса, который только читает данные:

Проверь мой доступ MCP и покажи мои проекты CopyTrader. Пока выполняй только чтение.

Клиент должен получить успешный ответ защищённого инструмента проверки доступа и список доступных проектов. Затем можно выбрать проект и прочитать доступные возможности. Пустой список требует проверки аккаунта и его проектов, а не автоматического создания нового аккаунта.

Для технической проверки клиент использует get_my_access, get_mcp_capabilities и list_projects. Учётные данные обрабатывает OAuth-компонент клиента и сохраняет в его защищённом хранилище.

Какие разрешения вы предоставляете

Доступ охватывает ваш аккаунт Main и все текущие и будущие собственные проекты в пределах действующих прав. Текущее подключение не предусматривает отдельный выбор одного проекта или режим разрешений «только чтение». Просьба ассистенту только читать данные ограничивает поручение, но не меняет выданные разрешения.

Пароли, коды, биржевые ключи и токены вводятся только в предназначенных для них формах. Не отправляйте их в чат. MCP-токен не заменяет вход в веб-кабинет.

Копирование сделок связано с риском потерь. Подключение ИИ не гарантирует доходность или одинаковые результаты на разных аккаунтах.

Как отозвать доступ

  1. Войдите в кабинет CopyTrader и откройте раздел подключений агентов.
  2. Выберите нужное подключение и подтвердите отзыв доступа.
  3. Для повторного подключения снова выполните авторизацию и согласие через ИИ-клиент.

Если подключение не работает

СитуацияЧто проверить
Клиент не предлагает вход или не завершает егоПоддержку удалённого MCP и нужного OAuth-процесса, зарегистрированный идентификатор клиента и точный адрес возврата. При несовпадении профиля обратитесь к оператору.
local_profile_requiredЗавершите обычный вход в главный кабинет тем же аккаунтом. Не создавайте дубликат аккаунта и не переносите Telegram между аккаунтами ради обхода ошибки.
Доступ отозван или недействителенПодключите клиент заново через штатный процесс авторизации и согласия.
Проект или действие недоступныПроверьте выбранный аккаунт, владение проектом, текущие права и функции подключённого сервера.
Неизвестен результат измененияСначала проверьте состояние исходной операции. Не повторяйте изменение автоматически.

Параметры для настройки клиента

Это параметры протокола, а не универсальный конфигурационный файл. Клиент использует discovery сервера авторизации для получения актуальных адресов авторизации и обмена кода.

ПараметрЗначение
MCP server / OAuth resourcehttps://api.copytrader.pw/mcp
ТранспортStreamable HTTP / HTTPS
OAuth flowAuthorization Code + PKCE S256
OAuth scopesmcp.access offline_access
Authorization serverhttps://auth.copytrader.pw/
Protected resource metadatahttps://api.copytrader.pw/.well-known/oauth-protected-resource/mcp
Информация о подключенииhttps://api.copytrader.pw/.well-known/copytrader-mcp-onboarding
Client ID / Redirect URIПрофиль, зарегистрированный оператором для вашего клиента; адрес возврата должен совпадать точно.

Обычный веб-вход, разрешение MCP и завершение обмена кодом — разные этапы. Пароли, OAuth-коды и токены обрабатываются штатными формами и OAuth-компонентом клиента, а не пересылаются модели в чат.

Пример профиля локального клиента

Действующая инструкция от 10 ноября 2026 года указывает публичный OAuth-клиент ниже. Используйте его, если ваше приложение совместимо с этим профилем и принимает указанный callback. Для другого адреса возврата оператор должен зарегистрировать соответствующий профиль.

Client ID
copytrader-mcp-local
Redirect URI
http://127.0.0.1:6276/oauth/callback
Client secret
Не требуется для этого публичного профиля.

Loopback callback принимает OAuth-компонент на машине клиента. Это не адрес API CopyTrader. Для другого callback нужен зарегистрированный оператором профиль; не меняйте адреса рабочего сервиса для обхода несовпадения.

С этим профилем 10 ноября 2026 года проверены вход и чтение данных через Codex. Ниже приведены настройки проверенного подключения. Для другого клиента или версии проверьте совместимость отдельно; отзыв и обновление доступа требуют отдельной проверки.

Настройка Codex

Добавьте подключение в настройки MCP Codex. Если редактируете config.toml, используйте этот блок; существующее подключение copytrader обновите, не создавая дубликат. Секрет клиента и токены в конфигурацию не добавляйте.

[mcp_servers.copytrader]
url = "https://api.copytrader.pw/mcp"
scopes = ["mcp.access", "offline_access"]

[mcp_servers.copytrader.oauth]
client_id = "copytrader-mcp-local"
callback_url = "http://127.0.0.1:6276/oauth/callback"
callback_port = 6276

Для входа используйте подключение CopyTrader в Codex или команду ниже. В режиме --no-browser откройте выданную ссылку сами, подтвердите подключение через Telegram и вставьте полный адрес возврата только в ожидающее окно Codex CLI. Не отправляйте адрес с OAuth-кодом в чат. После входа проверьте get_my_access и четыре начальных чтения из следующего раздела.

codex mcp login copytrader --no-browser

Для ChatGPT и Claude нужны параметры OAuth, поддерживаемые соответствующим приложением. Локальный callback Codex не подтверждает совместимость облачного клиента и не означает размещение в каталоге.

OAuth-клиент проверяет state и issuer, использует PKCE S256 и один resource, равный адресу MCP-сервера. Код, verifier и токены обрабатывает клиент и хранит вне переписки. При refresh он сохраняет новый refresh token, если сервер его заменил.

После подтверждения подключения в Telegram браузер сам продолжает OAuth. Успех подтверждается только после обмена кода и успешного get_my_access. Отдельное Telegram-согласие для каждой команды не требуется там, где его не требует кабинет.

Каталог инструментов и команд

После MCP initialize клиент получает tools/list и inputSchema каждого инструмента. Таблица описывает входы из действующей инструкции; фактический набор, параметры и включённые изменения определяет подключённый сервер. Не используйте внутренние API вместо недоступной команды.

ИнструментНазначение
get_my_accessПроверка действующего MCP-доступа и его границ.
get_mcp_capabilitiesВозможности сервера; отключённые изменения не обходятся другими вызовами.
get_main_cabinet_commands
get_copy_cabinet_commands
Актуальные каталоги Main и кабинета копирования, схемы параметров и правила операций.
list_projectsПоиск собственных проектов по названию с обработкой cursor. При нескольких совпадениях уточняется выбор.
main_cabinet_commandКоманды Main по commandId и parameters: профиль, проекты, состояние, домены, отчёты и справка. M13 ищет проекты; M45 читает справку.
copy_cabinet_commandКоманды выбранного проекта по projectId, commandId и parameters. C003/C004 находят локальные аккаунты; C034 управляет долей депозита, C044/C045 — доступными лимитами и просадкой; C062–C074 дают отчёты и журнал.
start_main_registration
get_main_registration_status
Подготовка регистрации и чтение её статуса, если инструменты объявлены. Пароль вводит человек в форме. completed вместе с profileReady=true подтверждает профиль; далее отдельно подключается MCP.
get_private_input_operations
create_private_input_request
get_private_input_status
cancel_private_input_request
Каталог доступных приватных форм, создание ссылки, чтение результата и отмена ещё не принятой отправки. Значения секретов не передаются в MCP.
create_project_bot_input_request
get_project_bot_input_status
cancel_project_bot_input_request
Приватная форма токена бота и статус черновика нового проекта. Сохранение черновика само по себе не создаёт проект, счёт или платёж.
create_main_password_input_request
get_main_password_input_status
cancel_main_password_input_request
Форма собственного пароля Main и чтение её результата, если инструменты объявлены. Успешная смена может завершить прежние сессии, включая MCP; последующий 401 не означает, что пароль не изменился.
get_operation_status
cancel_operation
request_operation_approval
Чтение и допустимая отмена операции по возвращённому operationId. Передача подготовленной операции на выполнение требует поручения пользователя; она не выполняется автоматически и не означает дополнительного Telegram-согласия.

Начните с четырёх чтений с пустыми аргументами: get_my_access, get_mcp_capabilities, get_main_cabinet_commands, get_copy_cabinet_commands. Затем найдите проект и аккаунт. Не выполняйте изменение ради проверки подключения.

C027–C029 управляют подписками внутри проекта. Смена трейдера и отписка могут затронуть открытые позиции: сначала пользователь выбирает действия отдельно для Spot и Futures и, если требуется, соглашается с системным автозакрытием. Постановка в очередь не доказывает исполнение на бирже.

MainSettings и чужие проекты не входят в клиентский доступ. Системная учётная запись admin доступна только для чтения: изменения, пароль, ключи и пакеты с ней отклоняются с protected_account. C046, C081, C084 и C107 также используются только для чтения; изменение прямого режима, межпроектная подписка и очистка истории через MCP исключены. Каталог не отменяет эти границы.

Приватные данные и подтверждение результата

Если сервер объявляет приватную форму, ассистент получает inputUrl и передаёт его вам в чат. Вы сами открываете форму и вводите пароль, код, биржевые ключи или токен. Не передавайте ссылку другим людям и не отправляйте значения полей ассистенту. Если форма недоступна, используются штатные страницы кабинета.

Для приватного ввода только completed / saved подтверждает сохранение. executing и outcome_unknown требуют уточнения исходного результата, а не автоматического повтора. Проверка ключей биржей и исполнение сделки — отдельные действия.

Клиент проверяет isError, structuredContent.error и вложенный результат data. После изменения нужно перечитать фактическое состояние. Успешный JSON-RPC ответ не доказывает исполнение сделки. Для пароля completed отражает сведения формы и сервиса: агент не получает новый пароль и не проверяет вход с ним.

Справка главного кабинета · Справка кабинета копирования

Публичная справка Main доступна через API help/tree, help/search и help/articles с product=main-cabinet и language=ru или en. Статьи кабинета копирования могут требовать входа: доступность дерева не означает публичность всех текстов.

Наверх