Как настроить MCP-сервер от Capital.com

Убедитесь	Да	Нет
У вас есть аккаунт Capital.com?	Продолжайте	Зарегистрироваться
Вы установили предпочитаемого ИИ-помощника?	Продолжайте	Рекомендации:  Claude Code,  Claude Desktop,  Codex,  Cursor,  Windsurf.
У вас Mac или Windows?	Продолжайте	Мобильные устройства пока что не поддерживаются.

Claude Desktop: быстрая справка по настройке

Если вам не нужны подробные инструкции, вот краткая версия для чатбота Claude на ПК.

1. Получите свои учётные данные для API 

• Перейдите в Настройки аккаунта Capital.com и получите пароль для API.

2. Загрузите MCP с Github

• URL-сайта: https://github.com/capital-com-sv/capital-mcp 

3. Откройте пакет MCPB

• Дважды нажмите по пакету, чтобы запустить его, либо просто перетащите файл в окно вашего Claude Desktop.

4. Введите учётные данные вашего API

• Claude Desktop запросит ваши данные API. Введите их и нажмите «Install» (Установить). Не забудьте включить MCP.

5. Перезагрузите Claude

• Полностью закройте и снова запустите приложение, а затем протестируйте ссылку, выполнив запрос: «List my accounts» (Показать мои счета).

Полное руководство по настройке 

Шаг 1. Создайте учётные данные для API

Внутри вашего аккаунта Capital.com:

1. Включите 2FA, если еще этого не сделали. Настройки → Двухфакторная аутентификация.
2. Сгенерируйте новый ключ API. Настройки → API-интеграции → Сгенерировать новый ключ.
3. Задайте вашему ключу название. Например, MCP-сервер.
4. Настройте пароль для вашего API.

Прочитайте это, прежде чем что-либо вводить: вы создаете совершенно новый пароль, специально для доступа к API. Он не связан с вашим паролем для входа в аккаунт Capital.com. Лучше придумать что-то такое, что вы сможете запомнить, а также записать его. Не используйте для этих целей свой пароль для входа в аккаунт. Это частая ошибка при настройке, когда путают пароли от API и аккаунта.

5. Введите 2FA-код и нажмите «Generate» (Сгенерировать).
6. Скопируйте свой API-ключ и еще раз подтвердите свой API-пароль. Оба будут показаны лишь один раз. Вам они понадобятся позже. После закрытия этого окна они исчезнут. 

Никому их не сообщайте. Не делитесь ими, не вставляйте их в чаты и не храните их в общедоступных документах. Любой, у кого есть эти данные, сможет получить доступ к вашему торговому аккаунту через API.

 

Шаг 2. Загрузите MCP

MCP-сервер Capital.com распространяется с открытым исходным кодом и хранится в публичном репозитории GitHub. Прежде чем ваш ИИ-помощник сможет его использовать, вам нужно загрузить копию кода на ПК.

Скачайте код MCP на ваш локальный компьютер с https://github.com/capital-com-sv/capital-mcp

 

Шаг 3. Подключите MCP к вашему ИИ-помощнику

Каждый ИИ-помощник подключается к MCP немного по-разному. Здесь мы объяснили, как подключиться к Claude Desktop, но для подключения к другим платформам воспользуйтесь этим материалом. 

Дважды нажмите по пакету, чтобы запустить его, либо просто перетащите mcpb-файл в окно вашего Claude Desktop.

В приложении Claude Desktop у вас появится следующее всплывающее окно. Установите MCP и включите его.

Шаг 4. Введите свои учетные данные и настройте среду

Введите свои учетные данные, которые получили на Шаге 1, в соответствующие поля настроек

Шаг 5. Перезапустите вашего ИИ-помощника и проверьте подключение

Перезапустите вашего ИИ-помощника и попробуйте следующие запросы по отдельности. Это позволит понять, работает ли подключение

Login to my Capital.com account (Авторизация в аккаунт Capital.com)

List my accounts (Вывод списка аккаунтов)

Search for bitcoin markets (Поиск Биткоин-рынков)

 

Как разместить сделку

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

1. Предпросмотр

Попросите вашего ИИ-помощника просмотреть сделку.

Preview buying 1.5 with stop at 24.50 (Предпросмотр покупки 1,5 СЕРЕБРА со стоп-ордером на уровне 24,50)

Помощник возвращает полное предложение по сделке и уникальный preview_id. Изучите каждую деталь, прежде чем продолжить.

2. Обзор

Перед подтверждением проверьте:

• Инструмент правильный? (Коды чувствительны к регистру: SILVER и silver – это не одно и то же)
• Размер позиции соответствует вашим намерениям?
• Правильно ли установлены уровни стоп-лосса и лимита?
• Соответствует ли этот уровень риска размеру вашего аккаунта?

