Barfinex через MCP для AI-инструментов

Как подключать AI-ассистентов к авторизованным операциям Provider без публикации приватной runtime-конфигурации.

Что такое Provider MCP?

Provider MCP отдает авторизованные REST-операции Barfinex Provider как структурированные инструменты для AI-ассистентов в приватной runtime-среде. Аккаунты, ордера, replay, EventSink и operator tools в публичном контенте должны описываться как приватные возможности, а не как публичные API сайта.

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

Модель инструментов

Базовые инструменты доступны всегда:

provider_health - проверка доступности Provider;
provider_openapi - получение текущего OpenAPI документа;
provider_refresh_openapi_tools - пересборка динамических инструментов;
provider_request - fallback для документированных Provider-запросов.

Динамические инструменты строятся из OpenAPI операций. Имена, параметры и методы зависят от текущего Provider API.

Конфигурация

В MCP-клиенте или локальном runtime нужно настроить:

базовый URL Provider API;
bearer token, выпущенный Provider, в secret-хранилище клиента;
при необходимости timeout и локальные TLS-настройки для разработки.

Не публикуйте токены, локальные имена секретов и приватную конфигурацию workspace в публичных документах, скриншотах или общих промптах.

Аутентификация

Защищенные маршруты Provider требуют токен, выпущенный Provider. Передавайте его через secret-механизм MCP-клиента или через per-call credential field, если это поддерживает локальная MCP-настройка. Не размещайте приватные runtime credentials или operator endpoint examples в публичных страницах сайта.

Пример записи клиента

Пути и скрипты зависят от локального Barfinex workspace:

{
  "mcpServers": {
    "barfinex-provider": {
      "command": "npm",
      "args": ["run", "start:mcp:provider:dev"],
      "cwd": "/path/to/trading.apps"
    }
  }
}

Ограничения

Как MCP-инструменты доступны только документированные авторизованные REST-операции.
События WebSocket не являются MCP-инструментами.
Если Provider недоступен при старте, обновите OpenAPI-инструменты после запуска Provider.
Публичный сайт использует только санитизированные read-only проекции market intelligence; MCP остается авторизованной operator/developer интеграцией.

REST-поверхность описана в Provider API. Обзор платформы - в архитектуре Barfinex.