Перейти к основному содержимому

Встроенный MCP-сервер

MCP-сервер в OInt CLI — это встроенная реализация Model Context Protocol поверх стандартных потоков ввода-вывода (stdio), которую можно использовать для организации прямой работы ИИ-агента с различными возможностями Открытого пакета интеграций

Доступные инструменты​

ИнструментНазначение
get_servicesСписок доступных сервисов (команд CLI), соответствующих библиотекам OInt
get_service_methodsСписок методов выбранного сервиса
get_method_parametersОписание параметров метода (типы, значения по умолчанию, подсказки)
execute_methodВыполнение метода с набором именованных параметров
get_variablesПолучение списка переменных, установленных в файле конфигурации (см. ниже)

Запуск сервера​

MCP сервер запускается при помощи команды oint mcp start с одним или несколькими параметрами

  • --config (-c) - путь к JSON-файлу конфигурации или default для использования стандартной конфигурации
  • --log (-l) - путь к файлу для записи лога, если необходимо

Примеры команд запуска:

oint mcp start --config default
oint mcp start -c /home/user/oint-mcp.json -l /tmp/oint-mcp.log

Шаблон для создания своей конфигурации (параметр --config) можно получить отдельной командой oint mcp config

oint mcp config --empty true

При вызове команды с параметром --empty true возвращается пустой JSON-шаблон, а при --empty false - добавляются поясняющие примеры полей. Сохранить файл шаблона можно при помощи добавления к строке команды стандартного параметра --out <путь к файлу> или используя перенаправление оболочки

Файл конфигурации​

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

Пример файла oint-mcp.json:

oint-mcp.json
{
  "vars": {
    "TelegramToken": "123456:ABC-DEF...",
    "BitrixWebhook": "https://example.bitrix24.ru/rest/1/xxxxx/"
  }
}

Запуск сервера с указанием файла конфигурации:

oint mcp start -c /home/user/oint-mcp.json

В процессе работы агент может вызвать инструмент get_variables для получения списка ключей (имен) установленных переменных (без получения реальных значений). Все они будут начинаться с символов @@ и могут быть установлены агентом в качестве значений переменных функций OInt. MCP сервер при получении такого значения интерпретирует его как ключ переменной и заменит на реальное значение из файла конфигурации. Таким образом секретные данные могут использоваться агентом без передачи их ему в открытом виде

Подключение сервера в ИИ-агентах​

Ниже приведены примеры добавления MCP-сервера OInt в различные IDE

В Cursor MCP задается в пользовательском или проектном конфиге (например, через настройки MCP в интерфейсе или файл в каталоге .cursor)

{
  "mcpServers": {
    "oint-mcp": {
      "command": "oint",
      "args": ["mcp", "start", "-c", "default"]
    }
  }
}

Для файла конфигурации с секретами укажите абсолютный путь вместо default:

{
  "mcpServers": {
    "oint-mcp": {
      "command": "oint",
      "args": ["mcp", "start", "-c", "C:\\Users\\user\\oint-mcp.json", "-l", "C:\\Temp\\oint-mcp.log"]
    }
  }
}

Актуальный формат и расположение файла см. в документации Cursor по MCP.

Диагностика​

Если клиент не видит инструменты или падает при старте, необходимо провести диагностику в терминале (командной строке):

  1. Проверить, выполняется ли oint mcp start -c default без ошибок (процесс должен ожидать ввод, не выводя сообщения в консоль)
  2. Проверить корректность JSON в файле конфигурации при использовании -c с пользовательской конфигурацией
  3. Использовать логирование (параметр -l) и проанализировать данные в журнал после запуска