Если что-то окажется неправильным, остановитесь. Попросите предоставить новый предпросмотр с исправленными параметрами.

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

Отправляйте этот запрос только в том случае, если вас устраивает предпросмотр:

Execute position with preview_id abc123 confirm=true (Исполни позицию с preview_id abc123 confirm=true)

Сделка не может быть размещена без действительного preview_id. Каждый ID можно использовать лишь раз, и его срок действия истекает после исполнения.

 

Перед тем, как переходить на реальный аккаунт

Сначала перепроверьте всё по списку:

• Все 3 тестовых запроса на 5 этапе вернули корректные данные.
• Вы успешно проверили и подтвердили как минимум одну сделку в демо-режиме.
• Вы понимаете, что означает каждое поле в предпросмотре сделки
• Вы изменили CAP_ENV на live и CAP_ALLOW_TRADING на true намеренно.
• Вы прочитали Условия и положения Capital.com и Условия электронных торгов.

Чтобы ограничить, на каких рынках сервер может торговать, добавьте список кодов инструментов в CAP_ALLOWED_EPICS (например: SILVER,GOLD,EURUSD). Оставьте это поле пустым, чтобы разрешить доступ ко всем рынкам на вашем аккаунте.

 

Что можно спрашивать у ИИ-помощника?

Проверка аккаунта

Login to my account (Вход в аккаунт)

List my accounts (Вывод списка аккаунтов)

Check my Capital.com connection health (Проверка состояния моего подключения с Capital.com)

Исследование рынков

Search for bitcoin markets (Поиск Биткоин-рынков)

Show me EURUSD market details (Показать информацию о рынке EURUSD)

Get 1-hour historical prices for GOLD (Получить историю цены за последний час для GOLD) 

Просмотр портфеля

Show my open positions (Просмотр открытых позиций)

List my working orders (Список ваших рабочих ордеров)

Review my portfolio exposure (Посмотреть размер позиций в Портфеле)

Совершение сделки (сначала в демо-режиме)

Preview buying 1.5 SILVER with stop at 24.50 (Предпросмотр покупки 1,5 СЕРЕБРА со стоп-ордером на уровне 24,50)

Create a trade proposal for GOLD with 1% risk (Создать торговое предложение для ЗОЛОТА с риском 1%)

Execute position with preview_id abc123 confirm=true (Исполнить позицию с preview_id abc123 confirm=true)

Close position DEAL_ID confirm=true (Закрыть позицию DEAL_ID confirm=true)

 

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

Сначала выполните проверку состояния. Попросите вашего ИИ-помощника: «Check my Capital.com connection health» (Проверь состояние моего подключения с Capital.com). Как правило, ответ даст понять, если что-то не так.

Все еще не получается? Отправьте запрос в Поддержку и укажите: какого ИИ-помощника вы используете, вашу операционную систему и полное сообщение об ошибке.

 

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

Нужна ли мне платная подписка на ИИ-помощника? Для использования функций MCP в некоторых ИИ-помощниках требуется платная подписка. Например, для работы с Claude Desktop требуется платная подписка для активации коннекторов MCP. Сам по себе MCP-сервер Capital.com бесплатный. 

Нужен ли мне реальный торговый аккаунт? Нет. Сервер работает с демо-аккаунтом, и именно с него мы рекомендуем вам начать. 

Мой пароль для входа в Capital.com совпадает с CAP_API_PASSWORD? Нет. Это отдельные системы с разными паролями. CAP_API_PASSWORD – это новый пароль, который вы специально создаете при генерации вашего API-ключа. Использование вашего пароля для входа в этом поле приведёт к сбою аутентификации.

Может ли ИИ совершить сделку без моего ведома? Нет. Каждая сделка требует предварительного шага, за которым следует отдельное сообщение подтверждения, содержащее confirm=true. Сервер не может исполнить сделку без обоих этих шагов. ID предпросмотра одноразовый и истекает немедленно после исполнения.

Что за переменная CAP_ALLOW_TRADING и следует ли мне ее менять? Это тумблер с предохранителем. Если для этого параметра установлено значение false, сервер может отображать рыночные данные и информацию об аккаунте, но не может совершать сделки. Меняйте значение на true только после того, как вы протестировали всё в демо-режиме и готовы торговать на реальные деньги.

Какова функция переменной CAP_ALLOWED_EPICS? Она ограничивает, какими инструментами сервер может торговать. Оставьте это поле пустым, чтобы разрешить доступ ко всем рынкам на вашем аккаунте. Чтобы ограничить доступ, добавьте список, разделённый запятыми (например: SILVER,GOLD,EURUSD).

