Интеграции

Вкладка Интеграции (в настройках, раздел Приложение) управляет двумя независимыми функциями на одном экране:

1. Сервер интеграций — локальный WebSocket: скрипты, сайты и приложения на вашем ПК могут управлять терминалом (открытие наборов инструментов, цвета линковки, уведомления, ping).
2. MCP-сервер — опциональный локальный HTTP (Model Context Protocol): совместимые ИИ-ассистенты вызывают инструменты только для чтения (котировки, стакан, свечи, данные скринера, funding и т.д.). Заявки через MCP не выставляются.

Синхронизация: флаг Разрешить внешние интеграции входит в обычную конфигурацию профиля и синхронизируется с аккаунтом. Включение MCP и bearer-токен хранятся только на этом устройстве (локальные данные приложения), в облако не отправляются.

---

Сервер интеграций

Нужен для интеграции через Public API по WebSocket: JSON-сообщения с полем method на ws://127.0.0.1:49152.

Возможности

• Открыть новый набор инструментов (open, open_aggregated) или сменить залинкованный символ для цвета (assign).
• Отправить уведомление (notify) и проверить связь (ping).

Полное описание контракта — Public API — обзор WebSocket, перечисления — Справочник (биржи, market_type, linking_type, формат символа).

Точка подключения

URL	ws://127.0.0.1:49152
Доступ	Только loopback; ProfitForge сам не выставляет порт в интернет.
Порт	По умолчанию 49152. Если порт занят при старте, приложение может один раз попытаться восстановить привязку; иначе сервер не поднимется — смотрите лог и освободите порт.

Как включить

1. Настройки → Приложение → Интеграции.
2. В блоке Сервер интеграций включите Разрешить внешние интеграции.

WebSocket-сервер работает, пока запущен ProfitForge и опция включена. Выключите, если подключаться никому не нужно.

Формат сообщений (кратко)

• Запрос: JSON с минимум "method": "<имя>", остальные поля зависят от метода.
• Успех: {"status":"ok"}
• Ошибка: {"status":"error","error_code":<number>,"message":"..."} — полный список кодов в Справочнике (1000–1008: неверный JSON, нет method, неизвестный метод, ошибки валидации, ошибки воркспейса и т.д.).

Методы (кратко)

Метод	Назначение
assign	Сменить залинкованный символ для цвета — не открывает новый набор сам по себе.
open	Открыть новый набор (одна биржа / символ); опционально linking_type как у вотч-листа.
open_aggregated	Сводный набор по одному дисплей-символу на нескольких биржах; опционально title / extra.title.
notify	Уведомление (title, message).
ping	Проверка связи.

assign и open: assign — когда нужно сменить символ в уже используемом слоте линковки; open / open_aggregated — чтобы создать новый набор. Это не обязательная цепочка из двух шагов.

---

MCP-сервер

Нужен, если MCP-клиент (ассистент в IDE, mcp-remote и т.д.) должен получать рыночный контекст через инструменты, а не через WebSocket API выше.

Связь с сервером интеграций

	Сервер интеграций	MCP-сервер
Транспорт	WebSocket	HTTP (Streamable MCP, путь /mcp)
Типичное использование	Ваш код управляет UI терминала	Агент запрашивает данные (read-only tools)
Переключатель	Разрешить внешние интеграции	Разрешить локальный MCP-сервер
Авторизация	(достаточно localhost)	Обязательно Authorization: Bearer <токен>

Переключатели независимы — можно включить что угодно по отдельности.

Как включить (настройки)

1. Приложение → Интеграции → Локальный MCP-сервер → Разрешить локальный MCP-сервер.
2. Скопируйте URL MCP (фиксировано: http://127.0.0.1:17890/mcp). Лучше 127.0.0.1, не localhost, если клиент уходит в IPv6-only.
3. Полный секрет — кнопка «Копировать токен»; в поле только маска.
4. «Новый токен» — ротация; обновите всех клиентов сразу.

Русский интерфейс

English UI

Документация по протоколу

Подробно: MCP-сервер (Public API).