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

MCP-сервер от Capital.com позволяет подключить ИИ-ассистента – например, Claude Code, Codex, Claude Desktop, Cursor или Windsurf – к вашему торговому аккаунту. После настройки вы сможете использовать естественный язык для анализа рынков, проверки информации по аккаунту, просмотра открытых позиций и действующих ордеров, а также для предварительного просмотра и размещения сделок с помощью своего ИИ-помощника.

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

Что такое MCP-сервер Capital.com?

MCP-сервер (Протокол контекста модели) Capital.com – это бесплатный инструмент с открытым исходным кодом, который позволяет вам подключить ИИ-помощника к вашему торговому аккаунту, используя ваши учётные данные API Capital.com и двухфакторную аутентификацию (2FA). Он служит связующим звеном между вашим аккаунтом и ИИ, благодаря чему помощник может получать доступ к рыночным данным и информации по аккаунту, а также реагировать на ваши указания в реальном времени.

После подключения ваш ИИ-помощник сможет:

• Искать доступные рынки (такие как форекс, акции, товары и индексы).
• Отображать ваши открытые позиции, текущие ордеры и информацию об аккаунте.
• Получать историю цены и данные о настроениях клиентов.
• Давать предпросмотр и исполнять сделки, с вашим явным подтверждением перед исполнением.

Вы полностью несете ответственность за любые торговые решения, принятые с использованием MCP-сервера. Всегда внимательно просматривайте предпросмотр сделки перед подтверждением.

Каких ИИ-помощников можно использовать?

Этот гайд охватывает настройку для Claude Code, Codex, Claude Desktop, Cursor и Windsurf.

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

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

Сначала создайте учетные данные для API в своем аккаунте Capital.com. Это зацмет пару минут.

1. Войдите в свой аккаунт Capital.com.
2. Включите двухфакторную аутентификацию (2FA).
3. Перейдите в Настройки → API Интеграции → Сгенерировать новый ключ.
4. Задайте вашему ключу ярлык. Например: MCP Server.
5. Создайте пароль пользователя API. Он будет использовать отдельно от вашего обычного пароля для входа в Capital.com.
6. Введите 2FA-код и сгенерируйте ключ.
7. Сразу же скопируйте ключ API. Посмотреть его второй раз не получится.

На следующих этапах вам понадобятся следующие значения:

*Попрактикуйтесь на демо-аккаунте перед тем, как переключиться на реальный аккаунт.

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

Шаг 2. Установите MCP-сервер Capital.com

Это нужно сделать один раз. У вас есть два варианта – вариант A предпочтительный для большинства пользователей.

Вариант A. Быстрая установка (рекомендуем)

MCP-сервер включает в себя файл пакета, который позволяет Claude Desktop выполнить установку за вас – вам не потребуется взаимодействовать с Терминалом или редактировать конфигурационные файлы.

Перед тем как начать: убедитесь, что у вас установлен uv (например, через brew install uv на Mac) и что у вас установлен Node.js для команды pack.

1. В Терминале клонируйте репозиторий и соберите пакет:

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

npx @anthropic-ai/mcpb pack . capital-mcp.mcpb

2. Откройте capital-mcp.mcpb, дважды кликнув по нему, либо перетащите его в окно Claude Desktop.
3. Claude Desktop запросит у вас ваши учетные данные API. Введите их, затем нажмите «Установить».
4. Перезапустите Claude Desktop и проверьте соединение, спросив: 'Какие инструменты Capital.com доступны?'

Вариант Б. Ручная установка

Используйте этот вариант, если вы предпочитаете не использовать пакет, или если подключаетесь через Codex, Cursor или Windsurf.

Терминал (Mac)

1. Загрузите файлы сервера

cd ~/Desktop

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

2. Создайте изолированную среду Python и установите зависимости

python3 -m venv venv

source venv/bin/activate

pip install -e ".[dev]"

3. Найдите свой путь к Python

Вам это понадобится на следующем шаге:

which python

В результате у вас получится путь к файлу примерно следующего вида:

/Users/you/Desktop/capital-mcp/venv/bin/python

Скопируйте и сохраните этот путь. Его нужно будет вставить в настройки вашего ИИ-помощника в Шаге 3.

Совет: на Mac вы можете перетащить файл из Finder в окно Терминала, чтобы показать его полный путь.

4. Убедитесь, что сервер запускается правильно

python -m capital_mcp.server

Если ошибок нет, значит установка завершена. Если вы видите ошибку, исправьте её сейчас – сообщения об ошибках обычно легче диагностировать на этом этапе, чем в интерфейсе ИИ-помощника.

Командная строка (Windows)

1. Загрузите файлы сервера

cd %USERPROFILE%\Desktop