Я вижу менее 36 инструментов в моем ИИ-помощнике. Что не так? Спросите вашего ИИ-помощника: «Check my Capital.com connection health» (Проверь состояние моего подключения с Capital.com). Наиболее распространёнными причинами являются ошибка форматирования в конфигурационном JSON-файле или то, что путь к Python указывает на системную директорию Python, а не на папку venv.

Мои торговые данные в безопасности? Сервер работает локально на вашем компьютере. Ваши учетные данные хранятся исключительно в локальном файле настроек и никогда не передаются третьим лицам. Вся коммуникация с Capital.com использует шифрование HTTPS.

Могу ли я использовать сервер на двух компьютерах? Да. Повторите Шаг 2 на втором устройстве, используя те же учётные данные API из Шага 1.

Могу ли я подключиться к более чем одному аккаунту Capital.com?  Сервер подключается к одному аккаунту за раз. Чтобы переключиться, обновите 4 значения CAP_ в вашем конфигурационном файле и перезапустите ИИ-помощника.

 

Отказ от ответственности: использование публичного API Capital.com с инструментами третьих сторон

Интеграция сторонних приложений

На этой странице рассказывается, как клиенты могут подключить публичный API к стороннему ПО, инструментам или интеграционным решениям, в том числе к тем, которые работают на основе ИИ или крупных языковых моделей («LLM»). Любое подобное ПО, инструмент или интеграция сторонних разработчиков не связаны с и не являются частью услуг Capital.com. Capital.com не контролирует, не разрабатывает, не одобряет и не несет никакой ответственности за ПО третьих сторон, его работоспособность, результаты работы или любые последствия, возникающие в результате его использования. Любое использование сторонних инструментов или интеграций в связке с публичным API осуществляется исключительно на ваш собственный риск. Вы сами несете ответственность за ознакомление с условиями использования, политикой конфиденциальности и порядком обработки данных при взаимодействии с любым сторонним инструментом, который вы решили использовать.

Использование публичного API

Использование публичного API осуществляется исключительно на ваш собственный риск и усмотрение. Capital.com предоставляет доступ к публичному API в информационных и торговых целях, однако не рекомендует, не одобряет и не поощряет какое-либо конкретное использование, интеграцию или торговую стратегию. Вы несете полную ответственность за то, как получаете доступ к API и используете его, включая параметры отправляемых запросов, настройки подключенных инструментов или систем, а также интерпретацию получаемых данных. Capital.com не несет ответственности за убытки или непредвиденные последствия, возникшие в результате использования вами API, независимо от того, осуществлялся ли доступ к нему напрямую или через сторонние инструменты. Доступность, функциональные возможности и технические характеристики API могут быть изменены, ограничены по скорости, приостановлены или прекращены в любое время без предварительного уведомления. Использование вами публичного API регулируется Условиями использования и Условиями электронной торговли Capital.com, с которыми вам следует внимательно ознакомиться перед тем, как взаимодействовать с API.

Исключительно исполнение заявок без предоставления инвестиционных рекомендаций

Capital.com предоставляет свои услуги только в качестве исполнителя. Торговля финансовыми инструментами связана с значительным риском потерь. Ничто на этой странице, в публичном API, а также в любом стороннем ПО или интеграционных решениях не является инвестиционной консультацией, личной рекомендацией или призывом к покупке или продаже каких-либо финансовых инструментов. Сюда относятся любые результаты, сигналы, рекомендации или аналитические данные, сгенерированные ИИ, на основе больших языковых моделей (LLM) или другими автоматизированными инструментами. Все торговые решения, включая любые автоматические или алгоритмические операции, принимаются на ваш собственный риск и остаются исключительно в вашей ответственности.

Риски автоматизированной и алгоритмической торговли

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

Недопустимое использование

Публичный API и любые связанные с ним инструменты не должны использоваться с целью манипулирования платформой, злоупотребления ценовыми колебаниями или задержками, совершения рыночных злоупотреблений или получения какого-либо неправомерного преимущества. Capital.com оставляет за собой право ограничить, приостановить или прекратить доступ к API и/или к вашему аккаунту, если у компании возникнут обоснованные подозрения в том, что имело место или может иметь место неправомерное использование. Клиенты не должны допускать каким-либо третьим лицам контролировать свой аккаунт.

Ваши обязанности

Вы несете ответственность за то, чтобы использование вами платформы, публичного API, а также любых сторонних инструментов или интеграций соответствовало Условиям использования Capital.com, а также всем применимым законам и нормативным актам вашей юрисдикции. Прежде чем использовать инструменты автоматической торговли, вам следует тщательно оценить, насколько они подходят для вашей конкретной ситуации, уровня опыта и толерантности к риску. Capital.com настоятельно рекомендует тщательно протестировать любые автоматизированные инструменты или интеграции с помощью демо-аккаунта, прежде чем подключать их к реальной торговой среде.