CopyTrader · MCP

Як підключити ІІ-асистента до CopyTrader через MCP

Підготуйте сумісний ІІ-клієнт, увійдіть у CopyTrader і перевірте доступ до своїх проєктів. Ця інструкція пояснює кожен етап підключення та відкликання доступу.

Перейти до кроків підключення Огляд MCP-інтеграції

Що знадобиться

Обліковий запис CopyTrader

Використовуйте існуючий обліковий запис або завершіть реєстрацію через штатні форми. Ваші проєкти та права визначає CopyTrader.

Сумісний ІІ-клієнт

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

Ідентифікатор OAuth-клієнта та точна адреса повернення мають бути зареєстровані у оператора CopyTrader для вашого додатка. Однієї адреси сервера може бути недостатньо. Якщо профіль не налаштовано, спершу погодьте його з оператором.

Підключення по кроках

Підготуйте аккаунт
Увійдіть у існуючий обліковий запис CopyTrader. Новому користувачу потрібно завершити реєстрацію і штатні підтвердження. Реєстрація і підключення MCP — окремі етапи.
Налаштуйте підключення в ІІ-клієнті
Відкрийте налаштування інтеграцій клієнта. Виберіть зареєстрований для нього OAuth-профіль і вкажіть адресу MCP-сервера нижче. Назви полів залежать від додатка.
Почніть авторизацію
Почніть підключення засобами клієнта і відкрийте сформоване ним посилання CopyTrader. Введіть дані і виконайте штатні перевірки лише на спеціальній для цього сторінці входу.
Підтвердіть доступ
Ознайомтеся з областю доступу і підтвердіть підключення в діючому процесі згоди, включно з Telegram. Після підтвердження сторінка продовжить авторизацію. Чекайте завершення підключення в клієнті.
Перевірте підключення
Попросіть асистента перевірити доступ і показати ваші проєкти. Успішний вхід у веб-кабінет або відкрита сторінка повернення самі по собі ще не підтверджують роботу MCP.
Почніть з читання
Виберіть проєкт і запросіть його стан або статистику. Для зміни налаштувань дайте окреме завдання з конкретними параметрами. Зберігаються передбачені продуктом підтвердження.

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

Увійти в CopyTrader Створити акаунт

Як переконатися, що MCP працює

Почніть із запиту, який лише читає дані:

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

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

Для технічної перевірки клієнт використовує get_my_access, get_mcp_capabilities і list_projects. Облікові дані обробляє OAuth-компонент клієнта і зберігає у його захищеному сховищі.

Які дозволи ви надаєте

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

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

Копіювання угод пов’язане з ризиком втрат. Підключення ІІ не гарантує прибутковість або однакові результати на різних облікових записах.

Як відкликати доступ

Увійдіть у кабінет CopyTrader і відкрийте розділ підключень агентів.
Виберіть потрібне підключення і підтвердіть відкликання доступу.
Для повторного підключення знову виконайте авторизацію і згоду через ІІ-клієнт.

Відкрити підключення агентів Політика конфіденційності Умови використання

Якщо підключення не працює

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

Параметри для налаштування клієнта

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

Параметр	Значення
MCP server / OAuth resource	`https://api.copytrader.pw/mcp`
Транспорт	Streamable HTTP / HTTPS
OAuth flow	Authorization Code + PKCE S256
OAuth scopes	`mcp.access offline_access`
Authorization server	`https://auth.copytrader.pw/`
Protected resource metadata	`https://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. Статті кабінету копіювання можуть вимагати входу: доступність дерева не означає публічність усіх текстів.