git clone  https://github.com/capital-com-sv/capital-mcp

cd capital.com-public-api-mcp

Этот пакет загружает репозиторий на ваш рабочий стол и открывает папку проекта.

2. Создайте изолированную среду Python и установите зависимости

py -m venv venv

venv\Scripts\activate.bat

pip install -e ".[dev]"

Это создаст виртуальную среду, чтобы держать зависимости проекта отдельно от остальной части вашей системы. Его активация гарантирует, что пакеты будут установлены в этой среде.

3. Найдите свой путь к Python

Вам это понадобится на следующем шаге:

where python

Вы должны увидеть что-то вроде:

C:\Users\you\Desktop\capital.com-public-api-mcp\venv\Scripts\python.exe

Скопируйте и сохраните этот путь. Его нужно будет вставить в настройки вашего ИИ-помощника на Шаге 3.

4. Убедитесь, что сервер запускается правильно

python -m capital_mcp.server

Если ошибок нет, значит установка завершена. Если вы видите ошибку, исправьте её сейчас, прежде чем продолжить.

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

Все три ИИ-помощника нуждаются в одной и той же ключевой информации. Перед тем, как начать, подготовьте следующее:

Настройка Claude Code 

В вашем терминале выполните команду:

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

Замените /path/to/capital-mcp/venv/bin/python на путь к Python, который вы скопировали на Шаге 2.

Чтобы подтвердить соединение, спросите Claude: 'Какие инструменты Capital.com доступны?' Вы должны увидеть список из 36 инструментов.

Настройка Codex 

Перейдите к Codex → Настройки → Серверы MCP → Добавить Сервер и заполните поля ниже.

Команда

Вставьте путь к вашему venv Python. Например:

/Users/you/Desktop/capital.com-public-api-mcp/venv/bin/python

Аргументы

Добавьте их как две отдельные записи – не объединяйте их:

1. -m
2. capital_mcp.server

Переменные окружения

Добавьте каждую переменную по отдельности:

Рабочая директория

Установите рабочую директорию на ~/code.

Сохраните свои настройки и перезапустите Codex.

Введите /mcp в чате – вы должны увидеть capital-com в списке.

Чтобы подтвердить соединение, отправьте эти три сообщения:

Check my Capital.com session status (Проверить статус моей сессии Capital.com)

Login to my Capital.com account (Войти в мой аккаунт Capital.com)

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

Если все три вернут корректные ответы, значит сервер подключен правильно.

Настройка Claude Desktop

Терминал (Mac)

Откройте терминал и выполните следующие команды для создания файла конфигурации:

mkdir -p ~/Library/Application\ Support/Claude

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Командная строка (Windows)

Откройте командную строку (CMD) и выполните команду:

mkdir "%APPDATA%\Claude"

notepad "%APPDATA%\Claude\claude_desktop_config.json"

Терминал (Mac) и Командная строка (Windows)

Вставьте нижеприведенный шаблон в файл и замените все ЗАГЛУШКИ КАПСОМ на ваши фактические значения:

{

  "mcpServers": {

"capital-com": {

   "command": "/PASTE/YOUR/VENV/PYTHON/PATH",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "PASTE_API_KEY",

     "CAP_IDENTIFIER": "PASTE_YOUR_EMAIL",

     "CAP_API_PASSWORD": "PASTE_API_PASSWORD",

     "CAP_ALLOW_TRADING": "false",

     "CAP_ALLOWED_EPICS": ""

   }

    }

  }

}

Сохраните файл: нажмите Ctrl + O, затем Enter, затем Ctrl + X. Перезагрузите Claude Desktop.

Чтобы подтвердить соединение, спросите Claude: 'Какие инструменты Capital.com доступны?' Вы должны увидеть список из 36 инструментов.

Вы должны увидеть список из 36 инструментов. Если инструментов окажется меньше, попробуйте раздел устранения неполадок ниже.

Настройка Cursor

Перейдите в Настройки → Инструменты и MCP и добавьте:

{

  "capital-com": {

"command": "/path/to/venv/bin/python",

"args": ["-m", "capital_mcp.server"],

"env": {

   "CAP_ENV": "demo",

   "CAP_API_KEY": "your_api_key",

   "CAP_IDENTIFIER": "your_email",

   "CAP_API_PASSWORD": "your_password",

   "CAP_ALLOW_TRADING": "false"

}

  }

}

Перезапустите Cursor и проверьте соединение при помощи:

List my accounts (Список моих аккаунтов)

Если команда возвращает информацию о вашем аккаунте, значит интеграция работает как ожидалось.

Настройка Windsurf

Создайте или отредактируйте файл по адресу ~/.windsurf/mcp/servers.json и добавьте:

