MCP-сервер
MCP-сервер — отдельный локальный HTTP-интерфейс (не WebSocket Public API): точка Model Context Protocol, через которую MCP-клиенты вызывают инструменты только для чтения (котировки, стакан, свечи, метрики скринера, funding и т.п.). Заявки не выставляются.
Управление терминалом по JSON-методам — в Public API (внешние интеграции). Где включать в приложении и чем это отличается от сервера интеграций — Интеграции.
Точка доступа
| Streamable HTTP (основной вариант) | http://127.0.0.1:17890/mcp |
| Хост / порт | Фиксированно 127.0.0.1 и 17890 (пользователь не задаёт). |
| Доступ | Только loopback. |
По возможности используйте 127.0.0.1, а не localhost, если клиент резолвит localhost в IPv6 (::1), а слушатель только на IPv4.
Отдельные клиенты поддерживают legacy SSE на том же хосте (например http://127.0.0.1:17890/mcp/sse) с особыми флагами — ориентируйтесь на Streamable HTTP, если клиент не требует SSE.
Включение в ProfitForge
- Приложение → Интеграции → Локальный MCP-сервер.
- Разрешить локальный MCP-сервер. При первом включении при необходимости создаётся bearer-токен.
- Копировать URL и Копировать токен. В поле отображается маска; для клиента нужен полный токен с кнопки.
- Новый токен отключает старых клиентов — обновите их конфиг сразу.

Настройки MCP (флаг + токен) хранятся только локально на этом ПК, в аккаунт не уезжают.
Авторизация
Каждый запрос (кроме CORS OPTIONS) должен содержать:
Authorization: Bearer <ваш-токен>Один пробел после Bearer. Токен чувствителен к регистру и символам.
Неверный или отсутствующий токен → 401 Unauthorized.
Инструменты
Инструменты отдают только чтение из тех же источников, что использует терминал. Типичные области:
- Котировки — цены по бирже + рынку + символу.
- Стакан — глубина / лента заявок где поддерживается.
- Свечи — OHLC по таймфрейму.
- Скринер / контекст — плотности и связанные снимки (по реализации).
- Funding — ставки и время где есть интеграция.
Точные имена инструментов, параметры и JSON смотрите в сессии MCP (инспектор клиента, список по протоколу). Ни один инструмент не отправляет заявки от вашего имени.
Браузер и CORS
Инспекторы шлют OPTIONS без Authorization. Сервер отвечает 204 и CORS-заголовками для пути /mcp. Реальные GET/POST по-прежнему требуют bearer-токен.
Клиенты
Пример конфигурации для Claude Desktop
Для интеграции обязательно должен быть установлен Node.js
{
"mcpServers": {
"profitforge": {
"command": "C:\\Program Files\\nodejs\\npx.cmd",
"args": [
"-y",
"mcp-remote@latest",
"http://127.0.0.1:17890/mcp/sse",
"--header",
"Authorization:${PROFITFORGE_MCP_AUTH}",
"--allow-http",
"--transport",
"sse-only"
],
"env": {
"PROFITFORGE_MCP_AUTH": "Bearer sDKPyJS0vAFfAm+scr/BRQL+pFB33UveGecR9TCVvGM="
}
}
},
"preferences": {
"coworkWebSearchEnabled": true,
"coworkScheduledTasksEnabled": false,
"ccdScheduledTasksEnabled": false
}
}Неполадки
| Симптом | Что проверить |
|---|---|
| 401 | Токен, формат Bearer + значение; после Новый токен обновите клиент. |
| Connection refused | ProfitForge не запущен или выключен MCP. |
| 406 / Accept | Streamable HTTP ожидает корректный Accept (JSON + event-stream); узкие заголовки у мостов могут ломать запрос. |
| Таймаут / -32001 | Часто неверная точка входа моста (client.js vs proxy.js) или транспорт; сверьтесь с документацией клиента. |
См. также
- Public API — WebSocket для внешних интеграций (порт 49152).
- Интеграции (настройки) — оба переключателя на одном экране.