{

  "mcpServers": {

"capital-com": {

   "command": "/path/to/capital-mcp/venv/bin/python",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "your_api_key_here",

     "CAP_IDENTIFIER": "your_email@example.com",

     "CAP_API_PASSWORD": "your_custom_password"

     "CAP_ALLOW_TRADING": "false"

   }

    }

  }

}

Замените все заглушки на ваши реальные учетные данные из шага 1.

Перезапустите Windsurf и проверьте соединение при помощи команды ‘List my accounts’.

Как торговать посредством MCP-сервера

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

Шаг 1 – Предварительно оцените вашу сделку

Попросите вашего ИИ-помощника просмотреть сделку. Этот запрос вернет предложение и уникальный preview_id.

Пример: 

Предпросмотр покупки 1,5 [instrument] со стопом на 24,50

Шаг 2 – Просмотрите предложение

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

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

Шаг 3 – Подтвердите исполнение

Если вы хотите продолжить, отправьте второе сообщение для подтверждения:

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

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

ID каждого предпросмотра может использоваться лишь раз. После того, как сделка подтверждена и исполнена, действие предпросмотра сразу же истекает. Чтобы разместить другую сделку, создайте новый предпросмотр.

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

Подтвердите все нижеприведенные пункты:

• Все тестирования в демо-режиме проведены (CAP_ENV = demo).
• CAP_ALLOW_TRADING был выставлен на false на протяжении всей настройки.
• Вход в сессию, список аккаунтов и рыночные данные работают корректно
• Полный пред просмотр и поток исполнения успешно протестированы в демо-аккаунте.
• Вы сознательно решили переключить CAP_ENV на live и CAP_ALLOW_TRADING на true.

Чтобы ограничить, на каких рынках сервер может торговать, добавьте список кодов инструментов, разделённых запятыми, в CAP_ALLOWED_EPICS. Оставьте это поле пустым, чтобы разрешить доступ ко всем доступным рынкам на вашем аккаунте.

Устранение неполадок: распространённые ошибки и их исправления {#errors}

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

После подключения вы можете начать с некоторых примеров подсказок:

Check your account (Проверка аккаунта)

Check my session status (Проверка статуса сессии)

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

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

Research markets (Исследование рынков)

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

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

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

What is client sentiment on [instrument]? (Каково настроение клиентов о...)

Review your portfolio (Просмотр портфеля)

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

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

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

Place a trade (Разместить сделку – сначала попрактикуйтесь в демо-режиме)

Create a trade proposal for [instrument] with 1% risk (Создать торговое предложение для ... с риском 1%)

Preview buying 1.5 [instrument] with stop at 24.50 (Предпросмотр покупки 1,5 ... со стопом на 24,50)

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

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

Коды инструментов чувствительны к регистру. Используйте заглавные буквы для эпиков (например, SILVER, а не silver), чтобы избежать ошибок.

Всегда внимательно просматривайте предпросмотр сделки перед подтверждением. Сгенерированные ИИ выходные данные являются вспомогательными инструментами для вашего анализа. Они не заменяют ваши рассуждения и не устраняют риски, связанные с торговлей CFD.

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

Мне нужен реальный аккаунт Capital.com, чтобы использовать MCP-сервер?

Нет. MCP-сервер работает и с демо-аккаунтом. Вам может понадобиться настроить и протестировать в демо-режиме перед тем, как вы сможете подключиться к реальному аккаунту.

Мой пароль для входа в Capital.com такой же, как CAP_API_PASSWORD?

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

Может ли ИИ совершить сделку без моего разрешения?

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

Что такое CAP_ALLOW_TRADING и следует ли мне ее включить?

CAP_ALLOW_TRADING – это настройка, которая контролирует, может ли сервер исполнять сделки. Держите ее на false в процессе настройки и тестирования. Измените ее на true только после того, как вы полностью проверите соединение в демо-режиме и поймете риски реальной торговли CFD.

Что делает CAP_ALLOWED_EPICS?

Она ограничивает сервер в торговле конкретными инструментами. Если вы оставите настройку пустой, то будут доступны все рынки с вашего аккаунта. Добавьте список кодов эпиков инструментов, разделённых запятыми, чтобы ограничить торговлю только отдельными инструментами.

Я всё настроил(а), но Claude показывает менее 36 инструментов. Что не так?

Сервер запускается некорректно Запустите tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log, чтобы просмотреть логи журнала. Среди частых причин – ошибка JSON-синтаксиса в файле конфигурации или путь Python, который ведет на Python в вашей системе вместо виртуальной среды.

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

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

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

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

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

Только исполнение услуг и отсутствие инвестиционных советов

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

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

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

Неправомерное использование

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

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

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